Skip to content
Fipeo

Fipeo for developers

Changelog

Early access. The API, the webhooks and the widget are switched off for most accounts while we try them with the first schools and agencies. This documentation is public so you can plan your integration: write to [email protected] and we switch it on for you.

The API is in early access. Before the launch we settled v1: everything below is v1 as it is today, so there is nothing to migrate. From now on, within v1 we only add things (routes, fields, events, statuses and error codes) and your client must ignore fields it does not know. A breaking change would go to /v2, announced here in advance.

November 2026 — v1, before the launch

  • API keys with scopes and OAuth 2.0 client credentials (POST /oauth/token, POST /oauth/revoke).
  • Routes: /me, /schools, /courses, /quotes, /bookings, /students (read and create). students and quotes answer 403 dpa_required while the data processing agreement is required and not accepted.
  • Stable English codes for every status: bookings new, pending, alternative_proposed, accepted, declined, cancelled, expired; inbox modality on_request or instant. The same in webhooks.
  • Date-times in ISO 8601 in UTC (2026-11-11T10:00:00Z) everywhere, in responses and in webhooks. Dates stay YYYY-MM-DD.
  • In bookings, school is the same object in the list and in the detail: { id, name }.
  • Every list takes page and answers items, total, page, pages and next: nothing is cut silently.
  • An invalid filter (status, page…) answers 422 with an agency or a school key. A path that does not exist answers 404 not_found; a method that is not allowed, 405 method_not_allowed.
  • RateLimit-Limit, RateLimit-Remaining, RateLimit-Reset and RateLimit-Policy on every answer to a key, besides Retry-After on 429.
  • Idempotency-Key on POST /students: the same request with the same key returns the same answer for 24 hours.
  • Signed webhooks (booking.created, booking.status_changed, quote.accepted, student.created, message.created, ping) with retries, delivery log and resend; automation.run for the «webhook» action of CRM automations.
  • Price widget and WordPress plugin, the public OpenAPI 3.1 specification and this developer portal.