Sign in
Webhooks

Retrieve webhook

Retrieves the details of an existing webhook.

Required permissions:

  • developer:manage_webhook
get/webhooks/{id}

Path parameters

idstring required
Example:hook_xxxxxxxxxxxxx

The unique identifier of the webhook to retrieve.

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