Cloxo API: koppel je prikklok aan je andere software
Met de Cloxo API laat je kassa, planning of loonpakket medewerkers in- en uitklokken en haal je uren, aanwezigheid en maandrapporten op. De API zit in elk plan, ook tijdens de proefperiode.
Cloxo houdt bij wie wanneer werkt. Die uren heb je vaak ook elders nodig: in je kassa, in je planning of bij de loonverwerking. Met de Cloxo API praat je andere software rechtstreeks met je prikklok, zonder overtypen en zonder bestanden heen en weer te sturen.
In het kort
- REST-API met JSON over HTTPS, beschreven in een OpenAPI-bestand
- In- en uitklokken en pauzes registreren vanuit je eigen software
- Medewerkers, aanwezigheid, registraties en maandrapporten ophalen
- MCP-server voor AI-assistenten
- Inbegrepen in elk plan en in de gratis proefperiode
- Sleutel aanmaken in een minuut, intrekken wanneer je wilt
Ontwikkelaar? Lees de documentatie van de API.
Wat je ermee doet
| Je wilt | Zo doet de API het |
|---|---|
| Inklokken vanuit je kassa of toegangscontrole | Je software stuurt een klokactie zodra iemand zich aanmeldt. Cloxo maakt er een registratie van. |
| Zien wie er nu is | Eén aanvraag geeft per medewerker de toestand: ingeklokt, in pauze of uitgeklokt. |
| Uren naar je loonverwerking | Haal de registraties van een periode op, of het maandrapport per medewerker, ook als pdf. |
| Je planning naast de werkelijkheid leggen | Vergelijk geplande met gewerkte uren, per dag en per persoon. |
| Nieuwe medewerkers toevoegen | Je software maakt een medewerker aan. Die klokt daarna met een pincode. |
Zo werkt het
- Maak een sleutel aan. In Cloxo, onder Instellingen → API & koppelingen. Je kiest wat de sleutel mag: gegevens lezen, in- en uitklokken of medewerkers toevoegen.
- Geef de sleutel aan je softwareleverancier of ontwikkelaar. Die leest de documentatie en bouwt de koppeling.
- Klaar. De registraties komen in Cloxo terecht naast die van de app, de QR-code en de tablet. Correcties en rapporten werken zoals je gewend bent.
Zo ziet een klokactie eruit:
curl -X POST "https://app.cloxo.app/api/public/v1/clock-events" \
-H "Authorization: Bearer cloxo_live_…" \
-H "Content-Type: application/json" \
-d '{"action":"clock_in","employee_id":"7c1d6a52-3f0e-4c9b-9a51-2f6f3f1f0b11"}'
De volledige referentie, met alle mogelijkheden, foutcodes en voorbeelden, staat in de documentatie voor ontwikkelaars. Er is ook een OpenAPI-bestand om in Postman te laden of een client mee te genereren.
Voor AI-assistenten: MCP
Cloxo heeft ook een MCP-server. Daarmee werkt een AI-assistent rechtstreeks met je prikklok. Je vraagt “Wie is er nu aan het werk?” of “Hoeveel uren werkte Sofie in oktober?” en de assistent haalt het antwoord zelf op.
Je verbindt de assistent met dezelfde sleutel. Geef je die alleen leesrechten, dan kan de assistent niets wijzigen. De MCP-server werkt met programma’s die een sleutel kunnen meesturen, zoals Claude Code en Cursor.
Veilig opgezet
- Eén sleutel hoort bij één bedrijf en kan nooit gegevens van een ander bedrijf zien.
- Je kiest per sleutel de rechten en, als je wilt, een vervaldatum.
- Je trekt een sleutel in met één klik. Hij werkt dan meteen niet meer.
- Cloxo bewaart alleen een afdruk van de sleutel. De sleutel zelf zie je één keer, bij het aanmaken.
- Alle verkeer loopt versleuteld en de gegevens staan op Europese servers.
Wat de API niet is
De API is een bouwsteen. Er zijn geen kant-en-klare koppelingen met een bepaald loonpakket of sociaal secretariaat: de koppeling bouwt je softwareleverancier of een ontwikkelaar. Wil je niets bouwen? Dan blijft de export naar PDF of CSV de snelste weg naar je boekhouder.
Veelgestelde vragen
Heeft Cloxo een API?
Ja. Cloxo heeft een REST-API waarmee andere software medewerkers kan in- en uitklokken en medewerkers, aanwezigheid, registraties en maandrapporten kan ophalen. De documentatie staat op app.cloxo.app/developers.
Kost de API extra?
Nee. De API zit in elk plan en werkt ook tijdens de gratis proefperiode. Je hebt wel een actief abonnement of een lopende proefperiode nodig.
Kan ik Cloxo koppelen met mijn loonpakket of sociaal secretariaat?
Er is geen kant-en-klare koppeling per pakket. Je hebt twee wegen: de export naar PDF of CSV, die je in één klik doorstuurt, of de API, waarmee je softwareleverancier de uren automatisch ophaalt.
Heb ik een ontwikkelaar nodig?
Voor de koppeling zelf wel: iemand moet je software met de API verbinden. De sleutel maak je zelf aan in een minuut, onder Instellingen.
Is het veilig om een API-sleutel aan een leverancier te geven?
Ja, als je hem behandelt als een wachtwoord. Een sleutel hoort bij één bedrijf, krijgt alleen de rechten die jij kiest en is met één klik in te trekken. Cloxo bewaart alleen een afdruk van de sleutel, nooit de sleutel zelf.
Werkt Cloxo met AI-assistenten?
Ja, via de MCP-server. Een assistent die MCP ondersteunt en een sleutel kan meesturen, zoals Claude Code of Cursor, vraagt aanwezigheid, uren en rapporten op en kan, als je dat toelaat, in- en uitklokken.
Aan de slag
Maak een account aan, voeg een medewerker toe en maak je eerste sleutel. Tijdens de proefperiode werkt de API volledig, zonder betaalgegevens. Wat een plan kost, lees je bij de tarieven; praktische vragen staan in het helpcenter.