Integrations & APIs
Easedesk REST API — overview and authentication
How to authenticate and use the Easedesk REST API to read or write data across all 50+ modules.
Quick answer
Easedesk's REST API mirrors the in-app modules — GET/POST/PATCH/DELETE on resources like /api/v1/invoices, /api/v1/customers, /api/v1/employees. Auth: API key in the X-Easedesk-Key header. Generate keys in Settings → Developers → API Keys.
Get an API key
Settings → Developers → API Keys → Create New Key. Pick scope (read-only / read-write) and modules. Copy the key — it's shown only once.
Authentication
Add the header X-Easedesk-Key: <your-key> to every request. The key is tenant-scoped — you cannot access another tenant's data.
Resource paths
Resources live at /api/v1/<module>/<endpoint>. Example: GET https://www.easedesk.com/api/v1/invoices?limit=50. Each module follows REST conventions: GET list, POST create, GET/PATCH/DELETE by id.
Rate limits
100 requests / minute / API key. Burst up to 200 for 10 seconds. Higher limits available on Enterprise plans.
Webhooks
Settings → Developers → Webhooks → Add Endpoint. We send POST to your URL on events like invoice.paid, employee.created, ticket.resolved. Signed with HMAC-SHA256 for verification.
Frequently asked questions
Where are the full API docs?
Is there a Postman collection?
Can I revoke a key?
Related articles
Still have questions?
Use the AI Assistant inside Easedesk (it has access to your data), or reach our team.
Contact support