Fipeo for developers
The Fipeo API lets a language school or an agency connect its own tools with Fipeo: your website, your CRM, your booking or accounting system, Zapier or Make. It is a REST API over HTTPS with JSON, and every key only sees the data of its own organization. Prices are always what the student pays: commissions and net prices never leave Fipeo.
What you can build
| Agencies | Schools | |
|---|---|---|
| Read | Connected schools, their courses priced for the student, quotes, bookings and students | Your booking inbox |
| Write | Add students to your CRM from your website or app, with their consent | — |
| Webhooks | New and changed bookings, accepted quotes, new students, new messages | New and changed bookings, new messages |
| Widget | Courses of your connected schools with live prices; requests go to your CRM | Your courses with live prices; requests go to your inbox |
Start in 5 minutes
- Create a key. Sign in to Fipeo and open Integrations in the menu (the owner or an administrator of the agency; for a school, its main account). In API keys, give the key a name, tick the permissions it needs and press Create the key. Copy it now: it starts with
fpk_and is shown only once. - Keep it secret. Put it in an environment variable on your server (never in a web page, an app or a URL):
export FIPEO_KEY=fpk_… - Make your first call.
/meneeds no permission and tells you who the key belongs to:
curl https://fipeo.net/api/public/v1/me \
-H "Authorization: Bearer $FIPEO_KEY"{
"organization": { "type": "agency", "id": "a1111111-1111-4111-8111-111111111111" },
"key": { "id": "0f0e0d0c-0b0a-4908-8706-050403020100", "name": "Zapier", "prefix": "fpk_Xy12Ab34", "expires_at": null },
"scopes": ["students:read", "students:write"]
}- Read or write something. An agency with
students:writecan add a student, as if they had filled in one of its forms (an opportunity is created in the pipeline and your team is notified):
curl https://fipeo.net/api/public/v1/students \
-H "Authorization: Bearer $FIPEO_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: 6f1d0c3e-9b2a-4d5f-8e7c-6b5a49382716" \
-d '{
"first_name": "Lucía",
"last_name": "Pérez",
"email": "[email protected]",
"nationality": "AR",
"consent_text": "I agree that Agencia Sol keeps my details to send me course offers.",
"opportunity_title": "Dublin summer"
}'HTTP/1.1 201 Created
{ "id": "5d1c…", "result": "created", "opportunity_id": "9a7e…" }With catalog:read, search the courses of your connected schools with the price for one student:
curl "https://fipeo.net/api/public/v1/courses?city=Dublin&weeks=4&start=2027-07-05" \
-H "Authorization: Bearer $FIPEO_KEY"- Get told when something happens with webhooks, and see every route in the API reference.
The OpenAPI specification
The whole API is described in an OpenAPI 3.1 file: routes, parameters, responses, errors, scopes and webhooks. Import it into Postman, Insomnia or Bruno, or generate a client with your favourite OpenAPI generator. An automated test checks that the file matches the real API on every change.
Good to know
- Base URL:
https://fipeo.net/api/public/v1. Only HTTPS. - Amounts are integers in cents of
currency(100000EUR = 1,000.00 €). Dates areYYYY-MM-DD; date-times are ISO 8601 in UTC (2026-11-11T10:00:00Z). Statuses are stable English codes (accepted,on_request…). - Limits: 120 requests per minute per key (30 of them writes). Every answer tells you where you are (
RateLimit-Remaining,RateLimit-Reset); over the limit you get429withRetry-After. - Lists come in pages: follow
nextuntil it isnull. Retry aPOSTsafely with the sameIdempotency-Key. - Errors come as JSON with a stable
errorcode and amessagein the language of your request (Accept-Language). - Something that is not yours answers
404, never «forbidden»: Fipeo does not reveal what belongs to others. - Questions: [email protected]. Security issues: [email protected] (see our security page).
Intégrations
Fipeo se connecte déjà à :
- Paiements
- Stripe · PayPal · Klarna
- Export comptable
- Xero · QuickBooks · Sage 50 · DATEV · Holded · A3
- CRM
- HubSpot
- API et automatisation
- REST API · OAuth 2.0 · Webhooks · Zapier · Make
- Votre site
- WordPress · Widget
- Facturation (Espagne)
- Verifactu (AEAT)
- Disponibles sur demande
- Moodle · Canvas · Google SSO · Microsoft SSO · TYPO3
Certaines sont encore en accès anticipé.
Vous utilisez une plateforme qui n’est pas dans la liste ?
Dites-nous laquelle et nous étudierons son intégration.
Écrivez-nous à [email protected] en indiquant la plateforme et votre besoin.