Webhooks
Register an HTTPS endpoint and Inbox Ledger POSTs JSON to it whenever invoices and receipts are processed.
Webhooks
Admin+A webhook is an HTTPS endpoint you own that Inbox Ledger calls when something happens to a document. When an invoice or receipt is processed, Inbox Ledger sends an HTTP POST to your URL with a JSON body describing the event. Use webhooks to push extracted invoices into your own accounting system, a database, or a Slack channel without polling.
What you'll need
The admin or owner role, plus the Premium plan or the Webhooks add-on at $19 per month. See Add-ons to enable the add-on on a Starter or Growth plan.
You also need a public HTTPS endpoint that can accept POST requests. A private or internal address is rejected when you save the webhook.
Register an endpoint
Open Dashboard then Webhooks at /dashboard/webhooks.
Add a webhook
Click Add Webhook and paste your HTTPS endpoint URL into the URL field.
Pick the events
Tick the events you want delivered, such as invoice.created and receipt.created.
See Events and payloads for the full list.
Save
Click Save. Inbox Ledger generates a signing secret and stores it encrypted.
Copy the signing secret
The secret is shown once after you save. Copy it and store it where your endpoint can read it. You use it to verify that each delivery came from Inbox Ledger.
The signing secret is displayed once at creation and is not shown again. If you lose it, delete the webhook and create a new one to get a fresh secret. Treat it like a password and never commit it to source control.
What happens after you register
Each time a subscribed event fires, Inbox Ledger queues a delivery and POSTs the JSON payload to your URL.
Every request carries an X-Signature-256 header so you can confirm it came from Inbox Ledger.
Verify that signature before you trust the body.
See Securing and verifying webhooks.
Related
Events and payloads
The events and the JSON each one sends.
Securing and verifying webhooks
Validate the HMAC signature on every delivery.
Add-ons
Enable the Webhooks add-on on any plan.
Ready to try this?
Inbox Ledger turns your inbox into clean accounting data. The free tier includes 10 credits, refilled every 30 days.
Start free