Sign in

v50

latestOpenAPI 3.0.1Apache 2.0raw.githubusercontent.com2026-02-055427357.6 KB
ChatV2Service

post/v2/Services

Response

Created

sidstring nullable

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

account_sidstring nullable

The SID of the Account that created the Service resource.

friendly_namestring nullable

The string that you assigned to describe the resource.

date_createdstring date-time nullable

The date and time in GMT when the resource was created specified in ISO 8601 format.

date_updatedstring date-time nullable

The date and time in GMT when the resource was last updated specified in ISO 8601 format.

default_service_role_sidstring nullable

The service role assigned to users when they are added to the service. See the Role resource for more info about roles.

default_channel_role_sidstring nullable

The channel role assigned to users when they are added to a channel. See the Role resource for more info about roles.

default_channel_creator_role_sidstring nullable

The channel role assigned to a channel creator when they join a new channel. See the Role resource for more info about roles.

read_status_enabledboolean nullable

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

reachability_enabledboolean nullable

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

typing_indicator_timeoutinteger

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.

consumption_report_intervalinteger

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

{"stackTrail":"components:schemas:chat.v2.service:properties:limits","oasType":"schema","type":"unknown","description":"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.","nullable":true}
pre_webhook_urlstring nullable

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

post_webhook_urlstring nullable

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

webhook_methodstring nullable

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_filtersstring[] nullable

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

pre_webhook_retry_countinteger

The number of times to retry a call to the pre_webhook_url if the request times out (after 5 seconds) or it receives a 429, 503, or 504 HTTP response. Default retry count is 0 times, which means the call won't be retried.

post_webhook_retry_countinteger

The number of times to retry a call to the post_webhook_url if the request times out (after 5 seconds) or it receives a 429, 503, or 504 HTTP response. The default is 0, which means the call won't be retried.

{"stackTrail":"components:schemas:chat.v2.service:properties:notifications","oasType":"schema","type":"unknown","description":"The notification configuration for the Service instance. See [Push Notification Configuration](https://www.twilio.com/docs/chat/push-notification-configuration) for more info.","nullable":true}
{"stackTrail":"components:schemas:chat.v2.service:properties:media","oasType":"schema","type":"unknown","description":"An object that describes the properties of media that the service supports. The object contains the `size_limit_mb` property, which describes the size of the largest media file in MB; and the `compatibility_message` property, which contains the message text to send when a media message does not have any text.","nullable":true}
urlstring uri nullable

The absolute URL of the Service resource.

linksobject nullable

The absolute URLs of the Service's Channels, Roles, Bindings, and Users.