> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.messageblue.ai/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.messageblue.ai/_mcp/server.

# Delivery status update

POST 

Delivered to the `statusWebhookUrl` you set with `POST /settings/webhooks` as an outbound message progresses. A per-message `status_callback`, if you set one when sending, takes precedence over the account-level URL.

This payload has **no `type` field** — identify it by `status`.

Reference: https://docs.messageblue.ai/api-reference/webhooks/message-status

## OpenAPI 3.1 Webhook Specification

```yaml
openapi: 3.1.0
info:
  title: swagger
  version: 1.0.0
paths: {}
webhooks:
  subpackage_webhooks.messageStatus:
    post:
      operationId: subpackage_webhooks.messageStatus
      summary: Delivery status update
      description: >-
        Delivered to the `statusWebhookUrl` you set with `POST
        /settings/webhooks` as an outbound message progresses. A per-message
        `status_callback`, if you set one when sending, takes precedence over
        the account-level URL.


        This payload has **no `type` field** — identify it by `status`.
      responses:
        '200':
          description: Webhook received successfully
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/StatusEvent'
components:
  schemas:
    StatusEvent:
      type: object
      properties:
        messageId:
          type: string
        status:
          type: string
          description: e.g. sent, delivered, read, failed, SMS_FALLBACK.
        text:
          type:
            - string
            - 'null'
        from:
          type:
            - string
            - 'null'
        to:
          type:
            - string
            - 'null'
        groupId:
          type:
            - string
            - 'null'
        attachments:
          type: array
          items:
            type: string
            format: uri
        status_callback:
          type:
            - string
            - 'null'
          format: uri
        outbound:
          type: boolean
        iMessageNumber:
          type:
            - string
            - 'null'
        participants:
          type:
            - array
            - 'null'
          items:
            type: string
        chatGuid:
          type:
            - string
            - 'null'
        messageGuid:
          type:
            - string
            - 'null'
        timestamp_ms:
          type: integer
          format: int64
        error:
          type:
            - string
            - 'null'
      description: >-
        Delivered to your status webhook URL (or a per-message status_callback)
        as an outbound message progresses. Note: this payload has no `type`
        field — identify it by the `status` property.
      title: StatusEvent

```