Skip to main content
Webhooks let Ledger push real-time events to your HTTPS endpoint instead of requiring you to poll.

​
Create a webhook

curl -X POST https://api.ledger.so/v1/webhooks \
  -H "Authorization: Bearer $LEDGER_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: create-webhook-1" \
  -d '{
    "url": "https://example.com/ledger/webhooks",
    "events": ["*"]
  }'
Use ["*"] to subscribe to all events, or specify individual event types.

​
Test your webhook

curl -X POST https://api.ledger.so/v1/webhooks/whk_.../test \
  -H "Authorization: Bearer $LEDGER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"data": {"message": "hello"}}'

​
Next steps