Sign in

v1

latestOpenAPI 3.1.0© Copyright Partoo2026-07-26163503484.0 KB
Webhooks

Update a webhook configuration

This endpoint updates a webhook configuration.

patch/webhooks/{webhook_id}

Path parameters

webhook_idinteger required

The webhook object identifier.

Query parameters

org_idinteger

Organization identifier, only required for PROVIDER users.

Request body

urlstring required

The URL receiving the webhook's data. Only HTTPS URLs are supported.

custom_headersCustomHeaders

Custom HTTP headers to include in webhook requests. Keys must start with X- (case-insensitive) and must not use the reserved X-Partoo prefix. Maximum 5 headers. Key max length: 128 characters. Value max length: 512 characters. The following characters are forbidden in header keys: space, (, ), <, >, @, ,, ;, :, \, ", /, [, ], ?, =, {, }.

Example request

{
  "url": "https://example.com/webhook",
  "custom_headers": {
    "X-My-Header": "my-value",
    "X-Auth-Token": "secret-token"
  }
}

Response

OK

idinteger required

The identifier for the webhook configuration.

urlstring required

The URL receiving the webhook's data.

event_type'business_created' | 'business_updated' | 'business_deleted' | 'message_updated' | 'message_created' | 'lead_received' required

The webhook event type.

created_atstring required

An ISO 8601 date-time string representing the webhook creation date.

updated_atstring required

An ISO 8601 date-time string representing the webhook last update date.

org_idinteger required

The organization identifier for the webhook configuration.

custom_headersCustomHeaders

Custom HTTP headers to include in webhook requests. Keys must start with X- (case-insensitive) and must not use the reserved X-Partoo prefix. Maximum 5 headers. Key max length: 128 characters. Value max length: 512 characters. The following characters are forbidden in header keys: space, (, ), <, >, @, ,, ;, :, \, ", /, [, ], ?, =, {, }.

Example response

{
  "id": 1,
  "url": "https://example.com/webhook",
  "event_type": "business_created",
  "created_at": "2024-11-27T16:10:44.929678Z",
  "updated_at": "2024-11-27T16:10:44.929678Z",
  "org_id": 1,
  "custom_headers": {
    "X-My-Header": "my-value",
    "X-Auth-Token": "secret-token"
  }
}