# Create a new User Defined Message for the given Call SID.

**POST /2010-04-01/Accounts/{AccountSid}/Calls/{CallSid}/UserDefinedMessages.json**

Create a new User Defined Message for the given Call SID.
Allows your server-side application to send messages to the Voice SDK end user during an active Call.

## Servers
- https://api.twilio.com: https://api.twilio.com ()


## Authentication methods
- Account sid auth token


## Parameters

### Path parameters
- **AccountSid** (string)
  The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created User Defined Message.
- **CallSid** (string)
  The SID of the [Call](https://www.twilio.com/docs/voice/api/call-resource) the User Defined Message is associated with.


### Body: application/x-www-form-urlencoded (object)

- **Content** (string)
  The User Defined Message in the form of URL-encoded JSON string.
- **IdempotencyKey** (string)
  A unique string value to identify API call. This should be a unique string value per API call and can be a randomly generated.


## Responses
### 201
Created
#### Headers
- **Access-Control-Allow-Origin** (string)
  Specify the origin(s) allowed to access the resource
- **Access-Control-Allow-Methods** (string)
  Specify the HTTP methods allowed when accessing the resource
- **Access-Control-Allow-Headers** (string)
  Specify the headers allowed when accessing the resource
- **Access-Control-Allow-Credentials** (boolean)
  Indicates whether the browser should include credentials
- **Access-Control-Expose-Headers** (string)
  Headers exposed to the client

#### Body: application/json (object)
- **account_sid** (string | null)
  The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created User Defined Message.
- **call_sid** (string | null)
  The SID of the [Call](https://www.twilio.com/docs/voice/api/call-resource) the User Defined Message is associated with.
- **sid** (string | null)
  The SID that uniquely identifies this User Defined Message.
- **date_created** (string(date-time-rfc-2822) | null)
  The date that this User Defined Message was created, given in RFC 2822 format.


[Powered by Bump.sh](https://bump.sh)