Sign in
Webhooks

Update webhook

Updates a webhook

Required permissions:

  • developer:manage_webhook
patch/webhooks/{id}

Path parameters

idstring required
Example:hook_xxxxxxxxxxxxx

The ID of the Webhook to update

Request body

api_version'v1' | 'v2' | 'v5'

The different API versions

child_resource_eventsboolean nullable

Whether or not to send events for child resources.

enabledboolean nullable

Whether or not the webhook is enabled.

eventsWebhookEvent[] nullable

The events to send the webhook for.

urlstring nullable

The URL to send the webhook to.

Example request

{
  "url": "https://example.com/path"
}

Response

A successful response

api_version'v1' | 'v2' | 'v5' required

The different API versions

child_resource_eventsboolean required

Whether events are sent for child resources. For example, if the webhook is on a company, enabling this sends events only from the company's sub-merchants (child companies).

created_atstring date-time required

The datetime the webhook was created.

enabledboolean required

Whether this webhook endpoint is currently active and receiving events.

eventsWebhookEvent[] required

The list of event types this webhook is subscribed to.

idstring required

The unique identifier for the webhook.

resource_idstring required

The ID of the resource (company or product) this webhook is attached to.

testable_eventsWebhookEvent[] required

The subset of subscribed event types that support sending test payloads.

urlstring required

The destination URL where webhook payloads are delivered via HTTP POST.

Example response

{
  "created_at": "2023-12-01T05:00:00.401Z",
  "id": "hook_xxxxxxxxxxxxx",
  "url": "https://example.com/path"
}

Changes