Email Webhooks

List webhooks for an email domain

Changed on

Returns a paginated list of webhook subscriptions scoped to the email domain. Results can be sorted by creation time.

get/email_domains/{domain_id}/webhooks

Request

  • Base URL: https://api.telnyx.com/v2
  • URL: https://api.telnyx.com/v2/email_domains/{domain_id}/webhooks
  • Auth: HTTP bearer

Path parameters

domain_idstring uuid required

Email domain UUID

Query parameters

page[number]integer

Page number to return (offset pagination)

page[size]integer

Number of records per page

sort'created_at' | '-created_at'

Field to sort by. Prefix with - for descending order.

Response

A paginated list of email webhooks

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

  • 16bfa298dc71Revision changes
    • warning

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

    • warning

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

    • warning

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

    • warning

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

    • warning

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

  • 6ef0ae248bf7Revision changes
    • info

      endpoint added