Webhooks

Update webhook

Update the URL, events, or active status of an existing webhook endpoint.

put/v1/webhooks/{id}

Request

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

Path parameters

idstring required

The webhook ID (e.g. wh_abc123)

Request body

urlstring uri
eventsstring[]

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

activeboolean

Set to false to pause delivery without deleting the webhook

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

Example request

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

Response

Webhook updated

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

Example response

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

Changes

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