API keys and the API
Create API keys with exactly the access they need, call the REST API and read its reference inside Hectile.
Settings
- Create API Key — a name, what it can do and which Brands.
- Can — None, Read or Write for Customers, Items, Estimates, Invoices and notes, Payments; Read for Reports.
- Turn on API and webhooks
Settings → Features → Connections (Business).
- Settings → Developers → Create API Key
Name it after what will use it.
- Choose access
Per kind of data, and all Brands or one Brand.
- Copy the key
It’s shown once. Hectile keeps only a hash.
- Call the API
https://hectile.com/api/v1 with Authorization: Bearer and your key.
What the API does
Customers, items, estimates, invoices and credit notes (create a draft or issue with finalize), payments against invoices, summary and unpaid reports, and webhook subscriptions for apps. It never deletes issued documents or changes settings, team or billing. Every request and answer is documented in Settings → Developers → API reference.
| Rate limit | 60 requests a minute per key |
| Safe retries | Idempotency-Key on creates (24 hours) |
| Lists | 100 a page |
| Errors | Clear codes — UNAUTHENTICATED, SCOPE, PLAN, VALIDATION_FAILED… |
A key acts as the person who made it, within its access. Revoke it in Settings → Developers the moment it’s no longer needed.
Keep going
Still stuck? Contact Support.
Tell us what you were trying to do and which Organization, Brand or document it relates to. The support subject is preselected.
Try it on your own documents.
A 7-day free trial for your first eligible owned Organization, with one Primary Brand and one member.