---
updatedAt: 2026-09-02T17:06:05.000Z
agentTools:
  projectIndex: https://marketing.developer.dotdigital.com/llms.txt
---

# Message send response

The response from the API changes depending on whether you send a single message or a batch of messages. Please refer to the appropriate section below:

## Single Submission Response Details

### Successful Submission Response

Upon a successful send to the Omnichannel API you will receive a HTTP 201 and a JSON body in the following format:

<Table align={["left","left","left"]}>
  <thead>
    <tr>
      <th>
        Property
      </th>

      <th>
        Type
      </th>

      <th>
        Description
      </th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>
        **messageId**
      </td>

      <td>
        string
      </td>

      <td>
        A unique ID for this message
      </td>
    </tr>

    <tr>
      <td>
        **sentOn**
      </td>

      <td>
        string
      </td>

      <td>
        Date/Time (in UTC, <a href="https://en.wikipedia.org/wiki/ISO_8601" target="_blank">ISO 8601 format</a>) that the message sent was accepted.
      </td>
    </tr>

    <tr>
      <td>
        **status**
      </td>

      <td>
        string
      </td>

      <td>
        One of:

        - processing
        - failed
        - sent
      </td>
    </tr>

    <tr>
      <td>
        **statusDetails**
      </td>

      <td>
        object
      </td>

      <td>
        Specific details related to the current status.
      </td>
    </tr>

    <tr>
      <td>
        **\_createdOn**
      </td>

      <td>
        string
      </td>

      <td>
        Date/Time (in UTC, <a href="https://en.wikipedia.org/wiki/ISO_8601" target="_blank">ISO 8601 format</a>) that the message  was created.
      </td>
    </tr>

    <tr>
      <td>
        **\_createdBy**
      </td>

      <td>
        string
      </td>

      <td>
        The profile ID that created the message.
      </td>
    </tr>

    <tr>
      <td>
        **\_updatedOn**
      </td>

      <td>
        string
      </td>

      <td>
        Date/Time (in UTC, <a href="https://en.wikipedia.org/wiki/ISO_8601" target="_blank">ISO 8601 format</a>) that the message  was last updated.
      </td>
    </tr>

    <tr>
      <td>
        **\_updatedBy**
      </td>

      <td>
        string
      </td>

      <td>
        The profile ID that last updated the message.
      </td>
    </tr>
  </tbody>
</Table>

```json Example response JSON
{
  "_createdOn": "2017-03-17T14:22:40.633Z",
  "_updatedOn": "2017-03-17T14:22:40.633Z",
  "_createdBy": "access:3dd1558a-9db3-406a-8460-cbe5100a7628",
  "_updatedBy": "access:3dd1558a-9db3-406a-8460-cbe5100a7628",
  "to": {
    "phoneNumber": "447123123123"
  },
  "senderProfileId": "M0rsy",
  "body": "Your message",
  "rules": [
    "sms"
  ],
  "sentOn": "2017-03-17T14:22:40.627Z",
  "channelOptions": {
    "sms": {
      "from": "dotdigital",
      "allowUnicode": false
    }
  },
  "status": "processing",
  "statusDetails": {
    "channelId": "sms"
  },
  "messageId": "d8e296bb-97c4-4495-b98f-1e32e0b11628"
}
```

### Failed Submission

If there are issues with the submitted request a **HTTP 400** is returned with the body describing the validation errors.

> 📘 Getting the final status for a message
>
> Once submitted, we process your message and try to deliver it down one of the channels specified. It is still possible the message can fail at this stage if no channels accept the message. To find the final status of a message you can query it using the [Get Status](getting-message-statuses) method, or register a [Webhook](https://marketing.developer.dotdigital.com/reference/webhooks) to have data pushed to your systems.

> 👍 Full API Specification
>
> Please see the [full API specification](https://marketing.developer.dotdigital.com/reference/post_cpaas-messages) for further details about sending messages with the Omnichannel API.

## Batch Submission Response Details

### Successful Submission Response

Once you successfully send to the Omnichannel API, you then receive a **HTTP 202** and a JSON body. The JSON is an array of objects in the following format, one for each message submitted in the batch:

| Property      | Type   | Description                                                                                                                                       |
| :------------ | :----- | :------------------------------------------------------------------------------------------------------------------------------------------------ |
| **index**     | int    | The index of the message send request in the original batch submission this response is for.                                                      |
| **messageId** | string | The unique identifier for the message. This id can be used to request status details and correlate inbounds and receipts to the original message. |

> 🚧 What happens after sending a batch of messages
>
> The messages are processed as fast as possible after submission, but it may take a few seconds before this process is finished, and the message is available for status updates. You can get updates on your messages statuses asynchronously using our webhooks system.

```json Example batch response
[
  {
    "index": 0,
    "messageId": "58bde0da-b380-4cb2-8dd1-ca74fc7a0cda"
  },
  {
    "index": 1,
    "messageId": "0aee96a8-09c9-4192-bf6d-c5f20a323956"
  }
]
```

### Failed Submission

If there are issues with the submitted request a **HTTP 400** is returned with the body describing the validation errors.

> 👍 Full API specification
>
> Please see the [full API specification](https://marketing.developer.dotdigital.com/reference/post_cpaas-messages-batch) for further details about sending messages with the Omnichannel API.

<br />

# Sibling pages

* [Calling the Omnichannel API](https://marketing.developer.dotdigital.com/reference/calling-the-omnichannel-api.md)
* [Addressing your messages](https://marketing.developer.dotdigital.com/reference/addressing-your-messages.md)
* [Channel selection](https://marketing.developer.dotdigital.com/reference/channel-selection.md)
* [Cross channel messaging](https://marketing.developer.dotdigital.com/reference/cross-channel-messaging.md)
* [Custom messages](https://marketing.developer.dotdigital.com/reference/custom-messages.md)
* [Multi part messages](https://marketing.developer.dotdigital.com/reference/multi-part-messages.md)
* [Templates](https://marketing.developer.dotdigital.com/reference/templates.md)
* [Additional options](https://marketing.developer.dotdigital.com/reference/additional-options.md)
* [Inbound messages and receipts](https://marketing.developer.dotdigital.com/reference/inbound-messages-and-receipts.md)