Holded
Service ID: holded
Business management software with top-class invoicing, accounting, inventory and CRM with projects in a super intuitive single platform that suits every type of business.
Beta — this connector is in beta. Functionality and resource coverage may change.
At a Glance
- Difficulty
- ⚡MODERATEAPI Key Authentication - Each Consumer Creates Their Own Key in Holded
- Authentication
- API KeySent as a request header; not OAuth.
- Webhooks
- Virtual webhooks↗ - created and updated events across 11 resources, from invoices, bills and payments to employees. Deletions raise nothing.
- Partnership Required
- No
- Apideck Credentials
- Not available(Each consumer supplies their own Holded API key.)
- Costs
- Holded does not sell API access separately, so the cost is the subscription your consumer already pays, on whichever plan carries the quota you need.
- Sandbox Availability
- Available(Every Holded account includes a demo environment, switched into from the account menu. It takes sample data, can be reset, and the API reaches it too.)
- Account Type Required
- A Holded account on a paid plan: the free plan carries no API access.
- Consumer Access Level
- A user who can reach the Developers section in Holded, which the default developer role grants.
- Rate Limits
- 60 to 600 calls a minute by plan, plus a monthly quota from 500 on the entry plan to 100,000 at the top. Lower plans 429 at the cap; the top meters overage.
Responsibility matrix
| Task | You (Customer) | Your Consumer | Apideck |
|---|---|---|---|
| Enable the Holded connector | ✓ Via the Apideck Dashboard | — | — |
| Create the Holded API key | — | ✓ (choosing its module permissions) | — |
| Supply the key in Vault | — | ✓ | — |
| Store and encrypt credentials | — | — | ✓ |
| Build via the Unified API | ✓ Builds the requests | — | ✓ Maintains the connector |
| Deliver change events | — | — | ✓ |
| Monitor connections | ✓ Via the Apideck Dashboard | ✓ Can revoke the key anytime | ✓ Logs and alerts |
Environments
- Single host
- Holded serves one production host, https://api.holded.com/api. There is no separate development host, so the credential shape is the same wherever you point it.
- Testing
- Test against the demo environment rather than a live Holded account: anything the integration writes outside it lands in real books.
🚨Important to Know About Holded
- The monthly quota, not the per-minute rate, is what usually decides whether Holded can carry an integration: it is a single allowance for the whole account, drawn down by every key on it rather than granted per integration.
- A Holded API key belongs to the account rather than to the person who created it. Anyone holding it reaches everything the account exposes within the module permissions picked at creation, so choose those permissions deliberately.
- Holded serves both the accounting and HRIS APIs, and Vault keys a connection to one unified API, so each vertical is a separate connection using the same Holded API key. Employees are reachable only through HRIS: the accounting side excludes them.
⚠️
1 gotcha across 1 resource
Connector-specific behaviors and limitations to be aware of
📦
16 supported resources
View field mappings, supported operations, and schema details