Create a new conversation service on your account

POST /v1/Services

A Service resource is a top-level conversation resource container that serves as a data silo.

Body

FriendlyName string Required

The human-readable name of this service, limited to 256 characters. Optional.

Responses

201

Created
Hide response attributes Show response attributes object
- account_sid string | null
  
  The unique ID of the Account responsible for this service.
  
  Minimum length is 34, maximum length is 34. Format should match the following pattern: ^AC[0-9a-fA-F]{32}$.
- date_created string(date-time) | null
  
  The date that this resource was created.
- date_updated string(date-time) | null
  
  The date that this resource was last updated.
- friendly_name string | null
  
  The human-readable name of this service.
- links object(uri-map) | null
  
  Absolute URLs to access the conversations, users, roles, bindings and configuration of this service.
- sid string | null
  
  A 34 character string that uniquely identifies this resource.
  
  Minimum length is 34, maximum length is 34. Format should match the following pattern: ^IS[0-9a-fA-F]{32}$.
- url string(uri) | null
  
  An absolute URL for this service.

POST /v1/Services

curl \
 -X POST https://conversations.twilio.com/v1/Services \
 --user "username:password" \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -d 'FriendlyName=string'

Request example

{
  "FriendlyName": "string"
}

Request examples

{
  "FriendlyName": "string"
}

Response examples (201)

{
  "account_sid": "string",
  "date_created": "2023-05-04T09:42:00+00:00",
  "date_updated": "2023-05-04T09:42:00+00:00",
  "friendly_name": "string",
  "links": {},
  "sid": "string",
  "url": "https://example.com"
}

Response examples (201)

{
  "account_sid": "string",
  "date_created": "2024-05-04T09:42:00+00:00",
  "date_updated": "2024-05-04T09:42:00+00:00",
  "friendly_name": "string",
  "links": {},
  "sid": "string",
  "url": "https://example.com"
}