Guide · Notion
Webhook Notion : les ventes d'un formulaire
Beaucoup d'indépendants tiennent leurs ventes dans une base Notion, et c'est très bien. Ce qui manque, c'est la colonne qu'on ne peut pas remplir à la main : celle qui dit d'où venait le client.
Tout le guide tient là-dedans
Webhook URL
Plus un en-tête personnalisé : Authorization, valeur « Bearer » suivi de votre clé serveur. Notion sait le poser lui-même, et c'est ce qui rend l'intermédiaire inutile.
Action « Send webhook » des automatisations de base, relevée dans l'aide Notion le 12 septembre 2026.
À vérifier avant de commencer
Les automatisations de base demandent une formule payante
Ces bornes ne gênent pas : une vente tient dans cinq propriétés. La seule à retenir vraiment est la première, parce qu'elle décide si la page vous concerne.
Sur une formule gratuite, il reste la voie sans code : un lien Subtraq collé dans le champ de redirection d'un formulaire Tally ou Typeform. L'envoi du formulaire devient une conversion, et il n'y a alors ni clé, ni requête, ni automatisation.
Sources : les automatisations de base et les actions webhook, aide Notion.
Ce que l'action sait faire, et ses bornes
D'après l'aide Notion : les automatisations de base de données sont offertes sur les formules payantes ; l'action webhook envoie uniquement en POST, accepte des en-têtes personnalisés, se limite à cinq actions webhook par automatisation, et ne peut inclure dans son corps que les propriétés de la page — pas son contenu.
Dans Notion, 6 étapes
De la ligne passée en « payé » à la vente attribuée
Rien à installer, aucun intermédiaire, aucun développement : Notion est l'un des rares outils de cette famille qui sache poser lui-même l'en-tête d'autorisation que Subtraq exige.
Préparez la base : trois propriétés suffisent
Un champ texte pour l'adresse email du client, un champ nombre pour le montant, et un champ de sélection pour l'état — « à encaisser », « payé ». C'est le passage à « payé » qui déclenchera tout.
Créez l'automatisation sur la base
Le déclencheur se règle sur la modification de la propriété d'état, et se filtre sur la valeur « payé ». Sans le filtre, chaque retouche de ligne partirait en requête.
Ajoutez l'action « Send webhook »
Notion n'envoie qu'en POST, ce qui tombe bien : c'est ce qu'attend Subtraq. Collez l'adresse https://subtraq.co/api/v1/sales dans le champ d'URL.
Ajoutez l'en-tête d'autorisation
L'action propose d'ajouter un en-tête personnalisé. Nom : Authorization. Valeur : Bearer suivi de la clé serveur Subtraq, celle qui commence par stq_sk_ et porte le droit events:write. C'est ce réglage qui évite tout intermédiaire.
Composez le corps avec les propriétés de la ligne
space reçoit le slug de l'espace client, amount le montant en centimes, currency trois lettres, invoiceId un identifiant unique de la ligne, email l'adresse du client. Seules les propriétés de la page entrent dans le corps : le contenu de la page, lui, ne part pas.
Passez une ligne de test en « payé »
Subtraq répond 201 pour une vente nouvelle, 200 si l'identifiant de facture est déjà passé, et dit dans les deux cas si la vente a retrouvé son lien d'origine.
Chemins relevés dans l'aide Notion le 12 septembre 2026 — la page des actions webhook. Une interface change : si ce que vous voyez ne correspond plus, la source fait foi.
La question à ne pas éviter
Notion peut-il recevoir une conversion, lui ?
Pour qu'une conversion Subtraq arrive dans une base Notion, il faut un intermédiaire : le webhook sortant de Subtraq réveille Zapier, Make ou n8n, et l'intermédiaire appelle l'API Notion pour créer la ligne. C'est un maillon de plus, et il vaut mieux le savoir avant de chercher un réglage qui n'existe pas.
Ce que l'API Notion sait faire en revanche, c'est se laisser interroger : un outil tiers peut venir lire les lignes d'une base quand il le décide. C'est une autre façon de tenir le même journal, plus lente mais sans rien à surveiller.
Source : les webhooks de l'API Notion, relevés le 12 septembre 2026.
Les webhooks de l'API Notion vont dans l'autre sens
Les souscriptions de webhook de l'API Notion envoient des événements vers votre serveur — contenu modifié, commentaire créé, schéma changé — dans un format imposé par Notion, signé par l'en-tête X-Notion-Signature. Aucune d'elles n'écrit une ligne dans une base.
Les cas pénibles, traités franchement
Une base tenue à la main se corrige à la main. Voici ce que ça implique.
Comment relier une ligne de la base au lien cliqué ?
Par l'adresse email, dans la fenêtre d'attribution de l'espace — trente jours par défaut. Si la personne a cliqué un lien suivi puis donné la même adresse, la vente retrouve son lien. L'identifiant de clic, lui, ne peut pas arriver dans une base Notion sans être capturé en amont : aucune page officielle consultée ne documente une redirection vers une URL externe après l'envoi d'un formulaire Notion, et nous ne prétendons donc pas le contraire.
Comment éviter d'envoyer deux fois la même vente ?
C'est le rôle du champ invoiceId. Mettez-y une valeur stable et propre à la ligne : un numéro de facture, ou une formule qui fabrique un identifiant. Le second passage répond 200 et n'ajoute rien. Sans ce champ, chaque repassage en « payé » compterait une vente de plus.
Le paiement arrive trois semaines après la commande.
Aucun problème pour l'automatisation, qui se déclenche au passage en « payé ». Le sujet est la fenêtre d'attribution : un clic plus ancien qu'elle ne rattache plus. Sur des paiements lents, allongez-la avant de brancher — elle ne rattrape pas le passé.
Un remboursement ?
Subtraq n'accepte pas de montant négatif et n'a pas d'appel d'annulation. Le remboursement ne se soustrait donc pas tout seul : gardez-en la trace par un événement à montant nul, et corrigez le rapport à la main. Mieux vaut cette phrase-là qu'un total faux qu'on découvre devant le client.
Questions fréquentes
Faut-il une intégration Notion à installer ?
Non, pas pour envoyer. L'action webhook fait partie des automatisations de base sur les formules payantes, et elle accepte l'en-tête d'autorisation. Pour recevoir une conversion dans Notion, en revanche, il faut un intermédiaire.
Quel identifiant mettre dans invoiceId si je n'ai pas de numéro de facture ?
N'importe quelle valeur stable et unique à la ligne : un identifiant que vous fabriquez, ou une propriété de formule. L'important n'est pas sa forme mais qu'elle ne change plus.
Le montant doit-il être en centimes ?
Oui, et c'est le piège le plus coûteux de la page : 43 € s'écrit 4300. Subtraq refuse les nombres à virgule sur de l'argent. Une propriété de formule qui multiplie par cent règle la question une fois pour toutes.
Le contenu de la page part-il avec la requête ?
Non. L'action n'inclut que les propriétés de la page, d'après l'aide Notion. Les blocs de la page restent chez vous.
Et un prospect, sans montant ?
La route des ventes attend un montant. Pour un prospect, la voie la plus simple reste le lien Subtraq collé dans le champ de redirection d'un formulaire : l'envoi devient une conversion, sans aucun appel d'API.
Vos ventes arrivent d'ailleurs qu'à la main ?
Si l'encaissement passe par Stripe, ne passez pas par Notion : l'intégration Stripe enregistre chaque paiement toute seule, avec une signature obligatoire.
Le guide StripeLa prochaine ligne passée en « payé » peut dire d'où elle vient
Créez le compte, prenez une clé serveur, ajoutez l'automatisation sur la base. Le reste se passe dans Notion.
Créer un compte gratuit