Charchy Senddocs

Domain events

`domain.verified` when a sending domain is verified and ready to send from (again, too, once a domain that lost its records has them back); `domain.failed` when its verification fails — the DKIM records weren't found within 72 hours, or setting the domain up failed — or when a verified domain's records are gone at two daily re-checks a few hours apart. Signed like every event.

domain.verified when a sending domain is verified and ready to send from (again, too, once a domain that lost its records has them back); domain.failed when its verification fails — the DKIM records weren't found within 72 hours, or setting the domain up failed — or when a verified domain's records are gone at two daily re-checks a few hours apart. Signed like every event.

webhook-id*string

The event's id (evt_…), the same on every retry. Dedupe by it.

webhook-timestamp*string

Unix seconds when this attempt was signed. Reject if older than 5 minutes.

webhook-signature*string

One or more v1,<base64 HMAC-SHA256 of "id.timestamp.body">, separated by spaces (two during a secret rotation).

application/json
  1. body
id*string

Same as the webhook-id header.

created_at*string

When it happened. Order events by it.

Formatdate-time
test?boolean

Present and true on a sample from Send test event (no real email behind it). Whether a real email used a test key is data.test.

type*string
Value in"domain.verified""domain.failed"
data*

Received.

Example Requests
POST/domain-event
Request Body
application/json
{  "id": "evt_2b7k9x4m1q8w3n5p6r0s2t4v",  "created_at": "2019-08-24T14:15:22Z",  "type": "domain.verified",  "data": {    "domain": "daringaming.com"  }}
Header Parameters
{  "webhook-id": "string",  "webhook-timestamp": "string",  "webhook-signature": "string"}