Webhooks

Subscribe to an event

Creates a new subscription.

post/webhooks

Request

Headers

versionstring date required

The API version with format yyyy-mm-dd. The current version is 2026-02-27.

Request body

eventsstring[] required

The list of events.

urlstring uri required

The URL of the Webhook endpoint.

descriptionstring nullable

The subscription description.

Example request

{
  "events": [
    "payment_intent.created",
    "payment.successful",
    "order.created"
  ],
  "url": "https://example.com/incoming-events"
}

Response

OK

idstring

The unique identifier for the subscription.

accountIdstring nullable

The unique identifier for the account.

eventsstring[]

The list of events.

urlstring uri

The URL of the Webhook endpoint.

descriptionstring nullable

The subscription description.

createdAtstring date-time

The creation date, in ISO 8601 UTC format.

updatedAtstring date-time

The timestamp of the update date, in ISO 8601 UTC format.

Changes

No recorded changes to this operation across all 1 revision of this API.