active.secret is returned only here. Store it; later reads do not include it.Content-Type: application/json, User-Agent: Zapmail-Webhooks/1.0 and an X-Zapmail-Signature header of the form t=<unix seconds>,v1=<hex>. v1 is the HMAC-SHA256, hex encoded, of the string <t>.<raw request body> keyed with the endpoint secret (the whole whsec_... string). Verify against the raw body bytes before parsing it.disabled and the account owner is emailed. Re-enable it with PATCH /webhooks/endpoints/{id}.GET /webhooks/events, POST /webhooks/endpoints/{id}/test.curl --location 'https://api.zapmail.ai/api/v3/webhooks/endpoints' \
--header 'x-auth-zapmail;' \
--header 'Content-Type: application/json' \
--data '{
"url": "https://hooks.acme.com/zapmail",
"enabled_events": [
"mailbox.updated",
"export.completed"
]
}'{
"status": 201,
"message": "Webhook endpoint created",
"data": {
"id": "4c8e1f2a-9b3d-4a7e-8f10-6d2b5c9e7a31",
"url": "https://hooks.acme.com/zapmail",
"enabled_events": [
"mailbox.updated",
"export.completed"
],
"status": "active",
"created_at": "2026-10-26T09:14:03.000Z",
"updated_at": "2026-10-26T09:14:03.000Z",
"secret": "whsec_kT3uQ9xv1Zr8mY2bC7dE4fG6hJ0nP5sA8wL1iO3qU-4"
}
}