L'API Kompta

Compte

• GET/me

  Entreprise, abonnement et droits de la clé. Idéal pour tester une clé.

Clients

• GET/clients

  Liste des clients, du plus récent au plus ancien.

  Paramètres : limit, offset, q (nom ou email)

• GET/clients/{id}

  Un client.

• POST/clientsclé « Lecture et création »

  Crée une fiche client.

Devis

• GET/quotes

  Liste des devis, par date de devis décroissante.

  Paramètres : limit, offset, status, from, to, client_id

• GET/quotes/{id}

  Un devis, avec ses lignes.

• POST/quotesclé « Lecture et création »

  Crée un devis en brouillon.

Factures clients

• GET/invoices

  Liste des factures clients, par date de facture décroissante.

  Paramètres : limit, offset, status, from, to, client_id

• GET/invoices/{id}

  Une facture client, avec ses lignes.

• GET/invoices/{id}/pdf

  Le PDF Factur-X de la facture, identique à celui de l'application.

• POST/invoicesclé « Lecture et création »

  Crée une facture en brouillon.

Factures fournisseurs

• GET/supplier-invoices

  Liste des factures fournisseurs (achats).

  Paramètres : limit, offset, from, to

• GET/supplier-invoices/{id}

  Une facture fournisseur.

Prospects

• GET/prospects

  Pipeline commercial, hors prospects archivés.

  Paramètres : limit, offset, stage, q, archived

• GET/prospects/{id}

  Un prospect.

• POST/prospectsclé « Lecture et création »

  Ajoute un prospect à l'étape « nouveau » (ex. formulaire de votre site).

Catalogue

• GET/catalog-items

  Articles et ouvrages du catalogue.

  Paramètres : limit, offset, q

• GET/catalog-items/{id}

  Un article.

• POST/catalog-itemsclé « Lecture et création »

  Ajoute un article simple.

Webhooks

• GET/webhooks

  Adresses abonnées aux événements (sans leur secret).

• POST/webhooksclé « Lecture et création »

  Abonne une adresse à des événements. Le secret de signature n'est renvoyé qu'ici.

• DELETE/webhooks/{id}clé « Lecture et création »

  Désabonne une adresse.

Événements

• quote.signed : devis signé par le client.
• quote.refused : devis refusé par le client.
• invoice.paid : facture payée.
• prospect.created : nouveau prospect (site vitrine, saisie manuelle, API).

Ajoutez une adresse dans Kompta (Plus d'outils → API) ou par POST /webhooks. Le bouton « Tester » envoie un événement ping.

Contenu envoyé

L'objet concerné, avec les mêmes champs que l'API. Les en-têtes Kompta-Event, Kompta-Event-Id et Kompta-Signature accompagnent chaque envoi.

Kompta-Event: quote.signed
Kompta-Event-Id: 0f6b1c7e-…
Kompta-Signature: t=1762700000,v1=5f2c…

{
  "id": "0f6b1c7e-…",
  "type": "quote.signed",
  "created_at": "2026-11-09T14:12:03.120Z",
  "data": {
    "object": {
      "id": "9b2e…",
      "quote_number": "DEV-2026-00042",
      "status": "accepted",
      "amount_ttc": 778.8,
      "signed_at": "2026-11-09T14:12:02.884Z",
      "client": { "id": "3c1f…", "name": "MARTIN Julie" },
      …
    }
  }
}

Vérifier la signature

Kompta-Signature: t=…,v1=… : v1 est le HMAC-SHA256, avec le secret de l'adresse (whsec_…), de t + "." + corps brut. Refusez une signature fausse ou trop ancienne.

import crypto from "node:crypto";

// rawBody : le corps EXACT reçu (texte), avant tout JSON.parse.
function verifyKomptaSignature(rawBody, header, secret) {
  const parts = Object.fromEntries(header.split(",").map((p) => p.split("=")));
  const expected = crypto
    .createHmac("sha256", secret)
    .update(`${parts.t}.${rawBody}`)
    .digest("hex");
  const fresh = Math.abs(Date.now() / 1000 - Number(parts.t)) < 300;
  const a = Buffer.from(expected);
  const b = Buffer.from(parts.v1 ?? "");
  return fresh && a.length === b.length && crypto.timingSafeEqual(a, b);
}

Réponse et nouvelles tentatives

Répondez par un code 2xx en moins de 10 secondes. Sinon, Kompta réessaie après 1 min, 5 min, 30 min, 2 h, 6 h puis 24 h. Les redirections ne sont pas suivies. Après 30 échecs d'affilée, l'adresse est désactivée : vous la réactivez en un clic dans Kompta. Un même événement peut arriver deux fois : dédoublonnez sur Kompta-Event-Id.

Avec Zapier ou Make

Sans écrire de code : créez un déclencheur « Webhooks by Zapier → Catch Hook » ou, dans Make, un module « Webhooks → Custom webhook », puis collez l'adresse obtenue dans Kompta. Pour les actions (créer un client, un devis…), utilisez le module HTTP avec votre clé API.

Avec votre compte Kompta (recommandé)

Dans Claude ou un autre assistant compatible, ajoutez un connecteur personnalisé avec l'adresse https://kompta.pro/api/mcp. L'assistant vous envoie sur Kompta : vous vous connectez, choisissez « Lecture » ou « Lecture et brouillons », puis cliquez sur « Autoriser ». Aucune clé à copier ; vous coupez l'accès quand vous voulez depuis Plus d'outils → API.

Fonctionne avec Claude, ChatGPT (connecteurs personnalisés) et Cursor. Ajouter à Cursor en un clic.

Pour les développeurs : OAuth 2.1 avec PKCE (S256) et enregistrement dynamique des clients. Métadonnées sur /.well-known/oauth-protected-resource et /.well-known/oauth-authorization-server.

Avec une clé API

Pour les outils qui acceptent un en-tête : Authorization: Bearer kpt_…. Une clé en lecture seule ne donne accès qu'aux questions ; une clé « Lecture et création » permet aussi de préparer des brouillons, jamais de les envoyer.

claude mcp add --transport http kompta https://kompta.pro/api/mcp \
  --header "Authorization: Bearer kpt_votre_cle"

{
  "mcpServers": {
    "kompta": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://kompta.pro/api/mcp",
               "--header", "Authorization: Bearer kpt_votre_cle"]
    }
  }
}