Skip to main content
PATCH
Ruby

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

id
string<uuid>
required

Unique identifier of the webhook.

Body

application/json

Request body for updating a webhook. Only provided fields are changed.

url
string

New delivery URL. Must be HTTPS.

events
enum<string>[]

Replaces the full list of event type subscriptions.

Email lifecycle event type that can trigger a webhook delivery.

Available options:
accepted,
processed,
bounced,
delivered,
opened,
clicked,
complained,
unsubscribed,
resubscribed
channelId
string<uuid> | null

Set to a UUID to scope to a channel, or null to remove channel scoping.

additionalHeaders
object[] | null

Replaces all custom headers. Set to null to remove all custom headers.

enabled
boolean

Enables or disables the webhook.

Response

OK

Webhook configuration properties.

id
string<uuid>

Unique identifier for the webhook.

channelId
string<uuid> | null

Channel this webhook is scoped to, or null for account-wide.

url
string

The HTTPS URL events are delivered to.

payloadSigningKey
string

HMAC-SHA256 signing key used to verify webhook authenticity. Sent as the X-Helo-Webhook-Signature request header on each delivery.

enabled
boolean

Whether the webhook is active and will receive events.

additionalHeaders
object[]

Custom headers sent with each webhook delivery.

events
enum<string>[]

Event types that trigger this webhook.

Email lifecycle event type that can trigger a webhook delivery.

Available options:
accepted,
processed,
bounced,
delivered,
opened,
clicked,
complained,
unsubscribed,
resubscribed
lastResponse
object | null

The most recent delivery outcome for this webhook, or null if no delivery has been attempted yet.