Sign in

v50

latestOpenAPI 3.0.1Apache 2.0raw.githubusercontent.com2026-03-105840481.8 KB
MessagingV1Service

post/v1/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.

inbound_request_urlstring uri nullable

The URL we call using inbound_method when a message is received by any phone number or short code in the Service. When this property is null, receiving inbound messages is disabled. All messages sent to the Twilio phone number or short code will not be logged and received on the Account. If the use_inbound_webhook_on_number field is enabled then the webhook url defined on the phone number will override the inbound_request_url defined for the Messaging Service.

inbound_method'GET' | 'POST' http-method nullable

The HTTP method we use to call inbound_request_url. Can be GET or POST.

fallback_urlstring uri nullable

The URL that we call using fallback_method if an error occurs while retrieving or executing the TwiML from the Inbound Request URL. If the use_inbound_webhook_on_number field is enabled then the webhook url defined on the phone number will override the fallback_url defined for the Messaging Service.

fallback_method'GET' | 'POST' http-method nullable

The HTTP method we use to call fallback_url. Can be: GET or POST.

status_callbackstring uri nullable

The URL we call to pass status updates about message delivery.

sticky_senderboolean nullable

Whether to enable Sticky Sender on the Service instance.

mms_converterboolean nullable

Whether to enable the MMS Converter for messages sent through the Service instance.

smart_encodingboolean nullable

Whether to enable Smart Encoding for messages sent through the Service instance.

scan_message_content'inherit' | 'enable' | 'disable'

Reserved.

fallback_to_long_codeboolean nullable

[OBSOLETE] Former feature used to fallback to long code sender after certain short code message failures.

area_code_geomatchboolean nullable

Whether to enable Area Code Geomatch on the Service Instance.

synchronous_validationboolean nullable

Reserved.

validity_periodinteger

How long, in seconds, messages sent from the Service are valid. Can be an integer from 1 to 36,000. Default value is 36,000.

urlstring uri nullable

The absolute URL of the Service resource.

linksobject nullable

The absolute URLs of related resources.

usecasestring nullable

A string that describes the scenario in which the Messaging Service will be used. Possible values are notifications, marketing, verification, discussion, poll, undeclared.

us_app_to_person_registeredboolean nullable

Whether US A2P campaign is registered for this Service.

use_inbound_webhook_on_numberboolean nullable

A boolean value that indicates either the webhook url configured on the phone number will be used or inbound_request_url/fallback_url url will be called when a message is received from the phone number. If this field is enabled then the webhook url defined on the phone number will override the inbound_request_url/fallback_url defined for the Messaging Service.