API publique v1

Pilotez FolioDesk depuis votre code.

Une API REST complète pour automatiser vos workflows. Compatible Make, n8n, Zapier, ou directement depuis votre code custom. OpenAPI 3.1 documenté, webhooks fiables, scopes granulaires. Sync vers Pennylane (PA agréée) pour la facturation électronique 2026 · FolioDesk gère la relation client, votre PA gère la compta.

Documentation interactiveCréer une clé API
emit-invoice.sh
# Émettre + envoyer une facture
curl -X POST .../v1/public/invoices \
  -H "Authorization: Bearer fd_live_••••" \
  -d '{ "client_id": "cl_abc",
        "title": "Maintenance avril",
        "amount": 1500 }'
201 Created· inv_9f2 émise + envoyée + sync compta

Ce que vous pouvez automatiser

Tous les flux clés de FolioDesk sont exposés en REST. Vous pouvez créer des clients, envoyer des devis, marquer des factures payées, déclencher des actions sur vos espaces clients, recevoir des webhooks en temps réel.

Clients et espaces

Créer / lire / mettre à jour un client, attacher un espace, recherche full-text.

Devis et factures

Builder programmatique, envoi auto au client, marquage payé, avoirs (CGI 289 I-3).

Webhooks fiables

12 événements signés HMAC-SHA256, retry exponentiel, deliveries log consultable.

Scopes granulaires

Une clé par usage : lecture seule, écriture limitée, admin total. Révocation immédiate.

Compliance France

Numérotation séquentielle CGI, mentions LME, sync vers Pennylane (PA agréée DGFIP) + connecteurs Qonto/Axonaut.

Idempotency keys

Header `Idempotency-Key` sur tous les POST. Plus de doublons sur retry réseau.

Quickstart 30s

Créer une facture en 4 lignes

Une clé API. Un POST. Une facture émise + envoyée au client + synchronisée à votre logiciel comptable. Pas de SDK requis.

Voir tous les endpoints
curl https://foliodesk.io/api/v1/public/invoices \
  -H "Authorization: Bearer fd_live_XXXXXXXXXXXXXXXXXXXX" \
  -H "Idempotency-Key: order-1234" \
  -H "Content-Type: application/json" \
  -d '{
    "client_id": "cl_abc",
    "title": "Maintenance avril",
    "items": [{
      "description": "Forfait maintenance",
      "quantity": 1,
      "unit_price": 800,
      "total": 800,
      "vat_category": "standard"
    }],
    "subtotal": 800,
    "tax_rate": 20,
    "tax_amount": 160,
    "total": 960,
    "currency": "EUR",
    "due_date": "2026-04-30",
    "status": "sent"
  }'

Plug-and-play avec vos outils

Pas besoin de coder pour exploiter l'API. Connectez Make, n8n ou Zapier en 2 minutes via la clé API et déclenchez des scénarios sur les événements webhook FolioDesk.

Make

Compatible

n8n

Compatible

Zapier

Compatible

Code custom

Compatible

Sécurité par défaut

Auth Bearer

Clé hashée SHA-256 en DB, jamais stockée en clair, comparison constant-time.

Rate limit

Headers `X-RateLimit-*` standards. Plan Pro : 1000 req/h, plan Agence : 10k/h.

Webhooks signés

HMAC-SHA256 sur chaque payload. Vérifiez avec votre secret avant traitement.

Prêt à automatiser ?

Créez votre première clé API en 30 secondes depuis votre dashboard. Documentation interactive Scalar pour tester chaque endpoint en live.

DocumentationCréer une cléChangelog