Skip to main content
PATCH
JavaScript

Authorizations

Authorization
string
header
required

Telnyx API key supplied as Authorization: Bearer <token>. In production, auth may be validated by the API gateway and forwarded via Telnyx auth headers.

Path Parameters

domain_id
string<uuid>
required

Email domain UUID

id
string<uuid>
required

Email webhook UUID

Body

application/json
url
string<uri>
events
enum<string>[]
Minimum array length: 1

Event types accepted by domain webhook subscriptions. Allowlists match the legacy event_type, not canonical_event_type. Of the 22 accepted types, email.sending is stored but intentionally not published. Cancellation, daily-limit failures, and system failures publish after commit when a matching domain webhook is configured.

Available options:
email.scheduled,
email.sandbox,
email.queued,
email.sending,
email.sent,
email.delivered,
email.deferred,
email.bounced,
email.failed,
email.complained,
email.opened,
email.clicked,
email.unsubscribed,
email.received,
email.cancelled,
email.daily_limit_exceeded,
email_domain.created,
email_domain.verified,
email_domain.degraded,
email_domain.suspended,
email_domain.deleted,
email_domain.dkim_rotated

Response

Email webhook updated

data
object
required
Example: