Skip to main content
DELETE
Error

Authorizations

Authorization
string
header
required

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

Headers

Idempotency-Key
string
required

Required. A unique key that makes retries safe: the same key with the same request body returns the original response instead of repeating the operation.

Maximum string length: 255

Path Parameters

id
string
required

The webhook endpoint id (whe_…).

Response

The deleted webhook endpoint, with deleted_at set.

id
string
required

Unique identifier for the webhook endpoint (whe_…).

object
enum<string>
required
Available options:
webhook_endpoint
merchant_id
string
required

ID of the account that owns the webhook endpoint (mer_…).

scope
enum<string>
required

The immutable event stream delivered to this endpoint.

Available options:
account,
connected_accounts
livemode
boolean
required
url
string
required

The HTTPS URL Ionic sends event payloads to.

description
string | null
required

Your label for the endpoint, or null if none is set.

event_types
string[]
required

Event types this endpoint receives, as exact types or wildcards.

api_version
string
required

API version that pins the event payload shape delivered to this endpoint.

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

Unix epoch seconds when the endpoint was last updated.

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.