Looking for the legacy API v1?
v1The previous version is deprecated but still available for existing integrations.
Coming soon: Holded API launches May 2026
We're putting the finishing touches on the new v2 API. Endpoints, docs and the OpenAPI spec are publicly available for preview. Production access opens this month.
Holded API
Integrate your business tools with Holded. Manage invoices, contacts, products, and more programmatically.
GET/api/v2/invoices200POST/api/v2/contacts201GET/api/v2/products200PUT/api/v2/invoices/5f3a..200GET/api/v2/treasuries200Guides
Learn how to get started and make the most of the API.
Getting started
Make your first API call in minutes
Authentication
API keys, Bearer tokens, and permissions
Pagination
Navigate large result sets with cursors
Error handling
HTTP status codes and error handling
Limits
Three sliding windows, predictable bursts
Webhooks
Real-time event notifications
MCP Server
Connect AI assistants to your Holded data
Webhooks are coming soon
Real-time event notifications for invoices, payments, contacts, and more.
MCP Server
Connect AI assistants like Claude directly to your Holded account via Model Context Protocol.
API Reference
Complete reference for all endpoints, parameters, and responses.