---
title: "Email hard bounced"
method: POST
path: "emailHardBounced"
tags: ["Webhooks"]
---

# Email hard bounced

`POST emailHardBounced` (webhook)

Sent when an email hard bounces. Hard bounces are persistent delivery failures (for example, a mailbox that does not exist); the email will not be delivered. In Loops, a hard bounce also unsubscribes the contact from your audience, so a `contact.unsubscribed` event will also be sent. Contains `sourceType` and the related `campaignId`, `loopId` (workflow ID), or `transactionalId`, plus `contactIdentity` and `email` objects.

## Headers

- `webhook-id` string, required
- `webhook-timestamp` string, required
- `webhook-signature` string, required

## Payload

- WebhookEmailHardBouncedPayload
  - `eventName` 'email.hardBounced', required
  - `eventTime` integer, required — Unix timestamp in seconds.
  - `webhookSchemaVersion` '1.0.0', required
  - `contactIdentity` WebhookContactIdentity, required
    - `id` string, required
    - `email` string, required
    - `userId` string, nullable, required
  - `email` WebhookEmail, required
    - `id` string, required — The ID of the email.
    - `emailMessageId` string, required — The ID of the sent version of the campaign, workflow or transactional email.
    - `subject` string, required — The subject of the email.
  - `sourceType` 'loop' | 'campaign' | 'transactional', required — The type of email this event relates to. Workflow emails use `loop`.
  - `campaignId` string — The ID of the campaign if `sourceType` is `campaign`.
  - `loopId` string — The ID of the workflow if `sourceType` is `loop`.
  - `transactionalId` string — The ID of the transactional email if `sourceType` is `transactional`.

## Acknowledgement `200`

Webhook received successfully. Return any 2xx status code to acknowledge delivery.

---

[API](https://skmtc.net/loops/apis/loops-openapi-spec.md) · [All operations](https://skmtc.net/loops/apis/loops-openapi-spec/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/loops/loops-openapi-spec/revisions/9cc087257f0d/schema)