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: "contact.mailingList.subscribed"
eventTime
integer
required

Unix timestamp in seconds.

webhookSchemaVersion
string
required
Allowed value: "1.0.0"
contactIdentity
object
required
mailingList
object
required

Details of the mailing list.

Response

200

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

Last modified on July 30, 2026