Sample - Twilio API
POST/2010-04-01/Accounts/{AccountSid}/SMS/ShortCodes/{Sid}.json

Update a short code

Updates the configuration of an existing short code. Send any supported form fields you want to change, including its friendly name, API version, messaging URLs, or HTTP methods.

  • RetriesRetries up to 2×, 500ms backoff, 30s timeout.

2 parameters · 6 body fields
AccountSidstringrequired
The account SID that created the short code resource. Must be a 34-character SID beginning with `AC`.
Sidstringrequired
The unique short code SID to update. Must be a 34-character SID beginning with `SC`.

Form-encoded short code settings to update; all fields can be omitted when no corresponding setting needs to change.

FriendlyNamestringoptional
A descriptive string that you created to describe this resource. It can be up to 64 characters long. By default, the `FriendlyName` is the short code.
ApiVersionstringoptional
The API version to use to start a new TwiML session. Can be: `2010-04-01` or `2008-08-01`.
SmsUrlstringoptional
The URL we should call when receiving an incoming SMS message to this short code.
SmsMethodstringoptional
The HTTP method we should use when calling the `sms_url`. Can be: `GET` or `POST`.
Allowed:GETPOST
SmsFallbackUrlstringoptional
The URL that we should call if an error occurs while retrieving or executing the TwiML from `sms_url`.
SmsFallbackMethodstringoptional
The HTTP method that we should use to call the `sms_fallback_url`. Can be: `GET` or `POST`.
Allowed:GETPOST

1 status code
200Returns the updated short code object with its current configuration, metadata, and resource URI.
account_sidstringoptional
The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created this ShortCode resource.
api_versionstringoptional
The API version used to start a new TwiML session when an SMS message is sent to this short code.
date_createdstringoptional
The date and time in GMT that this resource was created specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format.
date_updatedstringoptional
The date and time in GMT that this resource was last updated, specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format.
friendly_namestringoptional
A string that you assigned to describe this resource. By default, the `FriendlyName` is the short code.
short_codestringoptional
The short code. e.g., 894546.
sidstringoptional
The unique string that that we created to identify this ShortCode resource.
sms_fallback_methodstringoptional
The HTTP method we use to call the `sms_fallback_url`. Can be: `GET` or `POST`.
Allowed:GETPOST
sms_fallback_urlstringoptional
The URL that we call if an error occurs while retrieving or executing the TwiML from `sms_url`.
sms_methodstringoptional
The HTTP method we use to call the `sms_url`. Can be: `GET` or `POST`.
Allowed:GETPOST
sms_urlstringoptional
The URL we call when receiving an incoming SMS message to this short code.
uristringoptional
The URI of this resource, relative to `https://api.twilio.com`.

Error handling

AccountSid must be a 34-character account SID beginning with AC, and Sid must be a 34-character short code SID beginning with SC. SmsMethod and SmsFallbackMethod must each be GET or POST, while URL fields must contain valid URIs.