---
title: "Update a short code with the following parameters"
method: POST
path: "/2010-04-01/Accounts/{AccountSid}/SMS/ShortCodes/{Sid}.json"
tags: ["Api20100401ShortCode"]
---

# Update a short code with the following parameters

`POST /2010-04-01/Accounts/{AccountSid}/SMS/ShortCodes/{Sid}.json`

## Request

- Base URL: `https://api.twilio.com`
- URL: `https://api.twilio.com/2010-04-01/Accounts/{AccountSid}/SMS/ShortCodes/{Sid}.json`
- Auth: HTTP basic

Update a short code with the following parameters

## Path parameters

- `AccountSid` string, required
- `Sid` string, required

## Request body `application/x-www-form-urlencoded`

- object
  - `FriendlyName` string: 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.
  - `ApiVersion` string: The API version to use to start a new TwiML session. Can be: `2010-04-01` or `2008-08-01`.
  - `SmsUrl` string, uri: The URL we should call when receiving an incoming SMS message to this short code.
  - `SmsMethod` 'GET' | 'POST', http-method: The HTTP method we should use when calling the `sms_url`. Can be: `GET` or `POST`.
  - `SmsFallbackUrl` string, uri: The URL that we should call if an error occurs while retrieving or executing the TwiML from `sms_url`.
  - `SmsFallbackMethod` 'GET' | 'POST', http-method: The HTTP method that we should use to call the `sms_fallback_url`. Can be: `GET` or `POST`.

## Response `200`

OK

- ApiV2010AccountShortCode
  - `account_sid` string, nullable: The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created this ShortCode resource.
  - `api_version` string, nullable: The API version used to start a new TwiML session when an SMS message is sent to this short code.
  - `date_created` string, date-time-rfc-2822, nullable: The date and time in GMT that this resource was created specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format.
  - `date_updated` string, date-time-rfc-2822, nullable: 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_name` string, nullable: A string that you assigned to describe this resource. By default, the `FriendlyName` is the short code.
  - `short_code` string, nullable: The short code. e.g., 894546.
  - `sid` string, nullable: The unique string that that we created to identify this ShortCode resource.
  - `sms_fallback_method` 'GET' | 'POST', http-method, nullable: The HTTP method we use to call the `sms_fallback_url`. Can be: `GET` or `POST`.
  - `sms_fallback_url` string, uri, nullable: The URL that we call if an error occurs while retrieving or executing the TwiML from `sms_url`.
  - `sms_method` 'GET' | 'POST', http-method, nullable: The HTTP method we use to call the `sms_url`. Can be: `GET` or `POST`.
  - `sms_url` string, uri, nullable: The URL we call when receiving an incoming SMS message to this short code.
  - `uri` string, nullable: The URI of this resource, relative to `https://api.twilio.com`.

## Changes

- **2024-04-18** (v2010) `cf63f47f41aa`: 8 breaking, 8 info
  - removed the enum value `DELETE` of the request property `SmsFallbackMethod`
  - removed the enum value `DELETE` of the request property `SmsMethod`
  - removed the enum value `HEAD` of the request property `SmsFallbackMethod`
  - removed the enum value `HEAD` of the request property `SmsMethod`
  - …12 more

[Operation history](https://skmtc.dev/twilio/apis/api-v2010/changes/2010-04-01/Accounts/:AccountSid/SMS/ShortCodes/:Sid.json/post.md)

---

[API](https://skmtc.dev/twilio/apis/api-v2010.md) - [All operations](https://skmtc.dev/twilio/apis/api-v2010/llms.txt) - [OpenAPI document](https://skmtc.dev/twilio/apis/api-v2010/revisions/bfdf249a1298?raw)