Update a Webhook

Replaces the URL and subscribed events of an existing webhook. Both fields are required, so a partial update is not possible: send the full set of events you want the webhook subscribed to, not just the ones you are adding.

Required scope (OAuth only): update-webhook

Parameters

Parameter	Type	Description
url	string required	The HTTPS URL notifications are delivered to. Maximum 255 characters.
enabled_events	array required	The complete set of events to subscribe to. At least one, each one of transaction.paid, transaction.failed, transaction.refunded, withdrawal.created.

Returns

Returns the updated Webhook object.

Request

Endpoint: https://youcanpay.com/api/v2/webhooks/{webhook_id}Method: PUT

$ curl --location -g --request PUT 'https://youcanpay.com/api/v2/webhooks/9b1f2c34-5d6e-4a7b-8c9d-0e1f2a3b4c5d' \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json' \
  -u 'YOUR_PRIVATE_KEY:' \
  --data '{
    "url": "https://example.com/webhooks/youcan-pay-v2",
    "enabled_events": ["transaction.paid", "transaction.failed", "withdrawal.created"]
  }'

Response

{
  "object": "v2.webhook",
  "id": "9b1f2c34-5d6e-4a7b-8c9d-0e1f2a3b4c5d",
  "url": "https://example.com/webhooks/youcan-pay-v2",
  "is_live_mode": true,
  "enabled_events": "[\"transaction.paid\",\"transaction.failed\",\"withdrawal.created\"]",
  "created_at": "2026-09-09 11:04:22"
}

Errors

Status	Description
404	No webhook with that identifier exists on this account.
422	The URL is missing or not a valid URL, or enabled_events is empty or contains an unknown event.