Create service

POST /v2/Services

Account sid auth token

application/x-www-form-urlencoded

Body

FriendlyName string Required

Responses

201 application/json

Created
Hide headers attributes Show headers attributes
- Access-Control-Allow-Origin string
  
  Specify the origin(s) allowed to access the resource
- Access-Control-Allow-Methods string
  
  Specify the HTTP methods allowed when accessing the resource
- Access-Control-Allow-Headers string
  
  Specify the headers allowed when accessing the resource
- Access-Control-Allow-Credentials boolean
  
  Indicates whether the browser should include credentials
- Access-Control-Expose-Headers string
  
  Headers exposed to the client
Hide response attributes Show response attributes object
- sid string | null
  
  Minimum length is 34, maximum length is 34. Format should match the following pattern: ^IS[0-9a-fA-F]{32}$.
- account_sid string | null
  
  Minimum length is 34, maximum length is 34. Format should match the following pattern: ^AC[0-9a-fA-F]{32}$.
- friendly_name string | null
- date_created string(date-time) | null
- date_updated string(date-time) | null
- default_service_role_sid string | null
  
  Minimum length is 34, maximum length is 34. Format should match the following pattern: ^RL[0-9a-fA-F]{32}$.
- default_channel_role_sid string | null
  
  Minimum length is 34, maximum length is 34. Format should match the following pattern: ^RL[0-9a-fA-F]{32}$.
- default_channel_creator_role_sid string | null
  
  Minimum length is 34, maximum length is 34. Format should match the following pattern: ^RL[0-9a-fA-F]{32}$.
- read_status_enabled boolean | null
- reachability_enabled boolean | null
- typing_indicator_timeout integer
  
  Default value is 0.
- consumption_report_interval integer
  
  Default value is 0.
- limits
- pre_webhook_url string | null
- post_webhook_url string | null
- webhook_method string | null
- webhook_filters array[string] | null
- pre_webhook_retry_count integer
  
  Default value is 0.
- post_webhook_retry_count integer
  
  Default value is 0.
- notifications
- media
- url string(uri) | null
- links object(uri-map) | null

POST /v2/Services

curl \
 --request POST 'https://ip-messaging.twilio.com/v2/Services' \
 --user "username:password" \
 --header "Content-Type: application/x-www-form-urlencoded" \
 --data 'FriendlyName=friendly_name'

Request example

{"FriendlyName"=>"friendly_name"}

Response examples (201)

{
  "sid": "ISaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "url": "https://ip-messaging.twilio.com/v2/Services/ISaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "links": {
    "roles": "https://ip-messaging.twilio.com/v2/Services/ISaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Roles",
    "users": "https://ip-messaging.twilio.com/v2/Services/ISaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Users",
    "bindings": "https://ip-messaging.twilio.com/v2/Services/ISaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Bindings",
    "channels": "https://ip-messaging.twilio.com/v2/Services/ISaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Channels"
  },
  "media": {
    "size_limit_mb": 150,
    "compatibility_message": "media compatibility message"
  },
  "limits": {
    "user_channels": 250,
    "channel_members": 100
  },
  "account_sid": "ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "date_created": "2015-07-30T20:00:00Z",
  "date_updated": "2015-07-30T20:00:00Z",
  "friendly_name": "friendly_name",
  "notifications": {},
  "webhook_method": "webhook_method",
  "pre_webhook_url": "pre_webhook_url",
  "webhook_filters": [
    "webhook_filters"
  ],
  "post_webhook_url": "post_webhook_url",
  "read_status_enabled": false,
  "reachability_enabled": false,
  "pre_webhook_retry_count": 2,
  "default_channel_role_sid": "RLaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "default_service_role_sid": "RLaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "post_webhook_retry_count": 3,
  "typing_indicator_timeout": 100,
  "consumption_report_interval": 100,
  "default_channel_creator_role_sid": "RLaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
}