POST https://api.usecommune.comdelivery.bounced Production. There is no separate sandbox host.

Delivery bounced

The message could not be delivered, as reported by the sending provider.

This can have a side effect on the subscriber: they are moved to bounced so later sends skip them, which also emits subscriber.unsubscribed with reason: bounced. A permanent (hard) bounce does that at once, and also stops the address on every other newsletter on Commune. A transient (soft) bounce, such as a full inbox, does it only on the third one in a row to that address, from any newsletter on Commune, with no delivery to it in between; then the same as a hard bounce. Until then the subscriber stays subscribed and this event arrives alone.

Two kinds of email reach this topic. data.source is article_send for an article the creator sent to the list and automation for one send_email step of an automation run. It decides which pair of ids is filled in; the other pair is null. This is a breaking change from the shape that only ever carried an article, described on the body schema.

Delivered as a single HTTPS POST to the consumer's registered endpoint, with the message as the JSON request body. Respond 2xx to acknowledge. Anything else, or a timeout, is retried with backoff, so acknowledge fast and do the work afterwards.

Request Headers

  • string Required
  • string(uuid) Required
  • string Required
  • string Required
  • string(date-time) Required
  • integer

Body

The message could not be delivered.

  • string(uuid) Required
  • string Required
  • string Required
  • string(date-time) Required
  • string(uuid) | null Required
  • string | null Required
POST delivery.bounced
Loading...

Share your request

Use this link to easily share a pre-filled request of this operation. Everything you filled will be shared apart from the authentication fields.

Request URL

https://api-reference.usecommune.dev/explorer/operation/operation-ondeliverybounced

Send a delete request

It looks like you’re about to send a DELETE request to this API. This type of request carries a risk of permanent and irreversible data loss.

Are you sure you want to continue?
Response
Waiting for a request to be sent.