Create service

POST /v1/Services

Top level scope for all chat resources

application/x-www-form-urlencoded

Body

  • FriendlyName string Required

    A descriptive string that you create to describe the resource. It can be up to 64 characters long.

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

      The unique string that we created to identify the Service resource.

      Minimum length is 34, maximum length is 34. Format should match the following pattern: ^IS[0-9a-fA-F]{32}$.

    • account_sid string | null

      The SID of the Account that created the Service resource.

      Minimum length is 34, maximum length is 34. Format should match the following pattern: ^AC[0-9a-fA-F]{32}$.

    • friendly_name string | null

      The string that you assigned to describe the resource.

    • date_created string(date-time) | null

      The date and time in GMT when the resource was created specified in RFC 2822 format.

    • date_updated string(date-time) | null

      The date and time in GMT when the resource was last updated specified in RFC 2822 format.

    • default_service_role_sid string | null

      The service role assigned to users when they are added to the service. See the Roles endpoint for more details.

      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

      The channel role assigned to users when they are added to a channel. See the Roles endpoint for more details.

      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

      The channel role assigned to a channel creator when they join a new channel. See the Roles endpoint for more details.

      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

      Whether the Message Consumption Horizon feature is enabled. The default is true.

    • reachability_enabled boolean | null

      Whether the Reachability Indicator is enabled for this Service instance. The default is false.

    • typing_indicator_timeout integer

      How long in seconds after a started typing event until clients should assume that user is no longer typing, even if no ended typing message was received. The default is 5 seconds.

      Default value is 0.

    • consumption_report_interval integer

      DEPRECATED. The interval in seconds between consumption reports submission batches from client endpoints.

      Default value is 0.

    • limits

      An object that describes the limits of the service instance. The limits object contains channel_members to describe the members/channel limit and user_channels to describe the channels/user limit. channel_members can be 1,000 or less, with a default of 250. user_channels can be 1,000 or less, with a default value of 100.

    • webhooks

      An object that contains information about the webhooks configured for this service.

    • pre_webhook_url string | null

      The URL for pre-event webhooks, which are called by using the webhook_method. See Webhook Events for more details.

    • post_webhook_url string | null

      The URL for post-event webhooks, which are called by using the webhook_method. See Webhook Events for more details.

    • webhook_method string | null

      The HTTP method to use for calls to the pre_webhook_url and post_webhook_url webhooks. Can be: POST or GET and the default is POST. See Webhook Events for more details.

    • webhook_filters array[string] | null

      The list of WebHook events that are enabled for this Service instance. See Webhook Events for more details.

    • notifications

      The notification configuration for the Service instance. See Push Notification Configuration for more information.

    • url string(uri) | null

      The absolute URL of the Service resource.

POST /v1/Services
curl \
 --request POST 'https://chat.twilio.com/v1/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://chat.twilio.com/v1/Services/ISaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "links": {
    "roles": "https://chat.twilio.com/v1/Services/ISaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Roles",
    "users": "https://chat.twilio.com/v1/Services/ISaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Users",
    "channels": "https://chat.twilio.com/v1/Services/ISaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Channels"
  },
  "limits": {
    "user_channels": 250,
    "channel_members": 100
  },
  "webhooks": {},
  "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,
  "default_channel_role_sid": "RLaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "default_service_role_sid": "RLaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "typing_indicator_timeout": 100,
  "consumption_report_interval": 100,
  "default_channel_creator_role_sid": "RLaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
}