Sign in
MessagingV1Service

post/v1/Services/{Sid}

Path parameters

Sidstring required

The SID of the Service resource to update.

Response

OK

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.

Changes

Changed in 5 of the 102 revisions of this API.8111

  • v19c7bdebb1c4b1See the full diff
    • ○

      the response's property default value 0 was added for the status

      response-property-default-value-added

  • v199116c0327cb1See the full diff
    • ●

      removed the optional property from the response with the status

      response-optional-property-removed

  • v188bdad18669e88See the full diff
    • ▲

      removed the enum value DELETE of the request property

      request-property-enum-value-removed

    • ▲

      removed the enum value DELETE of the request property

      request-property-enum-value-removed

    • ▲

      removed the enum value HEAD of the request property

      request-property-enum-value-removed

    • ▲

      removed the enum value HEAD of the request property

      request-property-enum-value-removed

    • ▲

      removed the enum value PATCH of the request property

      request-property-enum-value-removed

    • ▲

      removed the enum value PATCH of the request property

      request-property-enum-value-removed

    • ▲

      removed the enum value PUT of the request property

      request-property-enum-value-removed

    • ▲

      removed the enum value PUT of the request property

      request-property-enum-value-removed

    • ○

      removed the DELETE enum value from the response property for the response status

      response-property-enum-value-removed

    • ○

      removed the DELETE enum value from the response property for the response status

      response-property-enum-value-removed

    • ○

      removed the HEAD enum value from the response property for the response status

      response-property-enum-value-removed

    • ○

      removed the HEAD enum value from the response property for the response status

      response-property-enum-value-removed

    • ○

      removed the PATCH enum value from the response property for the response status

      response-property-enum-value-removed

    • ○

      removed the PATCH enum value from the response property for the response status

      response-property-enum-value-removed

    • ○

      removed the PUT enum value from the response property for the response status

      response-property-enum-value-removed

    • ○

      removed the PUT enum value from the response property for the response status

      response-property-enum-value-removed

  • v155d8cb83916f1See the full diff
    • ○

      added the optional property to the response with the status

      response-optional-property-added

  • v18faf729647351See the full diff
    • ○

      api tag MessagingV1Service added

      api-tag-added