Vai al contenuto
Fipeo

Fipeo for developers

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 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

AgenciesSchools
ReadConnected schools, their courses priced for the student, quotes, bookings and studentsYour booking inbox
WriteAdd students to your CRM from your website or app, with their consent—
WebhooksNew and changed bookings, accepted quotes, new students, new messagesNew and changed bookings, new messages
WidgetCourses of your connected schools with live prices; requests go to your CRMYour courses with live prices; requests go to your inbox

Start in 5 minutes

  1. 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.
  2. 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_…
  3. Make your first call. /me needs no permission and tells you who the key belongs to:
bash
curl https://fipeo.net/api/public/v1/me \
  -H "Authorization: Bearer $FIPEO_KEY"
200 OK
{
  "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"]
}
  1. Read or write something. An agency with students:write can 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):
bash
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
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:

bash
curl "https://fipeo.net/api/public/v1/courses?city=Dublin&weeks=4&start=2027-07-05" \
  -H "Authorization: Bearer $FIPEO_KEY"
  1. 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 (100000 EUR = 1,000.00 €). Dates are YYYY-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 get 429 with Retry-After.
  • Lists come in pages: follow next until it is null. Retry a POST safely with the same Idempotency-Key.
  • Errors come as JSON with a stable error code and a message in 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).

Integrazioni

Fipeo si collega già con:

Pagamenti
Stripe · PayPal · Klarna
Esportazione contabile
Xero · QuickBooks · Sage 50 · DATEV · Holded · A3
CRM
HubSpot
API e automazione
REST API · OAuth 2.0 · Webhooks · Zapier · Make
Il tuo sito
WordPress · Widget
Fatturazione (Spagna)
Verifactu (AEAT)
Disponibili su richiesta
Moodle · Canvas · Google SSO · Microsoft SSO · TYPO3

Alcune sono ancora in accesso anticipato.

Usi una piattaforma che non è nell’elenco?

Dicci quale e valuteremo di integrarla.

Scrivici a [email protected] indicando la piattaforma e a cosa ti serve.