Set your webhook endpoint

POST/v1/webhook_endpoint

Key scope: write

Sets where SET pushes events and which ones. A filtered-out event is never pushed: it stays at GET /v1/events with delivery.filtered: true. A ping always goes. Event webhook_endpoint.updated.

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 | null: A public https URL, at most 500 characters; null stops pushing events.
events string[]: Up to 50 event types (payout.payment_processed) or families (payout.*); [] for every event.

Errors

400 field_not_used
400 url_invalid
400 events_invalid
400 nothing_to_set
401 api_key_required
401 api_key_invalid
401 api_key_wrong_mode
403 scope_missing
429 rate_limited

All codes: Errors.

Request

curl -X POST "https://wallet.simpleeasytransactions.com/v1/webhook_endpoint" \
  -H "Authorization: Bearer $SET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "url": "https://example.com/set-webhooks", "events": ["payout.*", "deposit.payment_processed"] }'

Body

{ "url": "https://example.com/set-webhooks", "events": ["payout.*", "deposit.payment_processed"] }

Response 200

{
  "object": "webhook_endpoint",
  "url": "https://example.com/set-webhooks",
  "events": ["payout.*", "deposit.payment_processed"],
  "secretVersion": 1,
  "secretRotatedAt": "2026-11-08T15:04:05.000Z",
  "signature": "SET-Signature: t=<unix seconds>,v1=<hex HMAC-SHA256 of \"<t>.<raw body>\">. During a rotation a second v1, under the previous secret, is added; accept either.",
  "sandbox": false
}