Developers
Developer overview
Connect Billleaf to your own tools with the REST API and webhooks.
Billleaf has two building blocks for integrations, on the Pro and Team plans:
API keys
Call the REST API from scripts, Zapier, Make or n8n.
Webhooks
Get notified when invoices are paid, quotes accepted and more.
API reference
Every endpoint an API key can use.
A quick example
Create a key in Settings → API keys — the page also shows your API address — then:
curl "$BILLLEAF_API_URL/v1/clients" \
-H "Authorization: Bearer blk_your_key"Conventions
- JSON over HTTPS; dates are
YYYY-MM-DD, times are ISO 8601 in UTC. - Money is an integer in minor units with an ISO currency code:
12345withUSDmeans $123.45. Currencies without minor units (like JPY) are whole amounts. - Lists are paged:
?page=1&pageSize=25, and responses includeitems,total,pageandpageSize. Many lists acceptsort=field:asc|descand filters. - Errors use problem details JSON with a
codeyou can match on. - Issued documents are immutable: invoices and receipts can't be edited once issued; void them or issue credit notes.