Skip to main content
GET
Error

Authorizations

Authorization
string
header
required

A merchant secret key (sk_…) sent as Authorization: Bearer <key>.

Path Parameters

id
string
required

The webhook endpoint id (whe_…).

Response

The webhook endpoint. The signing secret is not included.

id
string
required
object
enum<string>
required
Available options:
webhook_endpoint
merchant_id
string
required
livemode
boolean
required
url
string
required
description
string | null
required
event_types
string[]
required
api_version
string
required
status
enum<string>
required

Current lifecycle state. active means the endpoint is receiving deliveries. disabled means it is paused by the merchant. deleted means it has been soft-deleted. error means deliveries were disabled after repeated failures.

Available options:
active,
disabled,
deleted,
error
disabled
boolean
required

true when status is disabled; false otherwise.

created_at
integer
required

Unix epoch seconds.

updated_at
integer
required
secret_last_rotated_at
integer | null

Unix epoch seconds when the signing secret was last rotated. Null until the first rotation after creation.

deleted_at
integer | null

Unix epoch seconds when the endpoint was deleted. Null while active.