Skip to content

Email

View as Markdown

Email delivery events from the platform’s mail provider.

Operation Method and path
Postmark delivery webhook receiver POST /v1/integrations/postmark/webhook
POST /v1/integrations/postmark/webhook

Called by Postmark for Bounce, SpamComplaint, Delivery and SubscriptionChange events. Authenticated by HTTP basic auth (user postmark, password GUV_POSTMARK_WEBHOOK_SECRET); deduplicated by the Postmark record instead of Idempotency-Key. A hard bounce or spam complaint suppresses further mail to the address.

  • Operation: receivePostmarkWebhook
  • Scopes: none (public)

Request body (application/json, required): object

Responses

Status Meaning Body
204 No Content Done. No body. none

Errors: 400, 401, 429, 500, as problem+json with a stable code.

Example

Terminal window
curl -X POST https://api.guv.dev/v1/integrations/postmark/webhook \
-H "Authorization: Bearer $GUV_TOKEN" \
-H "Content-Type: application/json" \
-d '{}'