Skip to main content

Receive a provider delivery receipt.

POST 
/v1/webhooks/:provider

Point each provider's webhook setting at https://api.nervly.io/v1/webhooks/{provider} and Nerve normalises their receipts into delivery telemetry.

Authentication is by signature, not API key. This route is outside the bearer-token surface because providers cannot present your key. Supported providers and their signature schemes:

  • resend: Svix HMAC-SHA256 signatures via headers svix-id, svix-timestamp, svix-signature.
  • zeptomail: Producer signature via header producer-signature: ts=...;s=...;s-algorithm=HmacSHA256.
  • termii: X-Termii-Signature (HMAC-SHA256 of the raw body).
  • twilio: X-Twilio-Signature.

Request​

Responses​

Receipt accepted and published to telemetry