---
schema_version: "1"
id: 176f0ea97714748ebef1a3e461063da1bfd190551c53cf6be5f786061f8d6473
title: POST /sms/v1/queueMO
collection: developer
version: current
locale: en-us
portal_url: https://docs.salesforce.com/developer/current/en-us/marketing-cloud/guides/mc-apis/postQueueMO.md
canonical_url: https://developer.salesforce.com/docs/marketing/marketing-cloud/references/mc_rest_sms/postQueueMO.html
source_site: developer.salesforce.com
content_type: documentation
content_hash: d156279d01e75cef9b3ee3ddd128e062f3b872256bbb211da4e0b0ca8fb58e1c
products:
  - Marketing Cloud Engagement APIs and Programmatic Languages
  - Marketing Cloud
---
# POST /sms/v1/queueMO

## Overview

Queues an MO message for send.

### JSON Parameters

<!--complex table-->

| Name              | Type   |              | Description                                                                                                                                  |
| ----------------- | ------ | ------------ | -------------------------------------------------------------------------------------------------------------------------------------------- |
| **mobileNumbers** | array  | **Required** | An array of mobile numbers used in the send. Either the mobileNumbers or subscribers property is required, but not both.                     |
| **subscribers**   | array  | **Required** | An array of subscriber keys and mobile numbers used in the send. Either the mobileNumbers or subscribers property is required, but not both. |
| **shortCode**     | string | **Required** | The short code                                                                                                                               |
| **messageText**   | string | **Required** | The text value                                                                                                                               |

### Usage

The mobileNumbers value accepts only 250 or fewer normalized phone numbers. The subscribers value accepts only 250 or fewer string values (including 1 to 254 characters). You can use a single subscriberkey value with multiple mobileNumber values, depending on how your account manages contact information. You must provide values for either mobileNumbers or subscribers, but not both. If you populate both arrays, the API defaults to use subscriber information and ignores mobileNumbers information.

The mobileNumbers value must be no fewer than eight and no more than 15 characters. The mobileNumbers value must also use the correct format for the designated country code. For example, a phone number from the United States must include the numeric country code 1 and the applicable area code as displayed in the sample CSV file. Note that the numeric country code mentioned here applies only to the phone number itself, and that any separate field containing country code information must conform to [ISO-3306-1 alpha-2 standards](http://www.iso.org/iso/country_codes/iso-3166-1_decoding_table.md "http://www.iso.org/iso/country_codes/iso-3166-1_decoding_table.htm").

**Example Request** This example shows a call referencing a single mobile number.

```js
Host: https://YOUR_SUBDOMAIN.rest.marketingcloudapis.com
POST /sms/v1/queueMO/
Content-Type: application/json
Authorization: Bearer YOUR_ACCESS_TOKEN

{
  "mobileNumbers" : [
  "15555551212"
  ],
  "shortCode" : "86288",
  "messageText" : "CODETEST"
}
```

**Example Response**

```js
HTTP/1.1 202 Accepted
{
    "results": [{
        "identifier": "UnNxWDUwbGFMVTJjWnB4R0x1Qng4dzo3Njow",
        "mobileNumber": "15555551212",
        "result": "OK"
    }]
}
```

**Example Request**\
This example shows a call referencing an array of subscriber key values.

```js
Host: https://YOUR_SUBDOMAIN.rest.marketingcloudapis.com
POST /sms/v1/queueMO/
Content-Type: application/json
Authorization: Bearer YOUR_ACCESS_TOKEN

{
   "subscribers":[
     {
       "mobilenumber": "15555551212",
       "subscriberkey": "0_MC1652"
     },
     {
       "mobilenumber": "15555551213",
       "subscriberkey": "0_MC1652"
     }
   ],
   "shortCode" : "86288",
   "messageText" : "CODETEST"
}
```

**Example Response**

```js
HTTP/1.1 202 Accepted
{
     "results": [{
         "identifier": "UnNxWDUwbGFMVTJjWnB4R0x1Qng4dzo3Njow",
         "subscribers":["
           {
             "mobilenumber": "15555551212",
             "subscriberkey": "0_MC1652"
           },
           {
             "mobilenumber": "15555551213",
             "subscriberkey": "0_MC1652"
           }
         "],
         "result": "OK"
     }]
}
```

Including values for both mobileNumbers and subscribers returns the following error.

```js
{
   "errors": [
     "An array of mobile numbers and an array of subscribers cannot be provided at the same time"
   ]
}
```