v1

latestOpenAPI 3.1.02026-07-24145580597.0 KB

Settings:v1:Webhook

Update Webhook

Update an existing webhook settings by its unique ID.

put/settings/v1/webhooks/{webhookId}

Path parameters

webhookIdinteger required

The unique identifier of the webhook

Request body

namestring nullable

The name of the webhook

urlstring uri nullable

The specified endpoint url the payload will be sent to when the event is triggered. Must be a valid https endpoint.

secretKeystring nullable

The secret key for this webhook

isDisabledboolean nullable

Determines whether the webhook settings is disabled or enabled upon creation. Default to enabled.

featureTypestring nullable

The feature type of the webhook. Current options are: users, forms, time_activity, tasks

entityIdstring nullable

The ID of the entity scoping this webhook, as a string. For numeric-scoped features (e.g. time activity, shift scheduler) pass the numeric ID as a string, e.g. "67". For string-scoped features (e.g. chat) pass the domain identifier directly, e.g. "conv_abc". If both entity_id and object_id are provided, entity_id wins.

objectIdinteger nullable

Deprecated. Use entity_id instead. Kept for backward compatibility.

eventTypesstring[] nullable

The event types under the specified feature type. The list of events is available in the Guides section or on the platform.

webhookVersioninteger nullable

The version of the webhook payload schema.

Response

Successful Response

requestIdstring