Runs examples for real against your account. Test keys only; kept in this tab, never stored on our side. Get a key
ZapSMTP / Docs / Webhooks

Retrieve a webhook

GET/v1/webhooks/{id}

Retrieve a webhook endpoint including its signing secret.

Requires a full-access key.

Path parameters

idstringrequired
Webhook id

Errors

restricted_api_keyHTTP 403
not_foundHTTP 404
webhook not found
GET/v1/webhooks/{id}
curl 'https://zapsmtp.xyz/v1/webhooks/019a1c55-0d6e-7f21-8b3a-5e9d4c7b2a10' \
  -H "Authorization: Bearer $ZAP_API_KEY"
Set ZAP_API_KEY in your environment.
Response 200 OK
{
  "id": "019a1f22-6e7f-7091-8a2b-3c4d5e6f7a8b",
  "url": "https://acme.com/hooks/zapsmtp",
  "secret": "whsec_Q7v2Lk9Xp4Rb1Tz8Mw3Nc6Hy0Fd5Gs2J",
  "previous_secret_expires_at": "2026-10-22T15:45:00Z",
  "events": [
    "email.delivered",
    "email.bounced",
    "email.complained"
  ],
  "enabled": true,
  "disabled_reason": null,
  "created_at": "2026-10-20T12:00:00Z",
  "filter": {
    "actions": []
  }
}