Webhook management

Register an endpoint

Add an endpoint, up to 5 per account. The signing secret is returned once, in this answer only: store it to verify deliveries.

POST https://el-b.com/api/v1/webhooks

Authorization

Authorizationheaderrequired

Bearer elb_sk_…: your API key, from API in your El-B account.

Body

url string required

A public https:// address, up to 500 characters. Private and internal addresses are refused.
events array required

Event names, or ["*"] for every event, including ones added later.

Responses

Status	Meaning
`201`	Success. The body is shown alongside.
`422`	A field is invalid, or the account already has 5 endpoints (`limit_reached`).
`401`	Missing, unknown or paused API key.
`403`	The account is suspended, or no longer verified by an official document.
`429`	More than 60 requests in a minute. See Rate limits.

curl -X POST "https://el-b.com/api/v1/webhooks" \ -H "Authorization: Bearer $ELB_API_KEY" \ -H "Accept: application/json" \ -H "Content-Type: application/json" \ -d '{ "url": "https://shop.example.com/elb/webhooks", "events": [ "payment.reference_submitted", "payment.finalized" ] }'

use Illuminate\Support\Facades\Http; $response = Http::withToken(env('ELB_API_KEY')) ->acceptJson() ->post('https://el-b.com/api/v1/webhooks', [ 'url' => 'https://shop.example.com/elb/webhooks', 'events' => [ 'payment.reference_submitted', 'payment.finalized', ], ]); $payment = $response->json('data');

const response = await fetch('https://el-b.com/api/v1/webhooks', { method: 'POST', headers: { Authorization: `Bearer ${process.env.ELB_API_KEY}`, Accept: 'application/json', 'Content-Type': 'application/json', }, body: JSON.stringify({ "url": "https://shop.example.com/elb/webhooks", "events": [ "payment.reference_submitted", "payment.finalized" ] }), }); const { data } = await response.json();

import os import requests response = requests.request( "POST", "https://el-b.com/api/v1/webhooks", headers={"Authorization": f"Bearer {os.environ['ELB_API_KEY']}"}, json={ "url": "https://shop.example.com/elb/webhooks", "events": [ "payment.reference_submitted", "payment.finalized", ], }, ) data = response.json()

{ "data": { "id": "0199c1e4-7a2b-7d31-9e0f-4b6c8d2a1f57", "url": "https://shop.example.com/elb/webhooks", "events": [ "payment.reference_submitted", "payment.finalized" ], "is_active": true, "signing_secret_hint": "whsec_7Kq…", "last_triggered_at": "2026-11-02T10:24:39+01:00", "created_at": "2026-11-01T09:00:00+01:00" }, "signing_secret": "whsec_7KqD2vN8mR4tY1wE5uI9oA3sZ6fG0hJ2lP4xC8bT" }