https://api.ub.bitbros.in
Creating a webhook
- Go to the Webhooks section in your urBackend dashboard.
- Enter the URL of the server endpoint that will receive the events.
- Either copy the auto-generated signing secret or enter your own. Store this secret securely — you will use it to verify incoming requests.
- Save the webhook. urBackend will begin sending events to your URL immediately.
Payload format
Every webhook event is delivered as aPOST request with a JSON body in this shape:
Verifying webhook signatures
Your webhook URL is public, so anyone could send data to it. urBackend signs every payload with your signing secret using HMAC-SHA256 and includes the signature in theX-urBackend-Signature header. Always verify this signature before processing the event.
How verification works
- urBackend computes
HMAC-SHA256(signingSecret, JSON.stringify(requestBody)). - The resulting hex digest is sent in
X-urBackend-Signature. - Your server performs the same computation and compares the result.
- If the signatures match, the request is authentic.
Node.js / Express example
Retry logic
If a delivery fails (timeout over 10 seconds, or a4xx/5xx response), urBackend will automatically retry. You can inspect every delivery attempt — including the exact payload sent and the response received — in the Delivery History panel of your webhook’s dashboard page. You can also manually replay failed deliveries from there.
