# Send a Command to a Sim.

**POST /v1/Commands**

Send a Command to a Sim.
Machine-to-machine commands sent to/from devices

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


## Authentication methods
- Account sid auth token


## Parameters



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

- **Command** (string)
  The message body of the Command. Can be plain text in text mode or a Base64 encoded byte string in binary mode.
- **Sim** (string)
  The `sid` or `unique_name` of the [SIM](https://www.twilio.com/docs/iot/wireless/api/sim-resource) to send the Command to.
- **CallbackMethod** (string(http-method))
  The HTTP method we use to call `callback_url`. Can be: `POST` or `GET`, and the default is `POST`.
- **CallbackUrl** (string(uri))
  The URL we call using the `callback_url` when the Command has finished sending, whether the command was delivered or it failed.
- **CommandMode** (string)
  The mode used to send the SMS message. Can be: `text` or `binary`. The default SMS mode is `text`.
- **IncludeSid** (string)
  Whether to include the SID of the command in the message body. Can be: `none`, `start`, or `end`, and the default behavior is `none`. When sending a Command to a SIM in text mode, we can automatically include the SID of the Command in the message body, which could be used to ensure that the device does not process the same Command more than once.  A value of `start` will prepend the message with the Command SID, and `end` will append it to the end, separating the Command SID from the message body with a space. The length of the Command SID is included in the 160 character limit so the SMS body must be 128 characters or less before the Command SID is included.
- **DeliveryReceiptRequested** (boolean)
  Whether to request delivery receipt from the recipient. For Commands that request delivery receipt, the Command state transitions to 'delivered' once the server has received a delivery receipt from the device. The default value is `true`.


## 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)
- **sid** (string | null)
  The unique string that we created to identify the Command resource.
- **account_sid** (string | null)
  The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the Command resource.
- **sim_sid** (string | null)
  The SID of the [Sim resource](https://www.twilio.com/docs/iot/wireless/api/sim-resource) that the Command was sent to or from.
- **command** (string | null)
  The message being sent to or from the SIM. For text mode messages, this can be up to 160 characters. For binary mode messages, this is a series of up to 140 bytes of data encoded using base64.
- **command_mode** (string)
  The mode used to send the SMS message. Can be: `text` or `binary`. The default SMS mode is `text`.
- **transport** (string)
  The type of transport used. Can be: `sms` or `ip`.
- **delivery_receipt_requested** (boolean | null)
  Whether to request a delivery receipt.
- **status** (string)
  The status of the Command. Can be: `queued`, `sent`, `delivered`, `received`, or `failed`. See [Status Values](https://www.twilio.com/docs/iot/wireless/api/command-resource#status-values) for a description of each state.
- **direction** (string)
  The direction of the Command. Can be `to_sim` or `from_sim`. The value of `to_sim` is synonymous with the term `mobile terminated`, and `from_sim` is synonymous with the term `mobile originated`.
- **date_created** (string(date-time) | null)
  The date and time in GMT when the resource was created specified in [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html) format.
- **date_updated** (string(date-time) | null)
  The date and time in GMT when the resource was last updated specified in [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html) format.
- **url** (string(uri) | null)
  The absolute URL of the resource.


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