---
title: "A message bounced"
method: POST
path: "bounced"
tags: ["Message events"]
---

# A message bounced

`POST bounced` (webhook)

The receiver refused the message for good, or Sendora gave up; the recipient is suppressed when `hard`.

## Headers

- `Sendora-Signature` string, required
- `Sendora-Event` string, required
- `Sendora-Delivery-Id` string, required
- `User-Agent` string, required

## Payload

- object: The receiver refused the message for good, or Sendora gave up; the recipient is suppressed when `hard`.
  - `id` string, required: The delivery's id. A delivery may arrive more than once, so key your handling on it.
  - `attempt` integer, required: The attempt number, from 1.
  - `messageId` string, required: The message the event is about.
  - `recipient` string, required: The recipient the event is about.
  - `occurredAt` string, date-time, required: When it happened.
  - `serverId` string, required: The server the message was sent from.
  - `streamId` string, required: The stream the message went on.
  - `broadcastId` string, nullable, required: The broadcast the message belongs to; null for a message sent on its own.
  - `tag` string, nullable, required: The tag you sent with the message.
  - `metadata` object, required: The metadata you sent with the message.
  - `test` boolean, required: True for a test server's message: the event was simulated and nothing was sent.
  - `event` 'bounced', required
  - `details` object, required
    - `code` integer, nullable, required: The SMTP status code the receiver answered; null when it gave none.
    - `response` string, nullable, required: The receiver's response text.
    - `classification` string, nullable, required: How the bounce was classified, such as InvalidRecipient.
    - `hard` boolean, required: True when the address is now on the suppression list.
    - `expired` boolean, required: True when the message expired after repeated deferrals rather than being refused.

## Acknowledgement `2XX`

Acknowledges the delivery. Any other answer, or none within 10 seconds, is retried.

---

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