Create a webhook subscription | Open Ledger Documentation

Create a new webhook subscription to receive real-time events

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

entityIdstringRequired

Entity ID to create subscription for

This endpoint expects an object.

webhookUrlstringRequiredformat: "uri"

URL to receive webhook events

eventslist of enumsRequired

Array of event types to subscribe to

secretstringOptional

Secret for webhook signature verification (optional)

Webhook subscription created successfully

successboolean

subscriptionobject

400

Bad Request Error

404

Not Found Error

1	curl -X POST "https://api-staging.openledger.com/v1/webhooks/subscriptions?entityId=entityId" \
2	-H "Authorization: Bearer <token>" \
3	-H "Content-Type: application/json" \
4	-d '{
5	"webhookUrl": "https://your-app.com/webhooks/openledger",
6	"events": [
7	"bank_account.connected",
8	"integration.connected"
9	]
10	}'

1	{
2	"success": true,
3	"subscription": {
4	"id": "e1d01893-34ab-4628-b2d8-ad25ef3f63ce",
5	"webhookUrl": "https://your-app.com/webhooks/openledger",
6	"events": [
7	"bank_account.connected",
8	"integration.connected"
9	],
10	"isActive": true,
11	"createdAt": "2025-09-15T20:18:49.840Z"
12	}
13	}