---
title: "Message bounced"
method: POST
path: "message.bounced"
---

# Message bounced

`POST message.bounced` (webhook)

## Payload

- object
  - `type` 'message.bounced', required
  - `timestamp` string, required
  - `data` object, required
    - `mailboxId` string, nullable
    - `channel` 'sms' | 'whatsapp' | 'email', required
    - `status` string, nullable
    - `metadata` object, nullable
    - `cost` number, nullable
    - `recipient` string, required
    - `occurredAt` string, required
    - `failureReason` string, nullable
    - `errorCode` string, nullable
    - `conversationId` string, nullable
    - `isBillable` boolean, nullable
    - `messageType` string, nullable
    - `templateCategory` 'marketing' | 'utility' | 'authentication', nullable
    - `subject` string, nullable
    - `toEmails` string[], nullable
    - `providerMessageId` string, nullable
    - `waId` string, nullable
    - `hasAttachments` boolean, nullable
    - `isAutoReply` boolean, nullable
    - `segments` number, nullable
    - `to` string, nullable
    - `from` string, nullable
    - `body` string, nullable
    - `direction` 'inbound' | 'outbound', nullable
    - `errorMessage` string, nullable
    - `parts` number, nullable
    - `carrier` string, nullable
    - `messageId` string, required
    - `organizationId` string, required

## Acknowledgement `200`

Any 2xx status acknowledges the event.

---

[API](https://skmtc.dev/samva/apis/samva-api.md) · [All operations](https://skmtc.dev/samva/apis/samva-api/llms.txt) · [OpenAPI document](https://skmtc.dev/samva/apis/samva-api/revisions/a99408542cc3?raw)