> 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.

# Inbound message received

POST 

Delivered to the `inboundWebhookUrl` you set with `POST /settings/webhooks` when a contact sends a message to one of your agents. Verify `X-MB-Signature` against the raw request bytes before trusting the payload.

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

## OpenAPI 3.1 Webhook Specification

```yaml
openapi: 3.1.0
info:
  title: swagger
  version: 1.0.0
paths: {}
webhooks:
  subpackage_webhooks.inboundMessage:
    post:
      operationId: subpackage_webhooks.inboundMessage
      summary: Inbound message received
      description: >-
        Delivered to the `inboundWebhookUrl` you set with `POST
        /settings/webhooks` when a contact sends a message to one of your
        agents. Verify `X-MB-Signature` against the raw request bytes before
        trusting the payload.
      responses:
        '200':
          description: Webhook received successfully
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/InboundMessageEvent'
components:
  schemas:
    InboundMessageEventType:
      type: string
      enum:
        - inbound_message
      title: InboundMessageEventType
    InboundMessageEvent:
      type: object
      properties:
        type:
          $ref: '#/components/schemas/InboundMessageEventType'
        messageId:
          type: string
        text:
          type:
            - string
            - 'null'
        from:
          type:
            - string
            - 'null'
          description: Sender handle (E.164 phone or email), canonicalized.
        to:
          type:
            - string
            - 'null'
        outbound:
          type: boolean
        iMessageNumber:
          type:
            - string
            - 'null'
          description: The agent number that received it.
        participants:
          type:
            - array
            - 'null'
          items:
            type: string
        chatGuid:
          type:
            - string
            - 'null'
        groupId:
          type:
            - string
            - 'null'
        messageGuid:
          type:
            - string
            - 'null'
        attachments:
          type: array
          items:
            type: string
            format: uri
        timestamp_ms:
          type: integer
          format: int64
        accountId:
          type:
            - string
            - 'null'
      description: >-
        Delivered to your inbound webhook URL when a contact sends a message to
        one of your agents.
      title: InboundMessageEvent

```