Skip to main content
PUT
Update webhook

Authorizations

Authorization
string
header
required

API key authentication. Use your API key as the bearer token.

Path Parameters

id
string<uuid>
required
Example:

"123e4567-e89b-12d3-a456-426614174000"

Body

application/json
name
string
Minimum string length: 1
Example:

"Updated Webhook Name"

url
string<uri>
Example:

"https://api.example.com/webhooks"

inbox_ids
string<uuid>[] | null

Optional array of inbox UUIDs to scope receiving webhooks. Only applicable when type is 'receiving'. Set to null to receive from all inboxes.

Example:

Response

Webhook updated

id
string<uuid>
required
Example:

"123e4567-e89b-12d3-a456-426614174000"

organization_id
string<uuid>
required
name
string
required
url
string<uri>
required
type
enum<string>
required

Webhook category type that determines which events the webhook subscribes to

Available options:
transactional,
domain,
receiving
Example:

"transactional"

events
string[]
required

Derived list of events based on the webhook type. Read-only.

inbox_ids
string<uuid>[] | null
required

Inbox UUIDs for scoping receiving webhooks. Null for non-receiving types.

secret
string
required
active
boolean
required
created_by
string<uuid> | null
required
created_at
string<date-time>
required