Sign in
Email Webhooks

Create a webhook for an email domain

Creates a webhook endpoint subscribed to a specific allowlist of event types. Both email.* events (published by email-api) and email_domain.* events (published by this service) flow through the same webhooks.

post/email_domains/{domain_id}/webhooks

Path parameters

domain_idstring uuid required

Email domain UUID

Request body

urlstring uri required

HTTPS endpoint to deliver subscribed events to.

eventsEmailWebhookEvent[] required

At least one event type is required.

Response

Email webhook created

Example response

{
  "data": {
    "id": "123e4567-e89b-12d3-a456-426614174003",
    "record_type": "email_webhook",
    "url": "https://example.com/webhooks/email",
    "events": [
      "email.sent",
      "email.delivered",
      "email.bounced"
    ],
    "domain_id": "123e4567-e89b-12d3-a456-426614174000",
    "created_at": "2026-06-18T12:00:00Z",
    "updated_at": "2026-06-18T12:00:00Z"
  }
}

Changes

Changed in 3 of the 99 revisions of this API.164

  • 16bfa298dc7163See the full diff
    • ●

      added the new 40901 enum value to the // response property for the response status

      response-property-enum-value-added

    • ●

      added the new 40901 enum value to the // response property for the response status

      response-property-enum-value-added

    • ●

      added the new 40901 enum value to the // response property for the response status

      response-property-enum-value-added

    • ●

      added the new email.cancelled enum value to the // response property for the response status

      response-property-enum-value-added

    • ●

      added the new email.daily_limit_exceeded enum value to the // response property for the response status

      response-property-enum-value-added

    • ●

      added the new email_domain.dkim_rotated enum value to the // response property for the response status

      response-property-enum-value-added

    • ○

      added the new email.cancelled enum value to the request property /

      request-property-enum-value-added

    • ○

      added the new email.daily_limit_exceeded enum value to the request property /

      request-property-enum-value-added

    • ○

      added the new email_domain.dkim_rotated enum value to the request property /

      request-property-enum-value-added

    This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

  • 6ef0ae248bf71See the full diff
    • ○

      endpoint added

      endpoint-added

    This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

  • 224ed0d8a5c31See the full diff
    • ▲

      api path removed without deprecation

      api-path-removed-without-deprecation

    This revision also has 111 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

Of the 99 revisions, 1 has no diff computed.