Webhook Subscriptions

Update webhook subscription

Updates the URL and/or subscribed events.

post/v1/webhook_subscriptions/{id}

Path parameters

idstring uuid required

Example:550e8400-e29b-41d4-a716-446655440009

Unique identifier of the webhook subscription.

Headers

Idempotency-Keystring required

Idempotency key for safe retries. Reusing a key with an identical request body returns the cached response. Reusing a key with a different body returns 409.

Request body

urlstring uri nullable

The new HTTPS URL. Omit or send null to keep the current URL.

eventsstring[] nullable

New event types. Omit or send null to keep the current events. Use ["*"] for all events.

Example request

{
  "url": "https://sandbox.example.com/webhooks/augustus",
  "events": [
    "payout.paid"
  ]
}

Response

Success

idstring required

Unique identifier of the webhook subscription.

type'webhook_subscription' required

Resource type discriminator.

urlstring required

The HTTPS URL where webhook events are delivered.

eventsstring[] required

Event types this subscription receives.

created_atstring date-time required

ISO 8601 UTC timestamp when the subscription was created.

updated_atstring date-time required

ISO 8601 UTC timestamp when the subscription was last updated.

Example response

{
  "id": "550e8400-e29b-41d4-a716-446655440009",
  "url": "https://sandbox.example.com/webhooks/augustus",
  "events": [
    "payout.paid"
  ],
  "created_at": "2026-01-15T10:30:00Z",
  "updated_at": "2026-01-15T10:35:00Z"
}