Skip to main content
PUT
Update a webhook

Authorizations

Authorization
string
header
required

JWT Bearer token. Obtain a token via your identity provider and pass it in the Authorization: Bearer <token> header.

Scopes

REAL_CALL_API_KEYS_WEBHOOKS_ACCESS

Path Parameters

id
string
required

Identifier of the resource. Globally unique ID built to be chronologically sortable by timestamp

Example:

"2nYn7qqkM5678Ks99ykvmZAr7pz"

Body

application/json

Update an organization webhook. Every field is optional; omitted fields keep their current value. The identifier travels in the path, not the body.

name
string
Minimum string length: 1
Example:

"Production alerts"

url
string

Destination URL. Must use HTTPS and must not contain credentials (user:password@).

Pattern: ^https://[^@/?#]+([/?#]|$)
Example:

"https://example.com/webhooks"

apiKey
string

Optional shared secret, forwarded on delivery as the outbound X-Api-Key header.

Minimum string length: 1
Example:

"s3cr3t"

events
string[]

Event types that trigger this webhook. stream.concluded (a call reached its final conclusion) is the only event sent today; other values are accepted but never trigger a delivery.

Minimum array length: 1
enabled
boolean

Whether the webhook is active. A disabled webhook receives no deliveries until it is enabled again.

Example:

true

Response

The updated webhook.

An organization webhook.

id
string
required

Identifier of the webhook.

Example:

"2nYn7qqkM5678Ks99ykvmZAr7pz"

organizationId
string
required

Owning organization.

Example:

"2nYn7qqkM5678Ks99ykvmZAr7pz"

name
string
required

Display name.

Example:

"Production alerts"

url
string
required

Destination URL. HTTPS only.

Example:

"https://example.com/webhooks"

events
string[]
required

Event types that trigger this webhook. stream.concluded (a call reached its final conclusion) is the only event sent today; other values are accepted but never trigger a delivery.

enabled
boolean
required

Whether the webhook is active. A disabled webhook receives no deliveries until it is enabled again.

Example:

true

createdAt
string<date-time>
required
Example:

"2026-07-01T12:00:00Z"

updatedAt
string<date-time>
required
Example:

"2026-07-01T12:00:00Z"