L’API REST de Grist et les Webhooks : comment connecter Grist au reste du monde

Si vous utilisez Grist dans une petite entreprise, une association ou une collectivité, il arrive vite un moment où vous avez besoin que Grist « parle » à d’autres outils : envoyer automatiquement une ligne vers votre comptabilité, recevoir des paiements Stripe, mettre à jour un tableau de bord Google Data Studio, ou simplement recevoir une alerte Slack quand un formulaire est rempli.

C’est exactement ce que permet l’API REST de Grist, combinée aux webhooks. Voici tout ce qu’il faut savoir pour commencer, même si vous n’avez jamais touché à une API de votre vie.

1. Où trouver l’API de votre document

Chaque document Grist possède sa propre API.
Pour la récupérer :

Ouvrez votre document
Cliquez sur Share (en haut à droite) → Webhooks & API
Vous obtenez immédiatement :
- l’URL de base de l’API (https://docs.getgrist.com/api/docs/DOC_ID…)
- une clé API (longue chaîne de caractères)

Copiez les deux, vous en aurez besoin.

2. Les deux façons simples d’utiliser l’API

Il y a deux grandes familles d’outils qui ne demandent presque aucune compétence technique :

A. Make (ex-Integromat), Zapier, Pabbly Connect, n8n
Ces outils ont un module Grist prêt à l’emploi.
Vous choisissez simplement :

« Trigger » → quand une ligne est ajoutée/modifiée (via webhook)
« Action » → ajouter, mettre à jour ou récupérer des lignes

Exemple concret : un formulaire Grist rempli → création automatique d’un contact MailerLite + envoi d’un email de bienvenue + ajout dans un Google Sheet comptable. Tout ça en 5 minutes sans écrire une ligne de code.

B. Les webhooks sortants
Un webhook, c’est Grist qui envoie un message à une URL quand quelque chose se passe (ligne ajoutée, modifiée, supprimée).

Configuration :

Share → Webhooks & API → Add webhook
Choisissez la table concernée
Cochez les événements (add, update, delete)
Collez l’URL fournie par Make/Zapier/Slack

Résultat : dès qu’une ligne change, Grist envoie immédiatement les données au service que vous avez choisi.

3. Utiliser l’API directement (quand même très simple)

Si vous voulez faire quelque chose que les outils no-code ne proposent pas, voici les opérations les plus utiles :

→ Lire toutes les lignes d’une table

GET https://docs.getgrist.com/api/docs/DOC_ID/tables/Table1/records
Authorization: Bearer VOTRE_CLE_API

Vous obtenez du JSON très propre, exactement comme dans Grist.

→ Ajouter une ligne

POST https://docs.getgrist.com/api/docs/DOC_ID/tables/Table1/records
Authorization: Bearer VOTRE_CLE_API
Content-Type: application/json

{
  "records": [
    {
      "fields": {
        "Nom": "Dupont",
        "Prénom": "Marie",
        "Montant": 150,
        "Statut": "Payé"
      }
    }
  ]
}

→ Mettre à jour une ligne (il faut connaître son id)

PATCH https://docs.getgrist.com/api/docs/DOC_ID/tables/Table1/records
Authorization: Bearer VOTRE_CLE_API

{
  "records": [
    {
      "id": 123,
      "fields": {
        "Statut": "Validé"
      }
    }
  ]
}

→ Supprimer une ligne

DELETE https://docs.getgrist.com/api/docs/DOC_ID/tables/Table1/records
{ "records": [ { "id": 123 } ] }

C’est tout. Avec ces 4 requêtes vous couvrez 95 % des besoins réels.

4. Exemples concrets que j’utilise tous les jours avec mes clients

Association – Adhésions
Formulaire Grist → webhook → création membre sur HelloAsso + ajout dans table comptable.
Petite entreprise – Facturation
Quand la colonne « Facture validée » passe à Oui → webhook → création facture sur Facture.net ou Pennylane via leur API.
Collectivité – Demandes de subventions
Nouvelle ligne dans le formulaire → webhook → création tâche dans le logiciel interne (souvent via Make qui envoie un email structuré ou un ticket).
Boutique en ligne simple
Paiement reçu sur Stripe → webhook Stripe → Make → ajout ligne « Commande » dans Grist avec statut « Payée ».

5. Bonnes pratiques que j’applique systématiquement

Créez une clé API dédiée pour chaque intégration (vous pouvez en créer autant que vous voulez et les révoquer séparément).
Mettez toujours la clé dans les variables d’environnement de Make/Zapier, jamais en clair.
Pour les colonnes Référence, envoyez simplement l’id de la ligne cible (pas le texte affiché).
Si vous avez beaucoup de lignes, ajoutez ?limit=1000 ou faites plusieurs appels avec ?start=…
Testez d’abord sur une copie du document.

6. Documentation officielle (à garder sous le coude)

Vue d’ensemble : https://support.getgrist.com/api/
Détail complet de l’API REST : https://support.getgrist.com/rest-api/
Webhooks : https://support.getgrist.com/webhooks/

En résumé

L’API de Grist est simple, fiable et surtout parfaitement documentée.
Pour 90 % des besoins d’une TPE, association ou service administratif, Make ou Zapier + les webhooks suffisent largement.
Pour les 10 % restants, copier-coller une des requêtes ci-dessus dans Postman ou dans un petit script suffit.

Si vous avez un cas précis à connecter (comptabilité, mailing, CRM, paiement, etc.), dites-le moi en commentaire, je vous donnerai le scénario exact à mettre en place.

L’API REST de Grist et les Webhooks