Skip to main content
WEBHOOK

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

webhook-id
string
required

Unique message ID. Use to deduplicate deliveries.

webhook-timestamp
string
required

Unix timestamp of when the message was sent.

webhook-signature
string
required

HMAC signature for verifying the request. Verify using your endpoint signing secret from the Loops dashboard.

Body

application/json
eventName
string
required
Allowed value: "email.hardBounced"
eventTime
integer
required

Unix timestamp in seconds.

webhookSchemaVersion
string
required
Allowed value: "1.0.0"
contactIdentity
object
required
email
object
required
sourceType
enum<string>
required

The type of email this event relates to. Workflow emails use loop.

Available options:
loop,
campaign,
transactional
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.

Response

200

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

Last modified on July 30, 2026