SETSimple Easy Transactions
SET DocsAPI reference and complianceUpdated 2026-11-10
Browse: SET Merchant API

SET Merchant API · Events & webhooks

Change a webhook endpoint

POST/v1/webhook_endpoints/{id}

Key scope: write

Changes the URL, the event filter, or both. Any change to a further endpoint resumes it if SET had paused it; events missed while it was paused are then sent.

Path parameters

id stringrequired
The webhook endpoint's id.

Headers

Idempotency-Key string
Optional. The same key and body run once; a replay answers with Idempotent-Replayed: true. Kept 24 hours.

Body

url https URL
The new URL.
events string[]
The new filter.

Errors

  • 400 body_invalid
  • 400 url_invalid
  • 400 events_invalid
  • 400 nothing_to_set
  • 404 webhook_endpoint_unknown
  • 401 api_key_required
  • 401 api_key_invalid
  • 401 api_key_wrong_mode
  • 403 scope_missing
  • 429 rate_limited

All codes: Errors.