Create a new MessagingConfiguration for a service

POST /v2/Services/{ServiceSid}/MessagingConfigurations

TODO: Resource-level docs

Create a new MessagingConfiguration for a service.

Path parameters

  • ServiceSid string Required

    The SID of the Service that the resource is associated with.

Body

  • Country string Required

    The ISO-3166-1 country code of the country this configuration will be applied to. If this is a global configuration, Country will take the value all.

  • MessagingServiceSid string Required

    The SID of the Messaging Service to be used to send SMS to the country of this configuration.

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

Responses

  • 201

    Created

    Hide response attributes Show response attributes object
    • account_sid string | null

      The SID of the Account that created the resource

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

    • country string | null

      The ISO-3166-1 country code of the country or all.

    • date_created string(date-time) | null

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

    • date_updated string(date-time) | null

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

    • messaging_service_sid string | null

      The SID of the Messaging Service used for this configuration.

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

    • service_sid string | null

      The SID of the Service that the resource is associated with

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

    • url string(uri) | null

      The URL of this resource.
POST /v2/Services/{ServiceSid}/MessagingConfigurations 
curl \
 -X POST https://verify.twilio.com/v2/Services/{ServiceSid}/MessagingConfigurations \
 --user "username:password" \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -d 'Country=string&MessagingServiceSid=string'
Request example 
{
  "Country": "string",
  "MessagingServiceSid": "string"
}
Request examples 
{
  "Country": "string",
  "MessagingServiceSid": "string"
}
Response examples (201) 
{
  "account_sid": "string",
  "country": "string",
  "date_created": "2023-05-04T09:42:00+00:00",
  "date_updated": "2023-05-04T09:42:00+00:00",
  "messaging_service_sid": "string",
  "service_sid": "string",
  "url": "https://example.com"
}
Response examples (201) 
{
  "account_sid": "string",
  "country": "string",
  "date_created": "2025-05-04T09:42:00Z",
  "date_updated": "2025-05-04T09:42:00Z",
  "messaging_service_sid": "string",
  "service_sid": "string",
  "url": "https://example.com"
}