Looking for the legacy API v1?
v1The previous version is deprecated but still available for existing integrations.
Holded API v2 is now live
The new v2 API is in production. Explore the endpoints, browse the OpenAPI spec, and generate your API Token to start building.
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.
