Documentation de l'API
Vos contacts, vos tables, vos rendez-vous, vos formulaires, vos contrats et vos ventes, lisibles et modifiables par vos outils. 28 adresses, 11 événements de webhook, et une clé qui se crée en deux clics dans Intégrations.
Commencer
Une clé porte sur UN espace. Elle se crée dans Kapacity, page Intégrations, onglet API, par le propriétaire ou un administrateur. Elle n'est lisible qu'une fois : copiez-la tout de suite.
GET https://kapacity.app/api/v1/w/{workspace_id}/me
Authorization: Bearer kap_live_…Si cet appel répond 200, votre clé et votre identifiant d'espace sont bons : c'est le premier appel à faire quand on branche une intégration.
Dans n8n ou Make : l'adresse de Kapacity seule
Le node n8n et l'app Make demandent une clé, l'identifiant de l'espace et, pour n8n, une adresse de base (Base URL) : mettez l'adresse de Kapacity seule, https://kapacity.app, sans rien après. L'outil ajoute lui-même /api/v1/w/{workspace_id} ; collée dans la Base URL, l'adresse complète serait doublée, et l'API répondrait 400 adresse_de_base, avec ce qu'il faut corriger. L'adresse complète ci-dessus sert à une requête écrite à la main (un nœud « HTTP Request », votre propre code).
Deux portées, et rien d'autre
- Lecture seule : toutes les lectures. Une écriture reçoit 403.
- Lecture et écriture : les lectures et les écritures.
Donnez à chaque outil la portée dont il a besoin : un tableau de bord qui ne fait que lire n'a aucune raison de pouvoir supprimer un contact.
Quotas
Trois limites, comptées sur l'espace, toutes méthodes confondues : par mois (selon le plan), par seconde et par heure. Chaque réponse porte les en-têtes X-Kapacity-Quota-Limit, X-Kapacity-Quota-Remaining et X-Kapacity-Quota-Reset. Un dépassement répond 429, avec Retry-After en secondes : attendez ce délai, puis réessayez.
Lire un exemple de requête
Chaque adresse ci-dessous montre la requête à envoyer, puis la réponse que Kapacity rend. Par exemple, pour envoyer un contrat :
POST https://kapacity.app/api/v1/w/{workspace_id}/contracts
Authorization: Bearer kap_live_…
Content-Type: application/json
Idempotency-Key: contrat-jean-dupont-2026-09-23
{
"modele_id": "3e5a7c9b-2d4f-4e6a-8b1c-9d0e2f4a6b8c",
"contact_id": "7fc74cfb-c67a-43d2-868f-f4a8ab028475",
"montant_cents": 450000
}- La PREMIÈRE ligne donne la méthode puis l'adresse complète. GET lit, POST crée ou envoie, PATCH modifie, DELETE supprime.
- Les lignes suivantes sont les EN-TÊTES. « Authorization: Bearer <votre clé> » est toujours là ; « Content-Type: application/json » l'accompagne dès qu'il y a un body.
- Après la ligne vide vient le BODY JSON : c'est là que se mettent les valeurs marquées « dans le body JSON » dans le tableau des paramètres. Une requête GET n'a pas de body : ses options vont après le « ? » de l'adresse.
- Les identifiants des exemples (les longues suites de chiffres et de lettres) sont des EXEMPLES : remplacez-les par les vôtres, que les autres adresses vous donnent. « {workspace_id} » est l'identifiant de votre espace, affiché dans Intégrations, onglet API.
- Les montants sont en CENTIMES : 450000 = 4 500 €.
- Dans n8n : un nœud « HTTP Request », la méthode et l'adresse de la première ligne, l'en-tête Authorization (ou « Header Auth »), et pour un POST ou un PATCH, « Send Body » en JSON avec le body de l'exemple.
Pas à pas
Les parcours les plus demandés, appel par appel, dans l'ordre.
Envoyer un contrat à un contact
Un deal est gagné dans votre outil : le contrat part au client, au bon montant, et vous récupérez son lien de signature.
- 1Trouver le modèle de contratGET
/contract-templatesListez vos modèles et repérez celui à envoyer. À faire une seule fois : un modèle garde son identifiant, vous pouvez le recopier dans votre scénario.
GET https://kapacity.app/api/v1/w/{workspace_id}/contract-templates Authorization: Bearer kap_live_…À GARDER Le « id » du modèle : c'est votre « modele_id ».
- 2Trouver le contactGET
/tables/leads/recordsCherchez le contact par son e-mail dans Mon Pipe (« leads ») ou dans Setting (« leads_setting »). S'il n'existe pas encore, créez-le avec POST /tables/leads/records : sa réponse donne aussi son identifiant.
GET https://kapacity.app/api/v1/w/{workspace_id}/tables/leads/records?filtre=Email:eq:jean@acme.fr Authorization: Bearer kap_live_…À GARDER Le « id » de la première ligne de « lignes » : c'est votre « contact_id ». Si « lignes » est vide, aucun contact n'a cet e-mail.
- 3Envoyer le contratPOST
/contractsEnvoyez le modèle au contact, avec le montant en CENTIMES (450000 = 4 500 €). Le contrat est rempli avec les informations du contact, et l'e-mail rattaché au modèle part avec le lien pour signer.
POST https://kapacity.app/api/v1/w/{workspace_id}/contracts Authorization: Bearer kap_live_… Content-Type: application/json Idempotency-Key: contrat-jean-dupont-2026-09-23 { "modele_id": "3e5a7c9b-2d4f-4e6a-8b1c-9d0e2f4a6b8c", "contact_id": "7fc74cfb-c67a-43d2-868f-f4a8ab028475", "montant_cents": 450000 }À GARDER « contrat.lien_signature » (la page où le contact signe) et « email.envoye » (true si l'e-mail est parti ; sinon « email.raison » dit pourquoi).
Être prévenu quand un contrat est signé
Déclencher la suite (facture, accès à la formation, message à l'équipe) au moment où le client signe, sans interroger l'API en boucle.
- 1Donner à Kapacity l'adresse à appelerPOST
/webhooksAbonnez une adresse à l'événement « contrat.signe ». Dans n8n, c'est l'adresse de production d'un nœud Webhook. À faire une seule fois.
POST https://kapacity.app/api/v1/w/{workspace_id}/webhooks Authorization: Bearer kap_live_… Content-Type: application/json { "nom": "Relance après signature", "url": "https://n8n.exemple.fr/webhook/abc", "evenements": [ "contrat.signe" ], "entete": { "nom": "X-Api-Key", "valeur": "une-valeur-que-vous-choisissez" }, "ignorer_api": true }À GARDER Le « secret » : il n'est montré qu'une fois, et sert à vérifier que l'appel vient bien de Kapacity.
- 2Recevoir la signatureWEBHOOK
contrat.signeÀ chaque signature, Kapacity appelle votre adresse avec ce corps. « objet » est le contrat signé, « contact » est le contact qui l'a signé.
{ "evenement": "contrat.signe", "emis_le": "2026-09-22T14:20:00.000Z", "provenance": "visiteur", "table": "contracts", "objet": { "id": "c1…", "champs": { "lead_id": "l1…", "title": "Accompagnement 6 mois", "status": "signe", "value_cents": 500000, "signer_email": "jean@acme.test", "signed_at": "2026-09-22T14:20:00.000Z" } }, "contact": { "id": "l1…", "champs": { "first_name": "Jean", "last_name": "Dupont", "email": "jean@acme.test", "stage": "contrat_signe" } } }À GARDER « objet.id » (le contrat), « objet.champs.value_cents » (le montant, en centimes) et « contact.champs.email ».
Les adresses
Toutes commencent par https://kapacity.app/api/v1/w/{workspace_id}. Cliquez sur une adresse pour voir ses paramètres, un exemple de requête et un exemple de réponse.
Votre espace
GET/meVotre espace, votre plan et l'état de votre quota.
Le premier appel à faire quand on branche une intégration : il confirme que la clé fonctionne, sur quel espace elle porte, et combien d'appels il reste ce mois-ci.
CLÉ : LECTURE SEULE SUFFIT
| paramètre | où le mettre | obligatoire | description |
|---|---|---|---|
workspace_id | dans l'adresse | oui | L'identifiant de votre espace, affiché dans Intégrations, onglet API. (ex. b7f1c0de-0000-4000-8000-000000000000) |
- Aucun paramètre : si cet appel répond 200, votre clé et votre identifiant d'espace sont bons.
- Les en-têtes X-Kapacity-Quota-* accompagnent CHAQUE réponse de l'API, pas seulement celle-ci.
- « plan » est l'identifiant technique du plan, « plan_libelle » son nom tel qu'il s'affiche : starter = « Pro », pro = « Entreprise », custom = « Sur mesure ». Pour en parler à quelqu'un, utilisez « plan_libelle ».
- « membre » : la personne au nom de qui agit un assistant IA connecté (Claude, ChatGPT), avec ses rôles. Il ne voit et ne fait alors que ce que ce rôle permet dans Kapacity (mêmes leads, mêmes droits). Une clé d'API de l'espace (n8n, Make) rend « membre »: null : elle agit pour l'espace entier.
GET https://kapacity.app/api/v1/w/{workspace_id}/me
Authorization: Bearer kap_live_…{
"espace": {
"id": "b7f1c0de-0000-4000-8000-000000000000",
"nom": "Top Closer Academy",
"plan": "free",
"plan_libelle": "Gratuit"
},
"cle": {
"nom": "n8n",
"portee": "lecture_ecriture",
"proprietaire": true
},
"membre": null,
"quota": {
"mois": 12,
"limite_mois": 10000,
"restant_mois": 9988,
"reset_mois": "2026-10-01T00:00:00.000Z"
}
}CRM : tables et lignes
GET/tablesLes tables du CRM de cet espace, et la base de chacune.
Le deuxième appel d'une intégration, après /me : il donne les identifiants de table dont tout le reste a besoin.
CLÉ : LECTURE SEULE SUFFIT
- DEUX SORTES DE TABLES. Les tables « native » sont vos pipelines : « leads » = Mon Pipe, « leads_setting » = Setting. Leur identifiant est ce mot, pas un UUID.
- Les tables « personnalisee » sont celles que votre équipe a créées (Ventes, Setting, Ressources…), identifiées par un UUID.
- Les deux s'utilisent EXACTEMENT de la même façon par la suite : mêmes adresses, mêmes réponses.
- Une table « synchronisee » reprend les lignes et les colonnes d'une source (« source » : un pipeline ou une autre table), tenues à jour par Kapacity. Ses lignes ne se créent ni ne se suppriment par l'API (elles viennent de la source), ses colonnes reprises sont « lecture_seule » : seules ses colonnes propres s'écrivent.
- On ne crée ni table ni colonne par API : cette partie du CRM se lit, elle ne se façonne pas.
- « lignes » donne le nombre de lignes de CHAQUE table, native ou non : inutile de lire une table pour la compter.
GET https://kapacity.app/api/v1/w/{workspace_id}/tables
Authorization: Bearer kap_live_…{
"tables": [
{
"id": "leads",
"nom": "Leads",
"type": "native",
"base": "pipe",
"base_libelle": "Mon Pipe",
"icone": null,
"lignes": 42
},
{
"id": "leads_setting",
"nom": "Leads Setting",
"type": "native",
"base": "setting",
"base_libelle": "Setting",
"icone": null,
"lignes": 8
},
{
"id": "6b0c…",
"nom": "Ventes",
"type": "personnalisee",
"base": "ventes",
"base_libelle": "Mes Ventes",
"icone": "card",
"lignes": 128,
"creee_le": "2026-09-01T09:12:00.000Z"
},
{
"id": "9d2e…",
"nom": "Membres",
"type": "synchronisee",
"source": {
"id": "leads",
"nom": "Leads"
},
"base": "pipe",
"base_libelle": "Mon Pipe",
"icone": null,
"lignes": 42,
"creee_le": "2026-10-08T10:00:00.000Z"
}
],
"bases": [
{
"id": "pipe",
"libelle": "Mon Pipe"
}
]
}GET/tables/{id}Les colonnes d'une table : identifiant, nom, type, choix possibles.
CLÉ : LECTURE SEULE SUFFIT
| paramètre | où le mettre | obligatoire | description |
|---|---|---|---|
id | dans l'adresse | oui | L'identifiant de la table, rendu par GET /tables : un UUID, ou « leads » / « leads_setting » pour vos pipelines. |
- L'erreur numéro un d'une intégration : dans Kapacity, une colonne est identifiée par un UUID, pas par son nom.
- On PEUT écrire par le nom (l'API le résout, sans tenir compte des accents, de la casse ni de la ponctuation), mais un outil sûr de lui relève d'abord ces identifiants.
- Une colonne « lecture_seule » (formule, cumul, lookup, ou colonne reprise d'une table synchronisée) est refusée en écriture, et l'API dit pourquoi.
- Une option « par_defaut » d'une sélection est posée sur chaque nouvelle ligne créée sans valeur dans cette colonne (par l'API comme ailleurs).
- Une sélection marquée « options_libres » accepte une réponse absente de sa liste : elle y devient une nouvelle option (80 caractères, 200 options au plus). Sans cette marque, une réponse inconnue est écartée et expliquée dans « ignores ».
GET https://kapacity.app/api/v1/w/{workspace_id}/tables/leads
Authorization: Bearer kap_live_…{
"table": {
"id": "6b0c…",
"nom": "Mes Ventes",
"base": "ventes",
"icone": "card",
"lignes": 128
},
"colonnes": [
{
"id": "f1a2…",
"nom": "Client",
"type": "texte",
"lecture_seule": false
},
{
"id": "f3b4…",
"nom": "Montant",
"type": "monetaire",
"lecture_seule": false
},
{
"id": "f5c6…",
"nom": "Statut",
"type": "selection",
"lecture_seule": false,
"options": [
{
"id": "o1",
"libelle": "Signé"
},
{
"id": "o2",
"libelle": "À relancer",
"par_defaut": true
}
]
}
]
}GET/tables/{id}/recordsLes lignes d'une table, page par page.
CLÉ : LECTURE SEULE SUFFIT
| paramètre | où le mettre | obligatoire | description |
|---|---|---|---|
id | dans l'adresse | oui | L'identifiant de la table (UUID, ou « leads » / « leads_setting »). |
limite | après le « ? » de l'adresse | non | De 1 à 200. 50 par défaut. (ex. 100) |
curseur | après le « ? » de l'adresse | non | Le « curseur_suivant » de la réponse précédente. |
modifie_depuis | après le « ? » de l'adresse | non | Ne rend que les lignes modifiées depuis cette date (ISO 8601). (ex. 2026-09-01T00:00:00Z) |
filtre | après le « ? » de l'adresse | non | Cherche une ligne : « colonne:operateur:valeur ». Répétable, les conditions se cumulent en ET. Opérateurs : eq, ne, contient, commence, gt, gte, lt, lte, vide, non_vide. L'opérateur est facultatif et vaut eq. (ex. Email:eq:jean@acme.fr) |
recherche | après le « ? » de l'adresse | non | Cherche ce texte dans toutes les colonnes de texte de la table (et, pour un contact, son nom, son e-mail, sa société et son téléphone). (ex. Dupont) |
champ | après le « ? » de l'adresse | non | Forme simple, équivalente à filtre=<champ>:eq:<vaut>. (ex. Statut) |
vaut | après le « ? » de l'adresse | non | La valeur exacte attendue par « champ ». |
colonnes | après le « ? » de l'adresse | non | Ajoute le catalogue des colonnes à la réponse. Absent par défaut : il est long, et GET /tables/{id} le donne une fois pour toutes. (ex. 1) |
format | après le « ? » de l'adresse | non | « lisible » pour des valeurs prêtes à lire : un montant en EUROS au lieu de centimes, une sélection par son LIBELLÉ, un membre par son NOM. Vaut aussi en écriture (un montant s'écrit alors en euros) et dans un filtre (montant en euros, sélection par son libellé). Absent : les valeurs brutes, comme avant. (ex. lisible) |
- Les lignes sortent de la plus ANCIENNE à la plus récente : c'est ce qui rend une synchronisation reprenable.
- Pagination par CURSEUR, jamais par numéro de page : une ligne créée entre deux appels ne fait sauter personne.
- Tant que « curseur_suivant » n'est pas null, il reste des lignes.
- Les valeurs sont BRUTES : un montant est en CENTIMES, une sélection est l'identifiant de son option. Avec « format=lisible » : euros, libellés et noms des membres.
- CHERCHER UNE LIGNE : filtre=Email:eq:jean@acme.fr. Plusieurs « filtre » se cumulent en ET. Un montant se compare en CENTIMES (filtre=Montant:gt:100000).
- Pour une SÉLECTION, filtrez par l'identifiant de l'option (rendu par GET /tables/{id}). Avec « format=lisible », par son libellé, et un montant en euros (filtre=Montant:gt:1000).
- Pour chercher sans savoir dans quelle colonne : recherche=Dupont.
- Le nom d'une colonne se donne comme on veut : « E-mail », « Email » et « email » désignent la même. Accents, casse et ponctuation sont ignorés.
GET https://kapacity.app/api/v1/w/{workspace_id}/tables/leads/records?filtre=Email:eq:jean@acme.fr
Authorization: Bearer kap_live_…{
"lignes": [
{
"id": "a1b2…",
"cree_le": "2026-09-02T10:00:00.000Z",
"modifie_le": "2026-09-20T14:31:00.000Z",
"champs": {
"f1a2…": "Acme",
"f3b4…": 350000
}
}
],
"curseur_suivant": "MjAyNi0wOS0wMlQxMDowMDowMC4wMDBafGExYjI"
}POST/tables/{id}/recordsCrée une ligne dans une table.
CLÉ : LECTURE ET ÉCRITURE
| paramètre | où le mettre | obligatoire | description |
|---|---|---|---|
id | dans l'adresse | oui | L'identifiant de la table (UUID, ou « leads » / « leads_setting »). |
champs | dans le body JSON | oui | Les valeurs, rangées par NOM ou par identifiant de colonne. (ex. { "Client": "Acme", "Montant": 350000 }) |
automatisations | après le « ? » de l'adresse | non | false pour écrire SANS déclencher les automatisations. Le garde-fou anti-boucle à utiliser pour un import en masse. (ex. false) |
format | après le « ? » de l'adresse | non | « lisible » pour des valeurs prêtes à lire : un montant en EUROS au lieu de centimes, une sélection par son LIBELLÉ, un membre par son NOM. Vaut aussi en écriture (un montant s'écrit alors en euros) et dans un filtre (montant en euros, sélection par son libellé). Absent : les valeurs brutes, comme avant. (ex. lisible) |
- Une valeur invalide est IGNORÉE et expliquée dans « ignores », jamais convertie en effacement.
- Sélection marquée « options_libres » (GET /tables/{id}) : un libellé absent de la liste y devient une nouvelle option, au lieu d'être ignoré.
- Si AUCUNE valeur n'a pu être écrite, l'appel est refusé en 422 plutôt que de créer une ligne vide.
- Une création déclenche les automatisations « Quand un enregistrement est créé », comme une saisie à la main.
- Dans « leads » ou « leads_setting », un contact a besoin d'au moins un « Prénom », un « Nom », un « E-mail » ou un « Téléphone » : sans aucun des quatre, l'appel est refusé plutôt que de créer un contact « Sans nom ». Sans prénom ni nom, son e-mail (sinon son téléphone) sert de nom affiché.
POST https://kapacity.app/api/v1/w/{workspace_id}/tables/leads/records
Authorization: Bearer kap_live_…
Content-Type: application/json
{
"champs": {
"Prénom": "Jean",
"Nom": "Dupont",
"Email": "jean@acme.fr"
}
}{
"ligne": {
"id": "a1b2…",
"cree_le": "2026-09-22T10:00:00.000Z",
"modifie_le": null,
"champs": {
"f1a2…": "Acme"
}
}
}POST/tables/{id}/records/bulkCréer jusqu'à 100 lignes en un seul appel.
Sans lui, importer 500 contacts coûte 500 appels, soit 5 % du quota mensuel d'un espace gratuit pour un seul import. Avec lui, cinq appels.
CLÉ : LECTURE ET ÉCRITURE
| paramètre | où le mettre | obligatoire | description |
|---|---|---|---|
id | dans l'adresse | oui | L'identifiant de la table, ou « leads » / « leads_setting ». |
lignes | dans le body JSON | oui | Jusqu'à 100 objets { champs: { … } }. (ex. [{ "champs": { "Prénom": "Jean" } }]) |
automatisations | après le « ? » de l'adresse | non | 1 pour déclencher les automatisations. COUPÉ par défaut ici. |
format | après le « ? » de l'adresse | non | « lisible » pour des valeurs prêtes à lire : un montant en EUROS au lieu de centimes, une sélection par son LIBELLÉ, un membre par son NOM. Vaut aussi en écriture (un montant s'écrit alors en euros) et dans un filtre (montant en euros, sélection par son libellé). Absent : les valeurs brutes, comme avant. (ex. lisible) |
Idempotency-Key | en en-tête | non | Rejouer le même appel rend la réponse du premier au lieu de créer des doublons. |
- Une ligne refusée n'arrête PAS les autres : chaque entrée rend son sort dans « resultats », avec son rang. Un import de 500 lignes qui s'arrête à la 37e est un import à refaire à la main.
- Les automatisations sont COUPÉES par défaut, contrairement à l'écriture à l'unité : 100 lignes importées, ce serait 100 séquences d'e-mails envoyées à des gens qui viennent d'être importés. « ?automatisations=1 » les rallume.
- 201 dès qu'une ligne est passée, 422 si tout a été refusé : on peut aiguiller sur le code sans lire le détail.
- Posez un « Idempotency-Key » : si le réseau coupe avant la réponse, le rejeu rend le résultat du premier appel. La réponse rejouée porte l'en-tête X-Kapacity-Idempotent-Replay.
POST https://kapacity.app/api/v1/w/{workspace_id}/tables/leads/records/bulk
Authorization: Bearer kap_live_…
Content-Type: application/json
Idempotency-Key: import-salon-2026-lot-1
{
"lignes": [
{
"champs": {
"Prénom": "Jean",
"Nom": "Dupont",
"Email": "jean@acme.fr"
}
},
{
"champs": {
"Prénom": "Léa",
"Nom": "Martin",
"Email": "lea@acme.fr"
}
}
]
}{
"creees": 2,
"refusees": 1,
"automatisations": false,
"resultats": [
{
"i": 0,
"ok": true,
"id": "l1…"
},
{
"i": 1,
"ok": true,
"id": "l2…"
},
{
"i": 2,
"ok": false,
"erreur": "Aucune valeur n'a pu être écrite."
}
],
"lignes": []
}GET/records/{id}Une ligne et les colonnes de sa table.
CLÉ : LECTURE SEULE SUFFIT
| paramètre | où le mettre | obligatoire | description |
|---|---|---|---|
id | dans l'adresse | oui | L'identifiant de la ligne. |
format | après le « ? » de l'adresse | non | « lisible » pour des valeurs prêtes à lire : un montant en EUROS au lieu de centimes, une sélection par son LIBELLÉ, un membre par son NOM. Vaut aussi en écriture (un montant s'écrit alors en euros) et dans un filtre (montant en euros, sélection par son libellé). Absent : les valeurs brutes, comme avant. (ex. lisible) |
- La ligne porte sa table : l'adresse n'a pas besoin de la répéter.
GET https://kapacity.app/api/v1/w/{workspace_id}/records/7fc74cfb-c67a-43d2-868f-f4a8ab028475
Authorization: Bearer kap_live_…{
"ligne": {
"id": "a1b2…",
"cree_le": "2026-09-02T10:00:00.000Z",
"modifie_le": null,
"champs": {
"f1a2…": "Acme"
}
},
"table": {
"id": "6b0c…",
"nom": "Mes Ventes"
},
"colonnes": [
{
"id": "f1a2…",
"nom": "Client",
"type": "texte",
"lecture_seule": false
}
]
}PATCH/records/{id}Modifie les valeurs d'une ligne, ou fait passer un contact de Setting à Mon Pipe (et l'inverse).
CLÉ : LECTURE ET ÉCRITURE
| paramètre | où le mettre | obligatoire | description |
|---|---|---|---|
id | dans l'adresse | oui | L'identifiant de la ligne. |
champs | dans le body JSON | oui | Seules les colonnes citées changent, les autres restent. Facultatif quand « base » est donnée. |
base | dans le body JSON | non | Contacts seulement : la base où mettre le contact, « leads » (Mon Pipe) ou « leads_setting » (Setting). « Mon Pipe », « Setting », « pipe » sont compris aussi. (ex. leads) |
automatisations | après le « ? » de l'adresse | non | false pour ne rien déclencher. |
format | après le « ? » de l'adresse | non | « lisible » pour des valeurs prêtes à lire : un montant en EUROS au lieu de centimes, une sélection par son LIBELLÉ, un membre par son NOM. Vaut aussi en écriture (un montant s'écrit alors en euros) et dans un filtre (montant en euros, sélection par son libellé). Absent : les valeurs brutes, comme avant. (ex. lisible) |
- Pour VIDER une colonne, envoyez null (ou une chaîne vide, ou une liste vide).
- Une modification déclenche les automatisations « Quand un enregistrement est modifié ».
- Passer un contact de Mon Pipe au statut « Closé » fait ce que fait la fiche : sa « Date Closing » est remplie (si elle est vide et que l'appel n'en donne pas une) et sa vente est créée dans Mes Ventes, une seule fois par contact, avec son « Prix de vente » (renseignez-le AVANT ou DANS le même appel) et le produit choisi dans sa fiche s'il y en a un. Le produit d'un contact ne s'écrit pas par l'API : il se complète ensuite sur la ligne de la vente, dans la table Ventes. Vaut aussi pour un contact créé directement « Closé ».
- Table Ventes : le produit choisi remplit « Prix HT », « TVA » et « Prix vendu TTC » comme à l'écran (un prix négocié reste) ; « Encaissé » et « Source » sont en lecture seule (l'Encaissé suit les paiements reçus, la Source suit le contact). « Soldé » ou « Remboursé » écrits dans « Statut paiement » changent le statut SEULEMENT : par l'API, ils ne créent ni ne remboursent d'encaissement (à l'écran, un administrateur qui pose « Soldé » enregistre le reste dû, et « Remboursé » rembourse les paiements de la vente).
- CHANGER UN CONTACT DE BASE : « base »: « leads » le passe dans Mon Pipe, « leads_setting » le ramène dans Setting, comme le menu « Base » de sa fiche. C'est le même contact (même identifiant, ses rendez-vous, réponses et contrats le suivent) ; son statut prend celui par défaut de la base d'arrivée (« Nouveau » ou « Optin »), sauf si « champs » en donne un de cette base. Passé dans Mon Pipe, il reste visible dans Setting, en vert, avec la mention « Passé dans Mon Pipe ».
- Dans Setting, un statut coché « Mon Pipe » (« RDV planifié » par défaut, réglé dans « Modifier la colonne » de Statut) fait passer le contact dans Mon Pipe, au statut « RDV programmé », comme à l'écran : « table » dans la réponse le dit. Vaut aussi pour un contact créé dans Setting avec ce statut.
- Après un changement de base, ce sont les automatisations de la base d'ARRIVÉE qui se déclenchent, et « table » dans la réponse (comme dans le webhook « contact.modifie ») dit où est le contact. Un contact déjà dans la base demandée revient tel quel, sans erreur.
PATCH https://kapacity.app/api/v1/w/{workspace_id}/records/04f4693e-6000-4cd2-99cc-cf67fa8df7ca
Authorization: Bearer kap_live_…
Content-Type: application/json
{
"base": "leads",
"champs": {
"Notes Setter": "RDV calé avec le closer"
}
}{
"ligne": {
"id": "04f4…",
"cree_le": "2026-10-19T08:18:31.352627+00:00",
"modifie_le": "2026-10-19T08:18:54.733302+00:00",
"champs": {
"first_name": "Léa",
"last_name": "Setting",
"email": "lea@example.com",
"status_id": "39df…",
"setter_notes": "RDV calé avec le closer"
}
},
"table": {
"id": "leads",
"nom": "Leads",
"type": "native"
}
}DELETE/records/{id}Supprime une ligne. Définitif.
CLÉ : LECTURE ET ÉCRITURE
| paramètre | où le mettre | obligatoire | description |
|---|---|---|---|
id | dans l'adresse | oui | L'identifiant de la ligne. |
- Aucune corbeille : la ligne est perdue. Le journal d'activité garde la trace de la suppression et de la clé qui l'a faite.
DELETE https://kapacity.app/api/v1/w/{workspace_id}/records/a1b2c3d4-5e6f-4a7b-8c9d-0e1f2a3b4c5d
Authorization: Bearer kap_live_…{
"supprime": true,
"id": "a1b2…"
}Rendez-vous
GET/event-typesLes types de rendez-vous, avec leur lien public de réservation.
CLÉ : LECTURE SEULE SUFFIT
- Envoyez le « lien_public » à votre prospect : il choisit son créneau, et le rendez-vous, le contact et l'invitation d'agenda se créent tout seuls.
- Poser un rendez-vous directement par API n'existe pas : le round-robin, les disponibilités et l'anti-double-réservation se décident côté Kapacity.
- « note » est la note pour l'équipe écrite sur le type (par exemple le canal d'où viennent ses prospects) : elle n'est jamais montrée au prospect. Vide quand rien n'est écrit.
- « paiement » vaut null pour un rendez-vous gratuit ; pour un rendez-vous payant à la réservation (Whop), le produit payé et son prix HT en centimes : { produit: { id, nom }, montant_cents }. Le contact choisit son créneau puis paie ; le rendez-vous n'est confirmé qu'au paiement.
- « parts » donne la répartition voulue entre les assignés de même priorité, en pourcentage (somme 100 pour chaque niveau de priorité) : c'est le réglage du type, pas ce qui a été reçu.
- « priorites » donne le niveau de chaque assigné, de 1 à 5 (5 la plus haute, 3 quand rien n'est réglé) : sur un créneau, les assignés libres du niveau le plus haut reçoivent tous les rendez-vous, et un niveau plus bas ne prend le relais que lorsque tous ceux du dessus sont pris. Vide quand le type tourne par équipe.
- « repartition » dit comment l'équipe tourne : « tour » (chacun son tour), « charge » (le moins chargé, en suivant les parts) ou « hasard » (tirage au sort pondéré par les parts, « Par % de chance » à l'écran).
- « attribution_par » vaut « equipes » quand le type tourne par équipe : « equipes » donne alors chaque équipe cochée, sa « part » en pourcentage (somme 100) et ses « membres » actuels, « assignes » tous ces membres, et « parts » (par membre) reste vide. Un rendez-vous part d'abord à une équipe selon sa part, puis à l'un de ses membres libres, à parts égales.
GET https://kapacity.app/api/v1/w/{workspace_id}/event-types
Authorization: Bearer kap_live_…{
"types_de_rendez_vous": [
{
"id": "e1f2…",
"nom": "Appel de qualification",
"note": "Insta Organique",
"paiement": null,
"duree_min": 30,
"lieu": "Google Meet",
"attribution": "round_robin",
"attribution_par": "membres",
"repartition": "charge",
"repartition_libelle": "Le moins chargé",
"creneaux_membre_designe": false,
"assignes": [
"u1…",
"u2…",
"u3…"
],
"parts": {
"u1…": 67,
"u2…": 33,
"u3…": 100
},
"priorites": {
"u1…": 5,
"u2…": 5,
"u3…": 3
},
"equipes": [],
"actif": true,
"questions": 3,
"lien_public": "https://kapacity.app/b/mon-espace/appel-de-qualification"
}
]
}GET/bookingsLes rendez-vous, du plus ancien au plus récent.
CLÉ : LECTURE SEULE SUFFIT
| paramètre | où le mettre | obligatoire | description |
|---|---|---|---|
depuis | après le « ? » de l'adresse | non | Rendez-vous commençant après cette date. (ex. 2026-09-22T00:00:00Z) |
jusqu_a | après le « ? » de l'adresse | non | Rendez-vous commençant avant cette date. |
statut | après le « ? » de l'adresse | non | Ne garde que ce statut : confirme, annule ou termine. (ex. confirme) |
contact | après le « ? » de l'adresse | non | Ne garde que les rendez-vous de ce contact (son identifiant). |
limite | après le « ? » de l'adresse | non | De 1 à 200. 50 par défaut. |
curseur | après le « ? » de l'adresse | non | Le « curseur_suivant » de la réponse précédente. |
- Chaque identifiant vient avec son nom : un scénario n'a jamais à faire un second appel pour savoir qui est « u1… ».
- « paiement » vaut null pour un rendez-vous gratuit. Payant à la réservation : « attente » (le créneau est retenu le temps du paiement, le rendez-vous n'est pas encore confirmé), « paye », « expire » (non payé à temps : le rendez-vous est annulé), « rembourse » ou « paye_hors_delai » (payé après la libération d'un créneau déjà repris, à replanifier).
- « lien_visio » est le lien de la visio du membre : un lien Google Meet créé avec le rendez-vous, ou son propre lien (Zoom, Teams…).
GET https://kapacity.app/api/v1/w/{workspace_id}/bookings?depuis=2026-09-22T00:00:00Z&statut=confirme
Authorization: Bearer kap_live_…{
"rendez_vous": [
{
"id": "b1c2…",
"debut": "2026-09-23T09:00:00.000Z",
"fin": "2026-09-23T09:30:00.000Z",
"statut": "confirme",
"type": {
"id": "e1f2…",
"nom": "Appel de qualification"
},
"assigne": {
"id": "u1…",
"nom": "Camille Royer"
},
"contact": {
"id": "l1…",
"nom": "Jean Dupont"
},
"invite": {
"nom": "Jean Dupont",
"email": "jean@acme.fr",
"telephone": "+33612345678"
},
"lien_visio": "https://meet.google.com/abc-defg-hij",
"paiement": null
}
],
"curseur_suivant": null
}Formulaires
GET/formsLes formulaires de qualification et leur lien public.
CLÉ : LECTURE SEULE SUFFIT
GET https://kapacity.app/api/v1/w/{workspace_id}/forms
Authorization: Bearer kap_live_…{
"formulaires": [
{
"id": "f1…",
"titre": "Candidature",
"statut": "publie",
"questions": 12,
"lien_public": "https://kapacity.app/f/candidature"
}
]
}GET/forms/{id}/responsesLes réponses d'un formulaire, avec leur score.
CLÉ : LECTURE SEULE SUFFIT
| paramètre | où le mettre | obligatoire | description |
|---|---|---|---|
id | dans l'adresse | oui | L'identifiant du formulaire. |
depuis | après le « ? » de l'adresse | non | Réponses soumises après cette date. |
qualifie | après le « ? » de l'adresse | non | true ou false pour ne garder que les qualifiés ou les non qualifiés. (ex. true) |
limite | après le « ? » de l'adresse | non | De 1 à 200. |
curseur | après le « ? » de l'adresse | non | Le curseur de la page suivante. |
- Les réponses sortent avec le LIBELLÉ de chaque question, pas son identifiant : elles se lisent sans relire le formulaire.
GET https://kapacity.app/api/v1/w/{workspace_id}/forms/f1e2d3c4-b5a6-4978-8695-a4b3c2d1e0f9/responses?qualifie=true
Authorization: Bearer kap_live_…{
"formulaire": {
"id": "f1…",
"titre": "Candidature"
},
"reponses": [
{
"id": "r1…",
"soumise_le": "2026-09-21T18:02:00.000Z",
"score": 86,
"qualifie": true,
"complete": true,
"repondant": {
"nom": "Jean Dupont",
"email": "jean@acme.fr"
},
"contact": {
"id": "l1…",
"nom": "Jean Dupont"
},
"reponses": {
"Votre budget": "Plus de 5 000 €",
"Votre objectif": "Doubler mon chiffre"
}
}
],
"curseur_suivant": null
}Contrats
GET/contractsLes contrats, leur statut et leurs dates clés.
CLÉ : LECTURE SEULE SUFFIT
| paramètre | où le mettre | obligatoire | description |
|---|---|---|---|
depuis | après le « ? » de l'adresse | non | Contrats créés après cette date. |
statut | après le « ? » de l'adresse | non | brouillon, envoye, vu, en_cours (en cours de signature : une personne a signé, pas toutes ; 18 novembre 2026) ou signe. (ex. signe) |
contact | après le « ? » de l'adresse | non | Ne garde que les contrats de ce contact. |
limite | après le « ? » de l'adresse | non | De 1 à 200. |
curseur | après le « ? » de l'adresse | non | Le curseur de la page suivante. |
- Le corps du contrat n'est pas rendu ici, il est long : GET /contracts/{id} le donne.
- Les montants sont en CENTIMES.
- « nb_signataires » et « nb_signes » (18 novembre 2026) : combien de personnes signent ce contrat (le contact compris) et combien ont déjà signé ; « signataire » reste le contact. Le détail de chacun : GET /contracts/{id}, « signataires ».
- « envoye_par » : le membre qui a envoyé le contrat (son identifiant et son nom) ; null pour un contrat envoyé par l'API (la piste d'audit dit alors le nom de la clé) ou envoyé avant le 18 novembre 2026 sans trace de son auteur.
GET https://kapacity.app/api/v1/w/{workspace_id}/contracts?statut=signe
Authorization: Bearer kap_live_…{
"contrats": [
{
"id": "c1…",
"titre": "Accompagnement 6 mois",
"statut": "signe",
"montant_cents": 500000,
"contact": {
"id": "l1…",
"nom": "Jean Dupont"
},
"signataire": {
"nom": "Jean Dupont",
"email": "jean@acme.fr"
},
"nb_signataires": 2,
"nb_signes": 2,
"envoye_le": "2026-09-19T10:00:00.000Z",
"envoye_par": {
"id": "u1…",
"nom": "Sarah Martin"
},
"signe_le": "2026-09-20T08:14:00.000Z"
}
],
"curseur_suivant": null
}GET/contracts/{id}Un contrat, son corps et sa piste d'audit.
CLÉ : LECTURE SEULE SUFFIT
| paramètre | où le mettre | obligatoire | description |
|---|---|---|---|
id | dans l'adresse | oui | L'identifiant du contrat. |
- La piste d'audit est ce qui donne sa valeur probante à la signature : horodatage et adresse IP de chaque étape.
- Elle est en ajout seul en base : l'API la lit, personne ne la réécrit.
- « envoye_par » : le membre qui a envoyé le contrat (son identifiant et son nom), depuis le 18 novembre 2026 ; null pour un envoi par l'API (la piste d'audit dit alors le nom de la clé).
- Depuis le 18 novembre 2026, le « detail » de l'étape « signe » porte le texte du consentement coché (« consentement ») et, si le signataire a corrigé son nom, l'ancien et le nouveau (« nom_envoye », « nom_signe ») ; l'e-mail du signataire est celui du contrat envoyé.
- « signataires » (18 novembre 2026) : chaque personne qui signe, le contact d'abord (« role »: « client »), avec son rôle dans le modèle (une personne ajoutée à l'envoi : « sup1 », « sup2 »…), son statut (attente, vu, signe), ses dates et SON lien de signature (null pour un brouillon, et pour une clé en lecture seule : le lien permet de signer à la place de la personne). Le contrat est « en_cours » quand une personne a signé et pas toutes, « signe » quand la dernière a signé : il est alors scellé, et « contrat.signe » part. L'adresse IP de chacun est dans la piste d'audit, étape par étape.
- « relances » et « derniere_relance_le » (lot 4, 18 novembre 2026) : les relances automatiques parties vers ce signataire, réglées dans le modèle (« Relancer qui n'a pas encore signé ») ; 0 et null tant qu'aucune n'est partie.
- « signatures_posees » n'apparaît que si le modèle a une signature déjà posée (l'image de la signature d'un rôle, posée une fois dans le modèle) : ce rôle ne signe pas en ligne, et « nom » est celui écrit sous la signature.
- « champs_a_completer » et « paraphe » n'apparaissent que si le modèle en a : ce que le signataire a saisi (« valeur » brute : date AAAA-MM-JJ, nombre sans séparateur, case vraie ou fausse ; « valeur_lisible » telle qu'écrite dans le contrat), et les pages qu'il a paraphées (à partir de 1). « colonne » est la colonne du contact où la valeur a été recopiée à la signature. Les mêmes clés arrivent dans le corps des webhooks de contrat (« contrat.signe »).
GET https://kapacity.app/api/v1/w/{workspace_id}/contracts/b423fdff-34f8-4a04-a66f-68034f0d77fe
Authorization: Bearer kap_live_…{
"contrat": {
"id": "c1…",
"titre": "Accompagnement 6 mois",
"statut": "signe",
"montant_cents": 500000,
"empreinte": "9f2c…",
"envoye_le": "2026-09-19T10:00:00.000Z",
"envoye_par": {
"id": "u1…",
"nom": "Sarah Martin"
},
"signataires": [
{
"id": "5d1e…",
"role": "client",
"libelle": "Client",
"nom": "Jean Dupont",
"email": "jean@acme.fr",
"statut": "signe",
"vu_le": "2026-09-20T08:10:00.000Z",
"signe_le": "2026-09-20T08:14:00.000Z",
"lien_signature": "https://kapacity.app/c/ab29…",
"relances": 0,
"derniere_relance_le": null
},
{
"id": "8c4f…",
"role": "rassoc01",
"libelle": "Associé",
"nom": "Marc Martin",
"email": "marc@acme.fr",
"statut": "signe",
"vu_le": "2026-09-20T09:02:00.000Z",
"signe_le": "2026-09-20T09:03:00.000Z",
"lien_signature": "https://kapacity.app/c/7e31…",
"relances": 1,
"derniere_relance_le": "2026-09-20T08:55:00.000Z"
}
],
"signatures_posees": [
{
"role": "rentrep1",
"libelle": "Entreprise",
"nom": "Sarah Martin, gérante"
}
],
"champs_a_completer": [
{
"id": "k3m9q2x7",
"libelle": "Adresse complète",
"type": "texte",
"obligatoire": true,
"colonne": "8d2f…",
"valeur": "5 rue Marbeuf, 75008 Paris",
"valeur_lisible": "5 rue Marbeuf, 75008 Paris"
},
{
"id": "p8w1r4t6",
"libelle": "Date de naissance",
"type": "date",
"obligatoire": true,
"colonne": null,
"valeur": "1990-03-12",
"valeur_lisible": "12 mars 1990"
}
],
"paraphe": {
"initiales": "TV",
"pages": [
1,
2,
3
]
}
},
"piste_audit": [
{
"etape": "cree",
"libelle": "Contrat créé",
"le": "2026-09-19T09:58:00.000Z",
"ip": null
},
{
"etape": "complete",
"libelle": "Complété par le signataire",
"le": "2026-09-20T08:14:00.000Z",
"ip": "81.…"
},
{
"etape": "signe",
"libelle": "Signé",
"le": "2026-09-20T08:14:00.000Z",
"ip": "81.…"
}
]
}GET/contract-templatesLes modèles de contrat, pour savoir lequel envoyer.
C'est d'ici que vient le « modele_id » qu'attend POST /contracts. Chaque modèle dit s'il est utilisable maintenant et quel message e-mail partira avec lui.
CLÉ : LECTURE SEULE SUFFIT
- Le « id » de chaque modèle est le « modele_id » à passer à POST /contracts.
- « utilisable » vaut false pour un modèle désactivé ou suspendu par le plan gratuit, et « raison » dit lequel des deux : POST /contracts le refuserait.
- « message_email » est l'e-mail qui partira au contact avec le lien de signature. S'il vaut null, aucun e-mail ne partira : le contrat sera quand même envoyé, et son lien rendu.
- « montant_defaut_cents » est le montant réglé sur le modèle, à titre indicatif : POST /contracts vous demande toujours le montant du contrat. En CENTIMES.
- « roles » (18 novembre 2026) : qui signe ce modèle. « client » est toujours le contact ; chaque autre « id » est le « role » à donner dans « signataires » de POST /contracts. « signature_posee »: true : sa signature est déjà posée dans le modèle (une image), il ne signe pas en ligne. « accepte_signataires » vaut false pour un modèle sans document à zones de signature : seul le contact le signe.
GET https://kapacity.app/api/v1/w/{workspace_id}/contract-templates
Authorization: Bearer kap_live_…{
"modeles": [
{
"id": "3e5a7c9b-2d4f-4e6a-8b1c-9d0e2f4a6b8c",
"titre": "Accompagnement 6 mois",
"montant_defaut_cents": 500000,
"utilisable": true,
"raison": null,
"message_email": {
"id": "8a6c4e2f-0b9d-4f7b-a5c3-1e9f7d5b3a1c",
"nom": "Votre contrat à signer"
},
"accepte_signataires": true,
"roles": [
{
"id": "client",
"libelle": "Client",
"signature_posee": false
},
{
"id": "rassoc01",
"libelle": "Associé",
"signature_posee": false
},
{
"id": "rentrep1",
"libelle": "Entreprise",
"signature_posee": true
}
],
"cree_le": "2026-09-10T09:00:00.000Z"
}
]
}POST/contractsEnvoie un contrat à un contact, au montant que vous indiquez, et rend son lien de signature.
Vous dites QUEL modèle de contrat, à QUEL contact, et pour QUEL montant : les trois vont dans le body JSON. Kapacity fait alors exactement ce que fait le bouton « Envoyer le contrat » de l'application : le contrat est rempli avec les informations du contact (nom, e-mail, société) et le montant, il part à la signature, et l'e-mail rattaché au modèle lui est envoyé avec le lien pour signer. L'étape du contact ne change pas à l'envoi : elle passe à « Contrat signé » quand il signe (il n'y a plus d'étape « Contrat envoyé » depuis le 22 octobre 2026). La réponse vous rend ce lien (« lien_signature »), pour l'envoyer aussi par un autre canal si vous le voulez.
CLÉ : LECTURE ET ÉCRITURE
| paramètre | où le mettre | obligatoire | description |
|---|---|---|---|
modele_id | dans le body JSON | oui | L'identifiant du MODÈLE de contrat à envoyer. Vous le trouvez avec GET /contract-templates (champ « id »). |
contact_id | dans le body JSON | oui | L'identifiant du contact à qui l'envoyer, de Mon Pipe ou de Setting. Vous le trouvez avec GET /tables/leads/records?filtre=Email:eq:<son e-mail> (champ « id »), ou dans le webhook « contact.cree ». |
montant_cents | dans le body JSON | oui | Le montant du contrat, en CENTIMES : 450000 pour 4 500 €. Il est écrit dans le contrat à la place de {{montant}}. Pour 0 €, écrivez 0. (ex. 450000) |
titre | dans le body JSON | non | Le titre du contrat. Absent : « <modèle> · <nom du contact> ». |
envoyer_email | dans le body JSON | non | false pour ne PAS envoyer l'e-mail : le contrat part à la signature, et vous transmettez vous-même le « lien_signature » (WhatsApp, SMS…). true par défaut. (ex. false) |
signataires | dans le body JSON | non | D'autres personnes qui signent avec le contact (18 novembre 2026) : une liste de { "role", "nom", "email" }. « role » est l'identifiant d'un rôle du modèle (GET /contract-templates, « roles ») ; sans « role », la personne signe à la fin du contrat. « nom » est obligatoire, « email » facultatif. Un rôle du modèle que vous ne donnez pas est retiré de ce contrat. 7 personnes au plus, le contact en plus. (ex. [{"role":"rassoc01","nom":"Marc Martin","email":"marc@acme.fr"}]) |
message_email_id | dans le body JSON | non | Un autre modèle d'e-mail de contrat que celui rattaché au modèle. Il doit être coché « Envoyer un contrat à signer » dans Emailing (rubrique « Ce modèle sert à ») : c'est ce réglage qui est vérifié, pas son contenu. |
automatisations | après le « ? » de l'adresse | non | false pour n'en déclencher aucune (ni le webhook « contrat.envoye »). |
Idempotency-Key | en en-tête | non | Rejouer le même appel rend le premier envoi au lieu d'envoyer un second contrat. |
- Le LIEN DE SIGNATURE est dans « contrat.lien_signature ». Il est TOUJOURS rendu, que l'e-mail parte ou non : c'est la page où le contact lit et signe son contrat.
- Plusieurs signataires (18 novembre 2026) : avec « signataires », chaque personne reçoit SON lien, par l'e-mail du modèle si elle a une adresse. « contrat.signataires » les liste, le contact d'abord : son lien (« lien_signature ») et si son e-mail est parti (« email_envoye »). Tous signent en même temps ; le contrat est « en_cours » dès la première signature, « signe » à la dernière (GET /contracts/{id} dit où en est chacun).
- Un rôle refusé l'est AVANT toute écriture (422) : un rôle que le modèle n'a pas (le message liste les siens), « client » (c'est le contact), un rôle à signature déjà posée, un rôle donné deux fois, une personne sans nom, une adresse invalide, deux personnes à la même adresse.
- Le montant est OBLIGATOIRE et s'écrit en CENTIMES : 450000 = 4 500 €, 99900 = 999 €. Sans lui, l'appel est refusé (422) : un contrat ne part jamais à un prix que vous n'avez pas écrit.
- « email » dit si l'e-mail est parti : { envoye: true, a: <adresse> }. Sinon { envoye: false, raison } explique pourquoi (pas de message rattaché au modèle, pas d'adresse chez le contact, pas de boîte d'envoi reliée, ou « envoyer_email »: false). Le contrat, lui, est envoyé dans tous les cas.
- Posez un « Idempotency-Key » (un texte unique par envoi, par exemple l'identifiant du deal) : si le réseau coupe et que votre scénario rejoue l'appel, le contact recevrait sinon DEUX contrats. Avec lui, le second appel rend le premier envoi.
- Le message part de la boîte du Sales du contact s'il en a relié une, sinon de la boîte de l'espace.
- Le contrat est FIGÉ à l'envoi : modifier le contact ensuite ne change pas le contrat.
- La piste d'audit du contrat dit « créé » puis « envoyé » par votre clé, sous son nom.
- Au plan gratuit, 5 envois de contrat par mois : au-delà, 429 « limite_plan » avec un Retry-After jusqu'au mois suivant.
- Un modèle désactivé ou suspendu par le plan est refusé en 422 : GET /contract-templates le dit à l'avance.
POST https://kapacity.app/api/v1/w/{workspace_id}/contracts
Authorization: Bearer kap_live_…
Content-Type: application/json
Idempotency-Key: contrat-jean-dupont-2026-09-23
{
"modele_id": "3e5a7c9b-2d4f-4e6a-8b1c-9d0e2f4a6b8c",
"contact_id": "7fc74cfb-c67a-43d2-868f-f4a8ab028475",
"montant_cents": 450000
}{
"contrat": {
"id": "b423fdff-34f8-4a04-a66f-68034f0d77fe",
"titre": "Accompagnement 6 mois · Jean Dupont",
"statut": "envoye",
"montant_cents": 450000,
"contact": {
"id": "7fc74cfb-c67a-43d2-868f-f4a8ab028475",
"nom": "Jean Dupont",
"email": "jean@acme.fr"
},
"signataire": {
"nom": "Jean Dupont",
"email": "jean@acme.fr"
},
"lien_signature": "https://kapacity.app/c/ab29cbefa0874ba5b2cc1c0758aa9fcd6f276503a714411391a2e8017d780ca6",
"signataires": [
{
"id": "5d1e9a3c-7b2f-4c8e-9a1d-3f6b8c0e2a4d",
"role": "client",
"libelle": "Client",
"nom": "Jean Dupont",
"email": "jean@acme.fr",
"statut": "attente",
"vu_le": null,
"signe_le": null,
"lien_signature": "https://kapacity.app/c/ab29cbefa0874ba5b2cc1c0758aa9fcd6f276503a714411391a2e8017d780ca6",
"relances": 0,
"derniere_relance_le": null,
"email_envoye": {
"envoye": true,
"a": "jean@acme.fr"
}
}
],
"cree_le": "2026-09-23T11:50:37.723277+00:00",
"envoye_le": "2026-09-23T11:50:37.498Z"
},
"email": {
"envoye": true,
"a": "jean@acme.fr"
},
"automatisations": true
}Ventes et paiements
GET/productsLe catalogue de produits, avec prix et échéanciers.
CLÉ : LECTURE SEULE SUFFIT
- Prix, acompte et coût sont en CENTIMES.
GET https://kapacity.app/api/v1/w/{workspace_id}/products
Authorization: Bearer kap_live_…{
"produits": [
{
"id": "p1…",
"nom": "Accompagnement 6 mois",
"prix_cents": 500000,
"mensualites": 3,
"actif": true
}
]
}GET/paymentsLes paiements reçus, tels que le fournisseur les a constatés.
CLÉ : LECTURE SEULE SUFFIT
| paramètre | où le mettre | obligatoire | description |
|---|---|---|---|
depuis | après le « ? » de l'adresse | non | Paiements reçus après cette date. |
jusqu_a | après le « ? » de l'adresse | non | Paiements reçus avant cette date. |
statut | après le « ? » de l'adresse | non | succeeded ou failed. |
contact | après le « ? » de l'adresse | non | Ne garde que les paiements de ce contact. |
limite | après le « ? » de l'adresse | non | De 1 à 200. |
curseur | après le « ? » de l'adresse | non | Le curseur de la page suivante. |
- Lecture seule, et volontairement : un paiement est un fait constaté chez le fournisseur, pas une donnée qu'on saisit.
- Les montants sont en CENTIMES et HORS TAXES.
GET https://kapacity.app/api/v1/w/{workspace_id}/payments?depuis=2026-09-01T00:00:00Z
Authorization: Bearer kap_live_…{
"paiements": [
{
"id": "pay1…",
"recu_le": "2026-09-20T08:20:00.000Z",
"montant_cents": 180000,
"devise": "eur",
"statut": "succeeded",
"fournisseur": "whop",
"payeur": {
"nom": "Jean Dupont",
"email": "jean@acme.fr"
},
"contact": {
"id": "l1…",
"nom": "Jean Dupont"
},
"rattache_a_une_vente": true
}
],
"curseur_suivant": null
}Équipe
GET/membersLes membres de l'espace et leur rôle.
CLÉ : LECTURE SEULE SUFFIT
- Une colonne « membre » (Sales, Setter) s'écrit avec l'identifiant rendu ici, ou avec l'e-mail ou le nom exact.
- « roles » donne les identifiants (admin, hos, closer, setter, et custom pour un rôle créé par les administrateurs de l'espace : COO, Marketing…), « roles_libelles » les mêmes par leur nom affiché dans Équipe (hos = « Head of Sales », custom = le nom du rôle créé), dans le même ordre. « proprietaire » dit en plus qui possède l'espace.
- « equipes » donne les identifiants des équipes du membre, ceux que « GET /event-types » rend dans « equipes ».
- « lien_rdv » est le lien personnel du membre : ajoutez « # » puis cette valeur au « lien_public » d'un type de rendez-vous qu'il reçoit (https://kapacity.app/b/mon-espace/appel#camille), et le rendez-vous lui revient directement, sur ses créneaux à lui. Par défaut, son prénom.
GET https://kapacity.app/api/v1/w/{workspace_id}/members
Authorization: Bearer kap_live_…{
"membres": [
{
"id": "u1…",
"nom": "Camille Royer",
"email": "camille@…",
"roles": [
"closer"
],
"roles_libelles": [
"Closer"
],
"equipes": [
"t1…"
],
"proprietaire": false,
"lien_rdv": "camille"
}
]
}Journal d'activité
GET/activityLe journal d'activité de l'espace : qui a fait quoi, quand.
CLÉ : LECTURE SEULE SUFFIT · RÉSERVÉ AU PROPRIÉTAIRE
| paramètre | où le mettre | obligatoire | description |
|---|---|---|---|
depuis | après le « ? » de l'adresse | non | Après cette date. |
domaine | après le « ? » de l'adresse | non | contacts, tables, contrats, booking… (ex. contacts) |
qui | après le « ? » de l'adresse | non | member, system, automation, public ou api. (ex. api) |
limite | après le « ? » de l'adresse | non | De 1 à 200. |
curseur | après le « ? » de l'adresse | non | Le curseur de la page suivante. |
- RÉSERVÉ aux clés créées par le PROPRIÉTAIRE de l'espace : « Logs Workspace » lui est réservé dans l'application, l'API ne fait pas exception.
- Le plus récent d'abord, contrairement aux autres listes : un journal se lit à l'envers.
- Le genre « api » retrouve tout ce que vos intégrations ont écrit, avec le nom de la clé.
GET https://kapacity.app/api/v1/w/{workspace_id}/activity?qui=api
Authorization: Bearer kap_live_…{
"activite": [
{
"id": "a1…",
"le": "2026-09-22T11:02:00.000Z",
"action": "lead.create",
"phrase": "a ajouté le contact « Jean Dupont »",
"acteur": {
"genre": "api",
"id": null,
"nom": "API · n8n"
},
"objet": {
"nature": "lead",
"id": "l1…",
"libelle": "Jean Dupont"
}
}
],
"curseur_suivant": null
}Webhooks
GET/webhooksVos abonnements aux événements, et la liste des événements possibles.
Un abonnement dit « appelle cette adresse quand ceci se passe ». C'est ce qui remplace un scénario qui interroge l'API toutes les cinq minutes : il consommerait du quota pour rien et réagirait en retard.
CLÉ : LECTURE SEULE SUFFIT
- Le secret de signature n'est JAMAIS rendu ici : il n'est lisible qu'une fois, à la création.
GET https://kapacity.app/api/v1/w/{workspace_id}/webhooks
Authorization: Bearer kap_live_…{
"webhooks": [
{
"id": "w1…",
"url": "https://n8n.exemple.fr/webhook/abc",
"evenements": [
"contrat.signe"
],
"actif": true,
"ignorer_api": true,
"description": "Scénario de closing",
"cree_le": "2026-09-22T09:00:00.000Z",
"dernier_envoi_le": "2026-09-22T11:30:00.000Z",
"echecs_consecutifs": 0
}
],
"evenements_possibles": [
{
"id": "contrat.signe",
"libelle": "Quand un contrat est signé",
"description": "Un contrat revient signé."
}
]
}POST/webhooksS'abonner à un ou plusieurs événements.
CLÉ : LECTURE ET ÉCRITURE
| paramètre | où le mettre | obligatoire | description |
|---|---|---|---|
url | dans le body JSON | oui | L'adresse appelée, en https. (ex. https://n8n.exemple.fr/webhook/abc) |
evenements | dans le body JSON | oui | Les événements écoutés. (ex. ["contrat.signe", "rendez_vous.pris"]) |
nom | dans le body JSON | non | Son nom, pour savoir qui est quoi dans la liste d'Intégrations et dans le journal (80 caractères au plus). Sans nom, il s'affiche par son adresse. (ex. Relance après signature) |
entete | dans le body JSON | non | Un en-tête ajouté à chaque envoi, { nom, valeur }, pour que votre outil refuse tout ce qui ne vient pas de Kapacity (dans n8n : « Header Auth »). La valeur n'est plus jamais relisible. |
ignorer_api | dans le body JSON | non | Ne pas vous renvoyer ce que votre propre clé a écrit. Le garde-fou anti-boucle. |
description | dans le body JSON | non | Une note libre, plus longue que le nom (200 caractères au plus). |
- Le « secret » n'est rendu QU'ICI, une seule fois : notez-le. Il sert à vérifier notre signature, sans lui n'importe qui pourrait se faire passer pour Kapacity auprès de votre serveur.
- L'adresse doit être publique et en https. Une adresse privée est refusée, à la création comme à chaque envoi.
- Si votre scénario ÉCRIT dans Kapacity et écoute les mêmes événements, mettez « ignorer_api » à true : sinon il se réveille lui-même, indéfiniment.
POST https://kapacity.app/api/v1/w/{workspace_id}/webhooks
Authorization: Bearer kap_live_…
Content-Type: application/json
{
"nom": "Relance après signature",
"url": "https://n8n.exemple.fr/webhook/abc",
"evenements": [
"contrat.signe"
],
"entete": {
"nom": "X-Api-Key",
"valeur": "une-valeur-que-vous-choisissez"
},
"ignorer_api": true
}{
"webhook": {
"id": "w1…",
"nom": "Relance après signature",
"url": "https://n8n.exemple.fr/webhook/abc",
"evenements": [
"contrat.signe"
],
"actif": true,
"entete_nom": "X-Api-Key"
},
"secret": "whsec_…"
}PATCH/webhooks/{id}Renommer un abonnement, changer son adresse, ses événements ou son en-tête, ou le réactiver.
CLÉ : LECTURE ET ÉCRITURE
| paramètre | où le mettre | obligatoire | description |
|---|---|---|---|
id | dans l'adresse | oui | L'identifiant de l'abonnement. |
nom | dans le body JSON | non | Le nouveau nom. Une chaîne vide ou null le retire. |
url | dans le body JSON | non | La nouvelle adresse, en https. |
evenements | dans le body JSON | non | La nouvelle liste d'événements. Elle REMPLACE l'ancienne. |
entete | dans le body JSON | non | Le nouvel en-tête, { nom, valeur } : la valeur est à redonner, elle n'est jamais relisible. null le retire. |
actif | dans le body JSON | non | Suspendre les envois, ou les reprendre. |
ignorer_api | dans le body JSON | non | Le garde-fou anti-boucle. |
description | dans le body JSON | non | La note libre. |
- Seuls les champs envoyés changent : les autres restent tels quels.
- Le secret ne se change pas : pour en changer, supprimez l'abonnement et recréez-le. C'est ce qui garantit qu'il n'existe qu'à un seul endroit.
- Réactiver remet le compteur d'échecs à zéro : un abonnement réparé repart avec toutes ses chances.
PATCH https://kapacity.app/api/v1/w/{workspace_id}/webhooks/5c7e9a1b-3d5f-4b7d-9f1a-2c4e6a8b0d2f
Authorization: Bearer kap_live_…
Content-Type: application/json
{
"nom": "Relance après signature",
"evenements": [
"contrat.envoye",
"contrat.signe"
],
"entete": {
"nom": "X-Api-Key",
"valeur": "une-nouvelle-valeur"
}
}{
"webhook": {
"id": "w1…",
"nom": "Relance après signature",
"evenements": [
"contrat.envoye",
"contrat.signe"
],
"actif": true,
"echecs_consecutifs": 0,
"entete_nom": "X-Api-Key"
}
}DELETE/webhooks/{id}Supprimer un abonnement, et son journal d'envois.
CLÉ : LECTURE ET ÉCRITURE
| paramètre | où le mettre | obligatoire | description |
|---|---|---|---|
id | dans l'adresse | oui | L'identifiant de l'abonnement. |
- Définitif. Pour arrêter les envois sans perdre l'historique, passez « actif » à false.
DELETE https://kapacity.app/api/v1/w/{workspace_id}/webhooks/5c7e9a1b-3d5f-4b7d-9f1a-2c4e6a8b0d2f
Authorization: Bearer kap_live_…{
"supprime": true,
"id": "w1…"
}POST/webhooks/{id}/testEnvoyer un événement d'exemple, pour brancher sans attendre un vrai.
L'essai passe par la MÊME file que les vrais envois : même signature, mêmes en-têtes, mêmes reprises. Un essai qui aboutit prouve donc que le vrai aboutira.
CLÉ : LECTURE ET ÉCRITURE
| paramètre | où le mettre | obligatoire | description |
|---|---|---|---|
id | dans l'adresse | oui | L'identifiant de l'abonnement. |
evenement | après le « ? » de l'adresse | non | Lequel simuler. Par défaut, le premier de l'abonnement. (ex. contrat.signe) |
- Le corps porte « essai: true » : votre scénario peut s'arrêter là plutôt que de créer une vraie facture.
- La réponse est un 202 : l'envoi part dans les secondes qui suivent. Son résultat se lit dans le journal des envois.
POST https://kapacity.app/api/v1/w/{workspace_id}/webhooks/5c7e9a1b-3d5f-4b7d-9f1a-2c4e6a8b0d2f/test?evenement=contrat.signe
Authorization: Bearer kap_live_…{
"envoi": {
"id": "d1…",
"event_id": "e1…",
"evenement": "contrat.signe",
"statut": "en_attente"
}
}GET/webhooks/{id}/deliveriesLe journal des envois : ce qui est parti, ce qui a été refusé, et pourquoi.
CLÉ : LECTURE SEULE SUFFIT
| paramètre | où le mettre | obligatoire | description |
|---|---|---|---|
id | dans l'adresse | oui | L'identifiant de l'abonnement. |
statut | après le « ? » de l'adresse | non | en_attente, envoi, envoye, echec ou abandonne. (ex. echec) |
limite | après le « ? » de l'adresse | non | De 1 à 200. |
curseur | après le « ? » de l'adresse | non | Le curseur de la page suivante. |
- C'est ici que « je ne reçois rien » trouve sa réponse : le code HTTP et le début de la réponse de VOTRE serveur y sont écrits.
- Le plus récent d'abord : on vient y chercher le dernier envoi, pas rejouer l'historique.
GET https://kapacity.app/api/v1/w/{workspace_id}/webhooks/5c7e9a1b-3d5f-4b7d-9f1a-2c4e6a8b0d2f/deliveries?statut=echec
Authorization: Bearer kap_live_…{
"envois": [
{
"id": "d1…",
"event_id": "e1…",
"evenement": "contrat.signe",
"statut": "echec",
"tentatives": 4,
"code_http": 401,
"reponse": "Unauthorized",
"erreur": null,
"duree_ms": 180,
"prochaine_tentative_le": null,
"envoye_le": null,
"cree_le": "2026-09-22T11:30:00.000Z"
}
],
"curseur": null
}POST/webhooks/{id}/deliveries/{envoi}/replayRenvoyer un événement déjà émis, par exemple après une panne de votre serveur.
CLÉ : LECTURE ET ÉCRITURE
| paramètre | où le mettre | obligatoire | description |
|---|---|---|---|
id | dans l'adresse | oui | L'identifiant de l'abonnement. |
envoi | dans l'adresse | oui | L'identifiant de l'envoi à rejouer. |
- Le corps rejoué est celui de l'ÉPOQUE, pas l'état d'aujourd'hui : c'est bien l'événement qui est rejoué.
- Le « webhook-id » reste le même : un destinataire qui déduplique reconnaît un doublon au lieu de traiter deux fois.
- Un envoi encore en cours de tentatives ne se rejoue pas : attendez son résultat.
POST https://kapacity.app/api/v1/w/{workspace_id}/webhooks/5c7e9a1b-3d5f-4b7d-9f1a-2c4e6a8b0d2f/deliveries/9d8c7b6a-5f4e-4d3c-8b2a-1f0e9d8c7b6a/replay
Authorization: Bearer kap_live_…{
"envoi": {
"id": "d2…",
"event_id": "e1…",
"evenement": "contrat.signe",
"statut": "en_attente"
},
"rejoue_depuis": "d1…"
}Les refus
Toute erreur rend { error, code }. Le code est stable, le message peut changer : aiguillez sur le code, jamais sur le texte.
| code | HTTP | ce que ça veut dire |
|---|---|---|
cle_absente | 401 | Clé d'API absente. Ajoutez l'en-tête « Authorization: Bearer kap_live_… » à votre requête. |
cle_invalide | 401 | Clé d'API inconnue. Vérifiez que vous utilisez bien la clé affichée à sa création. |
cle_expiree | 403 | Cette clé d'API a expiré. Créez-en une nouvelle depuis Intégrations, onglet API. |
cle_revoquee | 403 | Cette clé d'API a été révoquée. Créez-en une nouvelle depuis Intégrations, onglet API. |
espace_incorrect | 403 | Cette clé n'appartient pas à l'espace demandé. Vérifiez l'identifiant d'espace dans l'adresse. |
portee | 403 | Cette clé est en lecture seule : elle ne peut pas modifier de données. Créez une clé « Lecture et écriture » pour cette intégration. |
proprietaire | 403 | Cette partie est réservée au propriétaire de l'espace : utilisez une clé créée par lui. |
introuvable | 404 | Cet élément n'existe pas dans cet espace. |
validation | 422 | La requête a été refusée : une valeur ne convient pas. |
quota_mensuel | 429 | Le quota d'appels du mois est atteint pour cet espace. Il repart au premier jour du mois prochain, et le plan Entreprise en comprend davantage. |
debit | 429 | Trop d'appels en une seconde. Espacez vos requêtes, puis réessayez. |
debit_heure | 429 | Trop d'appels sur la dernière heure. Réessayez un peu plus tard. |
disjoncteur | 429 | Écritures suspendues sur cet enregistrement : il a été modifié trop souvent en quelques secondes par cette clé. C'est le garde-fou anti-boucle. |
limite_plan | 429 | Une limite du plan de cet espace est atteinte. |
api_fermee | 403 | L'API n'est pas encore ouverte sur cet espace. |
droits | 403 | Le rôle de la personne qui a connecté cet assistant ne permet pas cette action. |
membre | 403 | La personne qui a connecté cet assistant ne fait plus partie de l'espace, ou son rôle n'a plus le droit « Utiliser un assistant IA ». Un administrateur le règle dans Équipe, « Droits par rôle ». |
cle_espace | 403 | Cette partie se règle avec une clé d'API de l'espace (Intégrations, onglet API), pas avec un assistant IA connecté au nom d'un membre. |
adresse_de_base | 400 | L'adresse appelée contient deux fois le chemin de l'API : l'adresse de base (Base URL) de votre outil doit être l'adresse de Kapacity seule, https://kapacity.app, sans /api/v1/w/… après. Le node n8n et l'app Make ajoutent ce chemin eux-mêmes. |
adresse_inconnue | 404 | Cette adresse n'existe pas dans l'API Kapacity. Toutes les adresses sont dans la documentation : https://kapacity.app/docs/api. |
Webhooks
Ne faites pas interroger l'API toutes les cinq minutes par un scénario : cela brûle votre quota à ne rien trouver, et réagit en retard. Abonnez-vous, et Kapacity appelle votre adresse au moment où la chose se passe.
| événement | quand |
|---|---|
contact.cree | Un contact entre dans Mon Pipe ou dans Setting, par l'écran, un formulaire, une réservation, un import ou l'API. |
contact.modifie | Une valeur d'un contact change. Le corps porte l'état APRÈS la modification. |
ligne.creee | Une ligne entre dans une table créée par l'équipe (Mes Ventes, Produits, une table à vous). |
ligne.modifiee | Une valeur d'une ligne change, quelle que soit la colonne et quelle que soit la main qui l'écrit. |
rendez_vous.pris | Un prospect réserve un créneau sur une page publique de réservation. |
rendez_vous.reprogramme | Le créneau d'un rendez-vous change. |
rendez_vous.annule | Un rendez-vous est annulé, par le contact ou par l'équipe. |
formulaire.soumis | Quelqu'un termine un formulaire de qualification. Le corps porte le score. |
contrat.envoye | Un contrat part vers son signataire, depuis l'application ou par POST /contracts. « objet » est le CONTRAT, et « contact » le contact qui le signera. |
contrat.signe | Un contrat revient signé. C'est l'événement que la plupart des scénarios attendent. « objet » est le CONTRAT, et « contact » le contact qui l'a signé. |
paiement.recu | Un paiement est constaté chez le fournisseur et rattaché à l'espace. |
Chaque envoi est signé (convention Standard Webhooks : webhook-id, webhook-timestamp, webhook-signature). La livraison est « au moins une fois » : dédupliquez sur webhook-id. La marche à suivre complète est dans la référence, bouton ci-dessus.
Ce que l'API ne fait pas
À lire avant d'écrire un appel qui n'existe pas :
- Créer ou modifier une table, une colonne, un statut : Décision de Nicolas du 22 septembre 2026 : c'est du DDL logique. L'API lit la structure, elle ne la façonne pas. Une intégration qui aurait besoin d'une colonne la demande à un administrateur.
- Visioconférence, enregistrements, transcriptions : Module masqué derrière FEATURES.visio : rien de ce qui n'est pas en service ne s'expose.
- Nombre de renvois d'un contrat et sa vente (onglet « Envois » de Mes contrats) : Lot 1 des contrats, 18 novembre 2026 : deux lectures de l'écran, calculées à l'affichage (les e-mails envoyés à la main après l'envoi, la vente unique du contact), pas des données du contrat. L'API donne déjà ce qu'il faut pour les refaire : « envoye_par » et les dates du contrat, son contact, et les lignes de Mes Ventes (GET /tables/{id}/records).
- Corriger ou relancer un signataire d'un contrat envoyé, poser la signature d'un rôle dans un modèle : Lot 2 des contrats, 18 novembre 2026 : corriger une adresse crée un nouveau lien et annule l'ancien, un geste rare qui se fait sur la fiche du contrat, carte « SIGNATAIRES », où l'on voit qui a signé ; la signature déjà posée est une image choisie dans l'éditeur des modèles, que l'API ne modifie pas. L'API envoie le contrat à chacun (POST /contracts, « signataires ») et rend le lien et l'état de chacun (GET /contracts/{id}) : un scénario peut relancer par son propre canal.
- La copie automatique du contrat signé : à qui elle part, et à qui elle est partie : Lot 3 des contrats, 18 novembre 2026 : le destinataire de la copie se règle dans l'éditeur des modèles (section « COPIE DU CONTRAT SIGNÉ »), que l'API ne modifie pas, et ce qui est parti se lit sur la fiche du contrat. Le webhook « contrat.signe » part au scellement, avant la copie : un scénario qui veut envoyer le contrat lui-même le fait depuis cet événement.
- Régler les relances automatiques d'un modèle de contrat : Lot 4 des contrats, 18 novembre 2026 : le rythme et le nombre se règlent dans l'éditeur des modèles (section « RELANCES »), que l'API ne modifie pas. Ce qui est parti se lit par signataire (GET /contracts/{id}, « relances », « derniere_relance_le ») ; un scénario peut relancer par son propre canal avec le « lien_signature ».
- Pages opt-in, modèles d'e-mail, tutoriels : Surfaces d'édition, sans usage d'automatisation identifié. À rouvrir si un client le demande, jamais par anticipation.
- Créer ou modifier un modèle d'e-mail par l'IA (consigne, capture ou PDF, code HTML) : Un geste d'édition fait à l'écran par un membre connecté, qui dépense les crédits IA de l'espace et dont le résultat se relit avant tout envoi : une clé ne dépense pas de crédits IA. Les e-mails partent toujours par les automatisations et les envois de l'application (13 octobre 2026).
- Ce qui suit une réservation (écran de confirmation, envoi vers une page) et le code d'intégration d'une page de rendez-vous : Réglages d'affichage de la page publique de réservation, faits à l'écran (23 octobre 2026) : ils ne changent ni le rendez-vous, ni le contact, ni ce que reçoit une automatisation. Le « lien_public » de GET /event-types reste ce qu'une intégration envoie au prospect.
- Panel d'administration de la plateforme, page Associés : Écrans internes de Kapacity, hors de l'espace d'un client. Ils n'ont rien à faire dans une API de tenant.
- Finances & Charges : les charges, leurs factures et leurs montants HT, TVA et TTC : Données financières réservées aux administrateurs de l'espace (lecture comprise). Aucun usage d'automatisation identifié à l'ajout des factures et des montants HT et TTC (2 octobre 2026) : à rouvrir si un client le demande.
- Les factures de l'abonnement Kapacity et les informations de facturation de la société : Documents comptables émis par Kapacity à l'espace (et non données du client sur ses propres ventes), réservés aux administrateurs, édités au premier téléchargement dans les Paramètres (0182, 2 octobre 2026). Aucun usage d'automatisation identifié : à rouvrir si un client demande à récupérer ses factures par l'API.
- Les cartes « Charges payées » et « Bénéfices » du tableau de bord : Des chiffres CALCULÉS à l'affichage (3 octobre 2026), pour les seuls administrateurs, depuis les charges de Finances & Charges, hors périmètre elles aussi : l'encaissé et les commissions qui entrent dans le calcul se lisent déjà par les paiements reçus de l'API.
- Les inscrits gratuits versés dans l'espace de vente de Kapacity, et les commissions de notre équipe : Mécaniques INTERNES à Kapacity (22 septembre, 2 et 3 octobre 2026) : elles n'existent que dans notre propre espace de vente, jamais dans celui d'un client. Les leads, les ventes et les paiements reçus qu'elles créent se lisent par l'API de cet espace comme les autres.
- Créer, modifier ou supprimer une clé d'API : Une clé ne se fabrique pas par une clé : ce serait une escalade de droits silencieuse. La création reste dans l'application, réservée au propriétaire et aux administrateurs.
- Inviter un membre ou lui créer son compte : Même raison qu'une clé : une clé qui fabrique des comptes fabrique des accès. Faire entrer quelqu'un reste dans la page Équipe, réservé aux administrateurs et aux rôles qui ont le droit « Inviter un membre » (23 septembre 2026), dans un rôle qui n'a pas plus de droits que le leur. L'API lit les membres, elle n'en ajoute pas.
- Repartir à zéro un espace de démo (bouton « Repartir à zéro » des Paramètres, 17 novembre 2026) : Un geste d'administrateur, à l'écran et après confirmation : il supprime définitivement tout le contenu de l'espace. Il n'existe que dans un espace déclaré « espace de démo » par l'équipe Kapacity ; une clé d'API ne vide pas un espace.
- Retirer un membre de l'espace (droit « Retirer un membre », 17 novembre 2026) : Le pendant d'une invitation : retirer quelqu'un lui ôte son accès, définitivement. Réservé aux administrateurs et, avec le droit « Retirer un membre », à qui retire un membre de rang plus bas de ses équipes, dans la page Équipe, après confirmation. Une clé d'API n'a ni rang ni équipe : l'API lit les membres, elle n'en retire pas.
- Créer, modifier ou supprimer un rôle (rôles créés, 16 novembre 2026) : Un rôle décide de droits, de pages et de leads visibles : en fabriquer un, c'est fabriquer des accès, comme une invitation. Réservé aux administrateurs, dans la page Équipe (« Rôles de l'espace »). L'API lit le nom du rôle d'un membre (« roles_libelles » des membres), elle n'en crée pas.
- Construire le parcours d'un formulaire : routes, tranches de score, cartes de l'onglet Parcours : Surface d'édition (24 septembre 2026), comme l'éditeur de formulaire tout entier : la logique s'écrit dans l'application, où elle se voit en cartes et se vérifie. L'API lit les réponses, dont le score est déjà calculé sur le chemin suivi.
- Rattacher une question de formulaire à une colonne du CRM (identité, colonnes natives, colonnes personnalisées) : Réglage de l'éditeur de formulaire (13 octobre 2026), comme le reste de l'éditeur. Son effet, lui, se lit par l'API : les colonnes qu'une réponse a remplies (Société, Source, Statut, Sales…) sont celles du contact, et l'événement du formulaire soumis porte la réponse.
- Demander une autre question sur l'écran de l'identité d'un formulaire (la glisser dans « Demandées sur un seul écran ») : Réglage de l'éditeur de formulaire (13 octobre 2026), un geste de mise en page comme le reste de l'éditeur. Il ne change rien à ce que l'API lit : la réponse à cette question arrive avec les autres, sur le contact et dans l'événement du formulaire soumis.
- Vérifier qu'un contact existe déjà avant de l'ajouter (fenêtre « Ce contact existe peut-être déjà ») : Une mise en garde faite pour quelqu'un devant l'écran, qui choisit « Annuler » ou « Créer quand même ». Un scénario, lui, cherche le contact par sa liste (filtre par e-mail) avant d'écrire, et l'écriture groupée de l'API est déjà idempotente (28 septembre 2026).
- Acheter un pack de crédits IA : Un paiement engage l'entreprise et se fait sur la page Whop, par un administrateur connecté : une clé ne paie pas. Le solde des crédits se lit dans l'application (24 septembre 2026).
- Droits et pages par rôle, colonne Admin comprise, et les commissions visibles par rôle : Régler ce que chaque rôle peut faire, c'est régler les accès : même raison qu'une clé ou une invitation. Le tableau reste dans la page Équipe, aux administrateurs, et sa colonne Admin au seul propriétaire de l'espace (24 septembre 2026). Les cases « Commissions visibles » (16 novembre 2026) décident ce que voit un rôle : même raison.
- Modifier ou partager la commission d'un encaissement : Un geste réservé au PROPRIÉTAIRE de l'espace (14 novembre 2026, 0226), journalisé à son nom dans les Logs Workspace : une clé d'API n'est pas le propriétaire. Les commissions elles-mêmes se calculent à l'affichage et ne sont pas exposées ; l'encaissé qui les porte se lit par les paiements reçus.
- Marquer un paiement remboursé, solder une vente à la main (« Soldé » qui enregistre le reste dû, « Remboursé » qui rembourse ses paiements) : Des gestes d'administrateur, à l'écran (17 novembre 2026, 0241) : ils changent l'encaissé, donc le chiffre d'affaires et les commissions, et sont journalisés au nom de qui les fait. L'API lit les paiements reçus et leur statut (« refunded » compris) ; « Soldé » ou « Remboursé » écrits par l'API dans « Statut paiement » ne changent que le statut.
- Les règles de commission (fixe par vente et taux, par rôle, rôles créés compris, par personne, par produit, par échéancier), sur quelles ventes un rôle créé touche une commission et les sources d'un Media Buyer, et la devise de l'espace : Des réglages faits par un administrateur sur la page Commissions et dans les Paramètres (fixe et devise le 16 novembre 2026, 0227) : ils décident de ce que touche chaque membre, aucun usage d'automatisation identifié. Les commissions se calculent à l'affichage et ne sont pas exposées ; l'encaissé qui les porte se lit par les paiements reçus.
- La marque de l'espace : nom, couleur principale, couleur secondaire, logo : Un réglage d'habillage fait une fois par un administrateur dans les Paramètres (couleur secondaire le 14 novembre 2026, 0225) : aucun usage d'automatisation identifié.
- « Setup mon workspace avec l'IA » (nom, logo, formulaires et pages préparés à partir du site) : Un geste d'accueil fait UNE seule fois par espace, offert, par un administrateur connecté qui coche la déclaration de droits sur son site : rien à automatiser. Ce qu'il crée (formulaires, réponses, contacts) se lit ensuite par l'API comme le reste (1er octobre 2026).
- Trier une grille du CRM en cliquant sur le nom d'une colonne : C'est un réglage d'AFFICHAGE, pas une donnée : il vit dans l'adresse de la page et n'écrit rien. L'API rend les lignes dans un ordre stable (de la plus ancienne à la plus récente) pour qu'une synchronisation reprenne où elle s'est arrêtée ; l'intégration trie de son côté (28 septembre 2026).
- Consentement des visiteurs aux traceurs d'une page opt-in : Le choix du visiteur vit dans SON navigateur, jamais chez Kapacity : il n'y a rien à lire ni à écrire. Les identifiants du pixel Meta et de Google Analytics se règlent dans l'éditeur de la page (29 septembre 2026).
- Disponibilités d'un membre : plages de la semaine et exceptions au jour le jour : Chacun règle SES disponibilités, connecté, dans RDV & Formulaires : une clé d'espace n'est pas un membre. Et l'API ne pose pas de rendez-vous (les disponibilités se décident côté Kapacity) ; une intégration qui voudrait bloquer un agenda passe par Google Agenda, déjà relu à chaque réservation (29 septembre 2026, 0175).
- Remise à zéro d'un espace et restauration de sa sauvegarde : Un outil interne du panel d'administration, réservé au compte contact@kapacity.app avec double authentification (7 octobre 2026, 0183). Une clé d'espace ne vide jamais un espace, même le sien.
- Les filtres d'écran d'une table (recherche, menus, période de Mes Ventes), ses pages de 50 lignes et les cartes de chiffres de Mes Ventes : Des réglages d'affichage (7 octobre 2026), évalués dans le navigateur sur les lignes déjà chargées. Par l'API, une intégration lit les lignes d'une table (`GET /tables/{id}/records`), page par page avec son curseur, et en tire les totaux qu'elle veut.
- Importer un fichier CSV, vérifier et récupérer ses pièces jointes depuis leur adresse, relier les ventes importées à leur lead : Un assistant d'écran (7 octobre 2026, 0184) : la personne y associe les colonnes de son fichier et en vérifie les rapprochements, les liens de ses fichiers et les options ajoutées ; une vente importée dans Mes Ventes y est reliée au lead du même e-mail. Par l'API, chaque contact ou ligne se crée un par un, sa colonne de lien renseignée, et aucune route ne va chercher un fichier chez un tiers : un appel d'API ne fait jamais télécharger nos serveurs.
- Les liens d'agenda d'un rendez-vous (Google Agenda, fichier .ics), les initiales de l'interlocuteur et l'ancien créneau d'un rendez-vous déplacé : Des variables des e-mails de rendez-vous (13 octobre 2026, lib/rdv-agenda) : elles servent le CONTACT, dans les messages qu'il reçoit, et le fichier d'agenda se télécharge par le jeton secret de son rendez-vous, qui ne sort jamais par l'API. Une intégration a déjà la date, l'heure, l'interlocuteur et le lien de visioconférence par les rendez-vous de l'API, de quoi écrire ses propres liens. L'ancien créneau d'un déplacement, lui, n'est gardé que dans le message « déplacé » : l'événement de webhook du déplacement donne le rendez-vous tel qu'il est devenu.
- Relier, régler ou retirer les agendas Google ou Outlook d'un membre, et la vue « Agendas de l'équipe » : Plusieurs agendas par membre (21 octobre 2026, 0197) : relier un agenda est une autorisation OAuth que Google exige de la personne elle-même, à l'écran ; aucune clé d'API ne peut la donner à sa place. Les réglages (« Vérifier les conflits », l'agenda où s'écrivent les rendez-vous) appartiennent au membre. Une intégration lit déjà l'effet de ces agendas : les créneaux proposés et les rendez-vous pris, avec leur lien de visioconférence.
- La disposition des colonnes de Mon Pipe et de Setting (ordre, colonnes affichées, largeurs, colonnes produit) et la disposition de l'équipe : Une préférence d'affichage PERSONNELLE de chaque membre (21 octobre 2026, 0200) : une clé d'espace n'est pas un membre. La disposition de l'équipe se règle par un administrateur, à l'écran. Une intégration lit les contacts et toutes leurs colonnes par l'API, quelle que soit la disposition de qui que ce soit.
- L'alerte de disponibilité d'un type de rendez-vous : son seuil, le dernier contrôle et l'alerte envoyée : Un réglage de l'écran (21 octobre 2026, 0199) qui prévient les head of sales, les administrateurs et le propriétaire par la cloche et par e-mail, recompté chaque heure par Kapacity. Une intégration qui veut sa propre alerte lit déjà les créneaux proposés et les rendez-vous pris, et en tire le seuil qu'elle veut.
- L'avis au membre d'un rendez-vous pris, annulé, reprogrammé ou transféré (cloche et e-mail de Kapacity) : Un message de Kapacity à son utilisateur (28 octobre 2026), pas une donnée de l'espace. Une intégration qui veut prévenir autrement écoute déjà les événements « rendez_vous.pris », « rendez_vous.reprogramme » et « rendez_vous.annule ».
- Le bouton « Nouvel achat » (upsell ou cross-sell), la gamme d'un produit et le rapport « Upsell et cross-sell » : Des aides à l'écran (26 octobre 2026, 0211) : la gamme sert seulement à PROPOSER le type d'un nouvel achat, et le rapport se calcule à l'affichage. Le résultat, lui, est une donnée de Mes Ventes : une intégration lit et crée les ventes par l'API des lignes de table, colonnes « Type de vente » (Première vente, Upsell, Cross-sell) et « Vente d'origine » comprises, et ses paiements se lisent par les paiements reçus.
- Le bouton « Attribuer » de la barre de sélection des leads (répartir des contacts entre plusieurs membres, équitablement ou en pourcentages) : Une aide à l'écran (7 novembre 2026) : elle calcule une répartition pour quelqu'un qui coche des lignes et lit l'aperçu. Le résultat est une valeur de la colonne Sales ou Setter, que l'API écrit déjà contact par contact (PATCH /records/{id}) : une intégration choisit elle-même qui reçoit quel contact, et y déclenche les automatisations, ce que l'attribution en masse ne fait pas.
- Supprimer plusieurs leads d'un coup depuis la barre de sélection (les leads cochés, ou toute la liste filtrée à l'écran) : Un geste d'écran (20 novembre 2026), irréversible, qui se confirme après avoir vu le nombre de leads compté sur la recherche et les filtres de la personne. L'API supprime déjà un contact par appel (DELETE /records/{id}) : une intégration supprime les contacts qu'elle a elle-même choisis, un par un, plutôt qu'une liste décrite par des filtres d'écran.
- Les KPI créés du tableau de bord (constructeur de KPI), les cartes masquées et le réglage « Qui voit cette carte » : Un réglage de l'écran (8 novembre 2026, 0218) : il dit comment le tableau de bord de l'équipe se présente, pas une donnée. Les chiffres eux-mêmes se recalculent à partir de ce que l'API lit déjà (les lignes des bases et des tables, les paiements), et une intégration qui veut un indicateur le calcule chez elle sur ces mêmes lignes.
- L'aperçu des pièces jointes (Word, Excel, PowerPoint, vignettes) et le format d'affichage d'une colonne formule : De l'affichage (8 novembre 2026) : l'aperçu se fabrique dans le navigateur à partir du fichier, que l'API sert déjà par son lien ; le format d'une formule (€, %, décimales) ne change pas sa valeur, que l'API rend telle qu'elle est calculée.