List webhook subscriptions

{ "ok": true, "data": [ { "id": "twhk_clxxxxxxxxxxxxxxxxxxxxxxxxx", "url": "https://hooks.acme.com/sendmux", "event_types": [ "ses.bounce", "ses.complaint" ], "enabled": true, "failing": false, "created_at": "2026-04-23T09:12:00Z", "updated_at": "2026-04-23T09:12:00Z" } ], "meta": { "request_id": "req_clxxxxxxxxxxxxxxxxxxxxxxxxx" } }

Authorizations

Authorization

string

header

required

Sendmux API key. Obtain from the dashboard under API Keys. Format: smx_root_...

Response

Subscription list

enum<boolean>

required

Available options:

true

data

object[]

required

Hide child attributes

data.id

string

required

Webhook public ID

Example:

"twhk_clxxxxxxxxxxxxxxxxxxxxxxxxx"

data.url

string<uri>

required

HTTPS endpoint that receives signed event POSTs.

Example:

"https://hooks.acme.com/sendmux"

data.event_types

enum<string>[]

required

Event types this subscription receives.

Event types a webhook may subscribe to. sendmux.test is accepted so you can verify end-to-end delivery via POST /webhooks/{id}/test.

Available options:

ses.bounce,

ses.complaint,

ses.delivery,

ses.reject,

ses.delivery_delay,

mail.inbound,

sendmux.test

Example:

["ses.bounce", "ses.complaint"]

data.enabled

boolean

required

When false, no events are delivered to this subscription.

Example:

true

data.failing

boolean

required

True when the 24-hour retry window has been exhausted for this subscription. Reset by updating the subscription (e.g. fixing the URL) and re-enabling.

Example:

false

data.created_at

string

required

ISO 8601 creation timestamp

Example:

"2026-04-23T09:12:00Z"

data.updated_at

string

required

ISO 8601 last-modified timestamp

Example:

"2026-04-23T09:12:00Z"

Overview

Domains

Providers

Emails

Billing

Webhooks

List webhook subscriptions

Authorizations

Response