Webhooks

Create webhook

Register a new webhook endpoint. SMTPfast will POST event payloads to this URL when the specified events occur.

post/v1/webhooks

Request

  • Base URL: https://smtpfa.st/api
  • URL: https://smtpfa.st/api/v1/webhooks
  • Auth: HTTP bearer

Request body

urlstring uri required

The URL that will receive webhook POST requests

eventsstring[] required

List of event types to subscribe to. Legacy unprefixed email aliases are accepted and normalized to Resend-style email.* event names.

format'standard' | 'discord' | 'slack'

Payload format. standard is the signed JSON envelope; discord and slack post readable messages to a chat webhook URL. Detected from the URL when left out.

Example request

{
  "url": "https://yourapp.com/webhooks/smtpfast",
  "events": [
    "email.delivered",
    "email.bounced"
  ]
}

Response

Webhook created

idstring required
urlstring uri required
eventsstring[] required
activeboolean required
format'standard' | 'discord' | 'slack'
secretstring

The signing secret. Returned once, in the create response.

created_atstring date-time required
updated_atstring date-time

Example response

{
  "id": "wh_abc123",
  "url": "https://yourapp.com/webhooks/smtpfast",
  "events": [
    "email.delivered",
    "email.bounced"
  ],
  "active": true,
  "created_at": "2026-04-05T12:00:00Z"
}

Changes

No recorded changes to this operation across all 1 revision of this API.