Gebouwd voor developers
Horixa is API-first: elk gegeven uit de applicatie is via de REST API op te halen, en in elke module ook te schrijven, van relaties, projecten, diensten, taken en uren tot verkoopkansen, verlof, verzuim, planning en facturatie. De API dwingt dezelfde regels af als het scherm: een gefactureerde urenregel gaat op slot, een dienst met uren eraan blijft staan, en een factuur krijgt zijn nummer uit dezelfde sluitende reeks. De endpoint-structuur (/api/v2/…) volgt gangbare conventies en voelt direct vertrouwd als je eerder met Nederlandse projectsoftware-API's werkte. Automatiseer met webhooks of koppel externe pakketten.
Authenticatie
Maak in Horixa een API-key aan met precies de scopes die je nodig hebt (zoals crm:read of hours:write) en stuur die mee als Bearer-token:
curl https://horixa.nl/api/v2/crm/organization \ -H "Authorization: Bearer hx_live_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
Rate limit: 120 requests per minuut per key, met standaard X-RateLimit-* headers.
Endpoints per module
Alles onder /api/v2/<module>/…. Lijsten pagineren met limit en offset; detail-endpoints geven de onderliggende regels mee (factuurregels, offerteregels, diensten van een project).
| CRM | organization · organization/{id} · person · person/{id} · contactrole · note · relationtype · customfield · customfieldvalue | crm:read · crm:write schrijven: organisaties, contactpersonen en interacties aanmaken en bijwerken |
| Projecten | project · project/{id} · service · service/{id} · servicerate · task · task/{id} · template | projects:read · projects:write schrijven: projecten, diensten en taken aanmaken, bijwerken en verwijderen |
| Uren | hours · hours/{id} · hourstype | hours:read · hours:write schrijven: uren schrijven, wijzigen en verwijderen |
| Facturatie | invoice · invoice/{id} · invoice/{id}/finalize · payment · installment · companyprofile | invoices:read · invoices:write schrijven: betalingen boeken en een concept definitief maken |
| Inkoop | purchaseinvoice · purchaseinvoice/{id} · cost · cost/{id} | invoices:read · invoices:write schrijven: inkoopfacturen en kosten op projecten vastleggen, bijwerken en verwijderen |
| Sales | sales · sales/{id} · quote · quote/{id} · stage | sales:read · sales:write schrijven: verkoopkansen aanmaken, bijwerken (ook won/lost) en verwijderen |
| HRM & planning | employee · employee/{id} · leave · leave/{id} · leavetype · leavebalance · absence · absence/{id} · contract · team · planning · planning/{id} | hrm:read · hrm:write schrijven: verlof aanvragen en beoordelen, verzuim melden en afsluiten, inzet plannen |
| Documenten | document | crm:read (+ invoices:read voor factuur-pdf's) schrijven: geen |
Bekijk de volledige API-documentatie met alle endpoints, parameters, schema's en scopes, of download de altijd actuele specificatie als openapi.json (OpenAPI 3.1), met 48 paden en 82 operaties.
Webhooks
Abonneer je op events zoals hours.created of organization.created. Elke levering is ondertekend met een X-Horixa-Signature HMAC-header en wordt bij fouten automatisch opnieuw geprobeerd met exponential backoff.
AI-ready via MCP
Horixa heeft een ingebouwde MCP-server (Model Context Protocol), dé open standaard waarmee AI-assistenten veilig met software praten. Het adres is https://horixa.nl/api/mcp en er zijn twee manieren om er verbinding mee te maken.
Zonder sleutel, via OAuth 2.1
Webconnectors zoals Claude.ai en ChatGPT koppelen zichzelf: voeg Horixa toe als connector, vul het adres in, log in met je Horixa-account en keur de toegang goed. Horixa is een volledige OAuth 2.1-autorisatieserver met dynamische clientregistratie (RFC 7591), PKCE en metadata-discovery op /.well-known/oauth-authorization-server, dus de client regelt de rest zelf. De assistent krijgt precies de rechten van de ingelogde gebruiker, en je trekt de toegang weer in onder Instellingen → AI & API.
Met een API-key
Hulpmiddelen die zelf geen OAuth doen, zoals Claude Code en Cursor, koppel je met een Horixa-API-key als Bearer-token. Dan gelden de scopes van die key. Handig voor een vaste koppeling of een script dat zonder ingelogde gebruiker draait.
Beide routes zijn read-only en blijven uitsluitend binnen jouw eigen omgeving: uren, projecten, facturen en klanten opvragen kan, wijzigen niet.
# Claude Code
claude mcp add --transport http horixa https://horixa.nl/api/mcp \
--header "Authorization: Bearer hx_live_JOUW_KEY"
# Cursor / VS Code (mcp.json)
{ "mcpServers": { "horixa": {
"url": "https://horixa.nl/api/mcp",
"headers": { "Authorization": "Bearer hx_live_JOUW_KEY" } } } }Beschikbare tools o.a.: urenoverzichten, projectstatus, openstaande facturen, onderhanden werk, salespipeline, klant- en medewerkerzoekopdrachten. De volledige instelhandleiding staat in Horixa onder Instellingen → AI & API.