API & Webhooks

NoveuFlow heeft een REST API waarmee je vanuit externe systemen afspraken kunt opvragen, aanmaken en beheren. Daarnaast kun je webhooks instellen om meldingen te ontvangen wanneer er iets gebeurt. REST API Alle API-endpoints beginnen met: https://jouwsite.nl/wp-json/efficio/v1/ Authenticatie De API gebruikt WordPress REST API authenticatie. Voor externe systemen gebruik je Application Passwords: 1. Ga naar WordPress > Gebruikers > je profiel 2. Scroll naar "Application Passwords" 3. Maak een nieuw wachtwoord aan 4. Gebruik dit als Basic Auth: Authorization: Basic base64(gebruikersnaam:wachtwoord) Beschikbare endpoints GET /appointments — Alle afspraken (met paginering) GET /appointments/{id} — Een specifieke afspraak POST /appointments — Nieuwe afspraak aanmaken PUT /appointments/{id} — Afspraak bijwerken DELETE /appointments/{id} — Afspraak verwijderen GET /services — Alle diensten GET /employees — Alle medewerkers GET /customers — Alle klanten GET /slots?date=2026-01-15&service_id=3 — Beschikbare tijdslots Webhooks Met webhooks stuur je een HTTP POST naar een URL van jouw keuze wanneer er iets gebeurt. Instellen doe je in NoveuFlow > Instellingen > Webhooks. Beschikbare events: - appointment.created — Nieuwe afspraak - appointment.updated — Afspraak gewijzigd - appointment.cancelled — Afspraak geannuleerd - appointment.completed — Afspraak afgerond - customer.created — Nieuwe klant - payment.received — Betaling ontvangen Elke webhook bevat een JSON-payload met de volledige gegevens. Er wordt een signature header meegestuurd (X-Efficio-Signature) zodat je kunt verifieren dat het bericht echt van NoveuFlow komt. Als de ontvanger niet met een 2xx-status antwoordt, probeert NoveuFlow het nog 3 keer (na 1 min, 5 min, 30 min).