Skip to main content
PATCH
curl

Authorizations

Authorization
string
header
required

Partner API key sent as Authorization: Bearer . Test keys and live keys are separate.

Path Parameters

endpoint_id
string<uuid>
required

The webhook endpoint id.

Body

application/json
url
string

The https URL (port 443) that receives deliveries.

Required string length: 1 - 2048
Pattern: \S
events

[""] for every event, or a non-empty list of event types; "" cannot be combined with event types and duplicates are ignored. A value that is not a list, a blank entry or an entry longer than 48 characters is refused first with 422 invalid_request; a list of strings that is not ["*"] or a non-empty list of documented event types is then refused with 422 invalid_webhook_events.

Minimum array length: 1
Available options:
*
description
string

Your description of the endpoint.

Maximum string length: 200
status
enum<string>

enabled or disabled. Re-enabling resets the failure streak.

Available options:
enabled,
disabled

Response

Success.

id
string<uuid>
required

The webhook endpoint id.

object
enum<string>
required

Always webhook_endpoint.

Available options:
webhook_endpoint
url
string<uri>
required

The https URL (port 443) that receives deliveries.

description
string
required

Your description of the endpoint.

mode
enum<string>
required

test or live, from the API key that created it.

Available options:
live,
test
events
string[]
required

Event types sent to the endpoint, or ["*"] for all of them.

status
enum<string>
required

enabled, disabled or auto_disabled.

Available options:
enabled,
disabled,
auto_disabled
failure_streak
integer
required

Consecutive failed deliveries; reset by a successful delivery or by re-enabling the endpoint.

last_success_at
string<date-time> | null
required

When a delivery to the endpoint last succeeded.

last_failure_at
string<date-time> | null
required

When a delivery to the endpoint last failed.

previous_secret_expires_at
string<date-time> | null
required

After a rotation, when the previous secret stops signing deliveries; otherwise null.

created_at
string<date-time>
required

When it was created.

updated_at
string<date-time>
required

When it last changed.