Mankomail

MyNotary ​

Lit et alimente les dossiers, fiches, contrats et documents de MyNotary. Aucune signature ne peut être lancée par API : elle reste un geste humain.

Le nœud MyNotary lit et alimente les dossiers, fiches, contrats et documents d’une étude ou d’une agence immobilière dans MyNotary. Usages typiques : créer la fiche d’un nouveau client à partir d’un mail, déposer les pièces qu’il a envoyées dans le drive du dossier, suivre qui n’a pas encore signé, et récupérer l’acte signé pour l’envoyer par mail.

Aucune signature ne peut être lancée par l’API MyNotary : l’envoi d’un contrat en signature reste un geste humain dans MyNotary. Le workflow prépare (dossier, fiches, contrat, pièces), une personne envoie en signature, et le déclencheur MyNotary — événement réagit quand la signature est terminée.

Il travaille avec une clé d’API MyNotary enregistrée une fois dans Connexions ; la connexion fixe aussi l’environnement (pré-production ou production). Voir MyNotary pour la créer. La plupart des opérations demandent d’abord le Cabinet (organization) : une clé peut en voir plusieurs, et l’API refuse toute requête sans lui.

En bref ​

  • Type : mynotary.api · version 1
  • Catégorie : Données
  • Nature : Étape — s’exécute pendant une exécution
  • Effet : Écrit à l’extérieur (external_write) — écrit hors de Mankomail ; décrit au lieu d’être fait pendant un essai
  • Exige un mail porteur : Non
  • Connexion : MyNotary
  • Entrées : main
  • Sorties : main

Connexion ​

Ce nœud exige une connexion MyNotary.

Paramètres ​

connection ​

Connexion MyNotary — La connexion MyNotary à employer. Elle se crée une fois dans Connexions ; sa clé n’apparaît jamais dans le workflow.

  • Type : Connexion (credential)
  • Requis : Oui
  • Défaut : "" (vide)

resource ​

Ressource

  • Type : Un choix (options)
  • Requis : Oui
  • Défaut : operation
  • Options :
    • operation — Dossier : La transaction complète. Tous les contrats d’une même affaire y vivent.
    • contract — Contrat : Mandat, offre, compromis, bail — et l’avancement de sa signature.
    • record — Fiche : Une personne, une société, un bien, un lot — réutilisable d’un dossier à l’autre.
    • file — Document : Le drive d’un dossier : y déposer une pièce jointe, en lister ou en relire le contenu.
    • user — Utilisateur : Les collaborateurs de l’étude. Toute création en exige un.
    • webhook — Webhook : L’abonnement aux événements, géré par l’API — aucun écran tiers à ouvrir.

operationOp ​

Opération

  • Type : Un choix (options)
  • Requis : Oui
  • Défaut : list
  • Options :
    • list — Lister les dossiers
    • get — Lire un dossier
    • create — Créer un dossier : MyNotary n’a pas d’idempotence : cherchez avant de créer, sous peine de doublon lors d’une nouvelle tentative.
    • addRecords — Ajouter un intervenant au dossier : Rattache des fiches à un rôle du dossier (vendeur, acquéreur, bien vendu…).
  • Affiché quand : resource vaut operation

contractOp ​

Opération

  • Type : Un choix (options)
  • Requis : Oui
  • Défaut : list
  • Options :
    • list — Lister les contrats d’un dossier
    • get — Lire un contrat
    • create — Créer un contrat depuis un modèle
    • signature — Suivre la signature : Qui a signé, qui n’a pas encore signé, et les documents signés.
  • Affiché quand : resource vaut contract

recordOp ​

Opération

  • Type : Un choix (options)
  • Requis : Oui
  • Défaut : search
  • Options :
    • search — Chercher une fiche : Le rempart contre les doublons : cherchez avant de créer.
    • get — Lire une fiche
    • create — Créer une fiche
    • update — Mettre à jour une fiche
  • Affiché quand : resource vaut record

fileOp ​

Opération

  • Type : Un choix (options)
  • Requis : Oui
  • Défaut : list
  • Options :
    • list — Lister le drive d’un dossier
    • link — Obtenir un lien de téléchargement : Valable sept jours, sans authentification : à traiter comme un secret.
    • download — Récupérer un fichier en pièce jointe : Rapatrie le fichier (un acte signé, une pièce du drive) dans les pièces jointes de l’exécution : un « Composer un mail » peut ensuite le joindre par sa position.
    • upload — Déposer une pièce jointe dans le drive
  • Affiché quand : resource vaut file

webhookOp ​

Opération

  • Type : Un choix (options)
  • Requis : Oui
  • Défaut : list
  • Options :
    • list — Lister les webhooks
    • create — Créer un webhook
    • delete — Supprimer un webhook
  • Affiché quand : resource vaut webhook

organization ​

Cabinet — Le cabinet MyNotary visé. Une clé d’application en voit plusieurs, et l’API refuse toute requête sans lui.

  • Type : Ressource distante (resourceLocator)
  • Requis : Oui
  • Façons de choisir : dans une liste, saisir un identifiant (mynotary.organization)
  • Listé avec la connexion de : connection
  • Affiché quand : resource vaut l’une de operation, contract, record, file, user

operationRef ​

Dossier

  • Type : Ressource distante (resourceLocator)
  • Requis : Oui
  • Façons de choisir : dans une liste, saisir un identifiant, coller une URL (mynotary.operation)
  • Listé à l’intérieur de : organization
  • Listé avec la connexion de : connection
  • Affiché quand : ((resource vaut operation et operationOp vaut l’une de get, addRecords) ou (resource vaut contract et contractOp vaut l’une de list, create) ou (resource vaut file et fileOp vaut l’une de list, upload))

operationType ​

Type de dossier — Vente dans l’ancien, bail d’habitation, VEFA… Les types personnalisés de l’étude apparaissent aussi.

  • Type : Ressource distante (resourceLocator)
  • Requis : Non
  • Façons de choisir : dans une liste, saisir un identifiant (mynotary.operationType)
  • Listé à l’intérieur de : organization
  • Listé avec la connexion de : connection
  • Affiché quand : ((resource vaut operation et operationOp vaut l’une de list, create) ou (resource vaut contract et contractOp vaut l’une de create))

contractModel ​

Modèle de contrat

  • Type : Ressource distante (resourceLocator)
  • Requis : Oui
  • Façons de choisir : dans une liste, saisir un identifiant (mynotary.contractModel)
  • Listé à l’intérieur de : operationType
  • Listé avec la connexion de : connection
  • Affiché quand : resource vaut contract et contractOp vaut l’une de create

creator ​

Au nom de — Le collaborateur qui crée. MyNotary n’a pas de compte de service : un acte est toujours créé par quelqu’un.

  • Type : Ressource distante (resourceLocator)
  • Requis : Oui
  • Façons de choisir : dans une liste, saisir un identifiant (mynotary.user)
  • Listé à l’intérieur de : organization
  • Listé avec la connexion de : connection
  • Affiché quand : ((resource vaut operation et operationOp vaut l’une de create) ou (resource vaut contract et contractOp vaut l’une de create) ou (resource vaut record et recordOp vaut l’une de create))

recordType ​

Type de fiche

  • Type : Ressource distante (resourceLocator)
  • Requis : Non
  • Façons de choisir : dans une liste, saisir un identifiant (mynotary.recordType)
  • Listé avec la connexion de : connection
  • Affiché quand : resource vaut record et recordOp vaut l’une de search, create

contractId ​

Contrat — L’identifiant du contrat, tel qu’un webhook ou la liste des contrats le rend.

  • Type : Texte (string)
  • Requis : Oui
  • Défaut : "" (vide)
  • 64 caractères au plus
  • Exemple : {{ data.mynotary.contractId }}
  • Affiché quand : resource vaut contract et contractOp vaut l’une de get, signature
  • Expressions : {{ }} accepté

recordId ​

Fiche

  • Type : Texte (string)
  • Requis : Oui
  • Défaut : "" (vide)
  • 64 caractères au plus
  • Affiché quand : resource vaut record et recordOp vaut l’une de get, update
  • Expressions : {{ }} accepté

fileId ​

Fichier — L’identifiant du fichier (signedFileId d’une signature, fileId du drive).

  • Type : Texte (string)
  • Requis : Oui
  • Défaut : "" (vide)
  • 128 caractères au plus
  • Affiché quand : resource vaut file et fileOp vaut l’une de link, download
  • Expressions : {{ }} accepté

downloadName ​

Nom du fichier — Facultatif : le nom sous lequel la pièce sera jointe. Vide : celui que MyNotary donne.

  • Type : Texte (string)
  • Requis : Non
  • Défaut : "" (vide)
  • 255 caractères au plus
  • Affiché quand : resource vaut file et fileOp vaut l’une de download
  • Expressions : {{ }} accepté

maxDownloadMb ​

Taille maximale (Mo)

  • Type : Nombre (number)
  • Requis : Non
  • Défaut : 10
  • Nombre entier, de 1 à 10
  • Affiché quand : resource vaut file et fileOp vaut l’une de download

webhookId ​

Webhook

  • Type : Texte (string)
  • Requis : Oui
  • Défaut : "" (vide)
  • 64 caractères au plus
  • Affiché quand : resource vaut webhook et webhookOp vaut l’une de delete
  • Expressions : {{ }} accepté

label ​

Libellé — Le nom sous lequel l’étude retrouvera le dossier ou le contrat. Accepte des expressions {{ }}.

  • Type : Texte (string)
  • Requis : Non
  • Défaut : "" (vide)
  • 200 caractères au plus
  • Exemple : 12 rue des Lilas — Dupont
  • Affiché quand : ((resource vaut operation et operationOp vaut l’une de create) ou (resource vaut contract et contractOp vaut l’une de create))
  • Expressions : {{ }} accepté

branch ​

Rôle — Le rôle des fiches dans le dossier, tel que MyNotary le nomme : VENDEUR, ACQUEREUR, BIEN_VENDU, OFFRANT… La liste dépend du type de dossier et n’est pas énumérée par l’API.

  • Type : Texte (string)
  • Requis : Oui
  • Défaut : "" (vide)
  • 64 caractères au plus
  • Exemple : VENDEUR
  • Affiché quand : resource vaut operation et operationOp vaut l’une de addRecords
  • Expressions : {{ }} accepté

recordIds ​

Fiches à rattacher — Un ou plusieurs identifiants de fiche, séparés par des virgules.

  • Type : Texte (string)
  • Requis : Oui
  • Défaut : "" (vide)
  • 500 caractères au plus
  • Affiché quand : resource vaut operation et operationOp vaut l’une de addRecords
  • Expressions : {{ }} accepté

questions ​

Champs (JSON) — Les réponses au formulaire, par identifiant de question : {"nom":"Dupont","prenoms":"Marie"}. Les identifiants viennent de GET /records/description ou GET /operations/description. Une date s’écrit 2026-03-16, jamais avec une heure — MyNotary l’ignorerait en silence.

  • Type : Texte long (text)
  • Requis : Non
  • Défaut : "" (vide)
  • 20000 caractères au plus
  • Exemple : { "nom": "Dupont" }
  • Affiché quand : ((resource vaut operation et operationOp vaut l’une de create) ou (resource vaut contract et contractOp vaut l’une de create) ou (resource vaut record et recordOp vaut l’une de create, update))
  • Expressions : {{ }} accepté

documents ​

Documents (JSON) — Les pièces déjà déposées, par identifiant de document : {"carte_identite":[{"fileId":"…"}]}. Le fileId vient d’un dépôt préalable (opération « Déposer une pièce jointe »).

  • Type : Texte long (text)
  • Requis : Non
  • Défaut : "" (vide)
  • 20000 caractères au plus
  • Affiché quand : ((resource vaut operation et operationOp vaut l’une de create) ou (resource vaut contract et contractOp vaut l’une de create) ou (resource vaut record et recordOp vaut l’une de create, update))
  • Expressions : {{ }} accepté

attachmentPosition ​

Pièce jointe (position) — La position de la pièce jointe à déposer : une pièce du mail (1 pour la première) ou un fichier ajouté par une étape précédente ({{ data.<étape>.attachmentPosition }}). Les octets ne traversent jamais le workflow.

  • Type : Nombre (number)
  • Requis : Non
  • Défaut : 1
  • Nombre entier, de 1 à 2000000
  • Affiché quand : resource vaut file et fileOp vaut l’une de upload

fileName ​

Nom du fichier — Vide : le nom de la pièce jointe. MyNotary contrôle et assainit les PDF, et refuse ce qu’il ne sait pas lire.

  • Type : Texte (string)
  • Requis : Non
  • Défaut : "" (vide)
  • 200 caractères au plus
  • Affiché quand : resource vaut file et fileOp vaut l’une de upload
  • Expressions : {{ }} accepté

webhookUrl ​

URL de réception — L’URL absolue du déclencheur, copiée depuis la fiche du nœud « MyNotary — événement » (affichée après publication). MyNotary y enverra tous les événements de tous vos cabinets : le tri se fait chez nous.

  • Type : Texte (string)
  • Requis : Oui
  • Défaut : "" (vide)
  • 500 caractères au plus
  • Exemple : https://…/hooks/wf/…
  • Affiché quand : resource vaut webhook et webhookOp vaut l’une de create
  • Expressions : {{ }} accepté

operationSearch ​

Le libellé contient

  • Type : Texte (string)
  • Requis : Non
  • Défaut : "" (vide)
  • 200 caractères au plus
  • Affiché quand : resource vaut operation et operationOp vaut l’une de list
  • Expressions : {{ }} accepté

Rechercher — Insensible à la casse et aux accents. Tous les mots doivent être trouvés.

  • Type : Texte (string)
  • Requis : Non
  • Défaut : "" (vide)
  • 200 caractères au plus
  • Exemple : dupont marie
  • Affiché quand : resource vaut record et recordOp vaut l’une de search
  • Expressions : {{ }} accepté

searchFields ​

Champs cherchés — Obligatoire dès qu’une recherche est saisie, sinon MyNotary répond 400. Dix identifiants au plus : nom,prenoms,email,telephone pour une personne, siren,personne_morale_denomination pour une société.

  • Type : Texte (string)
  • Requis : Non
  • Défaut : nom,prenoms,email
  • 300 caractères au plus
  • Exemple : nom,prenoms,email
  • Affiché quand : resource vaut record et recordOp vaut l’une de search
  • Expressions : {{ }} accepté

updatedSince ​

Modifiées depuis le — Une date 2026-09-22. Le seul filtre incrémental de l’API : GET /operations n’a pas d’équivalent.

  • Type : Texte (string)
  • Requis : Non
  • Défaut : "" (vide)
  • 10 caractères au plus
  • Affiché quand : resource vaut record et recordOp vaut l’une de search
  • Expressions : {{ }} accepté

fetchAll ​

Tout récupérer — Suit les pages jusqu’au plafond de sécurité. Décoché, seule la première page est lue.

  • Type : Oui / non (boolean)
  • Requis : Non
  • Défaut : false
  • Affiché quand : ((resource vaut operation et operationOp vaut l’une de list) ou (resource vaut record et recordOp vaut l’une de search))

limit ​

Nombre maximum

  • Type : Nombre (number)
  • Requis : Non
  • Défaut : 50
  • Nombre entier, de 1 à 300
  • Affiché quand : ((resource vaut operation et operationOp vaut l’une de list) ou (resource vaut record et recordOp vaut l’une de search))

Sorties ​

  • main — Empruntée une fois l’opération MyNotary réussie. Une réponse d’erreur de MyNotary fait échouer l’étape à la place.

Données produites ​

Ce que ce nœud ajoute aux données de l’exécution, et comment le lire dans une expression. <step> désigne la clé de l’étape : le nom du nœud ramené à un identifiant (voir Données et expressions).

  • {{ data.<step>.operations }} — array of { id, label, type, link, archived, creationTime, records, mergedFrom }. Lister les dossiers seulement : les dossiers trouvés. records associe à chaque rôle du dossier ses identifiants de fiches (par exemple { "VENDEUR": [123] }), mergedFrom liste les dossiers fusionnés dans celui-ci, link ouvre le dossier dans MyNotary.
  • {{ data.<step>.operation }} — { id, label, type, link, archived, creationTime, records, mergedFrom }. Lire un dossier seulement : le dossier lu.
  • {{ data.<step>.contracts }} — array of { id, model, label, link, status, signatureType, signatureTime, creationTime, signatureId, signed }. Lire un dossier et Lister les contrats d’un dossier : les contrats du dossier. signed vaut true quand status vaut SIGNATURE_COMPLETED.
  • {{ data.<step>.documents }} — object. Lire un dossier seulement : les documents du dossier, en identifiants de fichiers par identifiant de document.
  • {{ data.<step>.count }} — number. Le nombre d’éléments concernés : dossiers, contrats, fiches, fichiers du drive, utilisateurs, webhooks, ou fiches rattachées par Ajouter un intervenant au dossier.
  • {{ data.<step>.truncated }} — boolean. Lister les dossiers et Chercher une fiche : true quand il existait plus d’éléments que la borne ne le permettait.
  • {{ data.<step>.operationId }} — string. Créer un dossier : l’identifiant du nouveau dossier (vide en essai). Ajouter un intervenant au dossier et Déposer une pièce jointe du mail dans le drive : le dossier concerné.
  • {{ data.<step>.link }} — string. Créer un dossier, Créer un contrat depuis un modèle, Créer une fiche : le lien MyNotary du nouvel objet, vide en essai.
  • {{ data.<step>.created }} — boolean. Créer un dossier, Créer un contrat depuis un modèle, Créer une fiche, Créer un webhook : true quand l’objet a été créé, false en essai.
  • {{ data.<step>.branch }} — string. Ajouter un intervenant au dossier seulement : le rôle employé, en majuscules.
  • {{ data.<step>.recordIds }} — array of string. Ajouter un intervenant au dossier seulement : les identifiants des fiches rattachées.
  • {{ data.<step>.pendingCount }} — number. Lister les contrats d’un dossier seulement : le nombre de contrats dont le statut commence par SIGNATURE_.
  • {{ data.<step>.contract }} — { id, model, label, link, status, signatureType, signatureTime, creationTime, signatureId, signed }. Lire un contrat et Suivre la signature : le contrat lu.
  • {{ data.<step>.status }} — string. Lire un contrat et Suivre la signature : le statut du contrat.
  • {{ data.<step>.signed }} — boolean. Lire un contrat seulement : true quand le contrat est signé (SIGNATURE_COMPLETED).
  • {{ data.<step>.contractId }} — string. Créer un contrat depuis un modèle seulement : l’identifiant du nouveau contrat, vide en essai.
  • {{ data.<step>.model }} — string. Créer un contrat depuis un modèle seulement : le modèle de contrat employé.
  • {{ data.<step>.signatureStatus }} — string. Suivre la signature seulement : le statut de la signature en cours, vide quand le contrat n’a jamais été envoyé en signature.
  • {{ data.<step>.signatureTime }} — string. Suivre la signature seulement : l’heure d’achèvement de la signature, quand il y en a une.
  • {{ data.<step>.signatories }} — array of { name, email, role, signedAt, signed }. Suivre la signature seulement : tous les signataires, avec l’indication de leur signature.
  • {{ data.<step>.pending }} — array of { name, email, role, signedAt, signed }. Suivre la signature seulement : les signataires qui n’ont pas encore signé.
  • {{ data.<step>.pendingEmails }} — array of string. Suivre la signature seulement : les adresses des signataires qui n’ont pas encore signé.
  • {{ data.<step>.signedFileIds }} — array of string. Suivre la signature seulement : les identifiants de fichiers des documents signés, prêts pour Récupérer un fichier en pièce jointe.
  • {{ data.<step>.records }} — array of { id, type, questions, documents, lastUpdate }. Chercher une fiche seulement : les fiches trouvées. questions porte les réponses du formulaire par identifiant de question, documents les identifiants de fichiers par identifiant de document.
  • {{ data.<step>.found }} — boolean. Chercher une fiche seulement : true quand au moins une fiche a été trouvée.
  • {{ data.<step>.recordId }} — string. Chercher une fiche : l’identifiant de la première fiche trouvée. Créer une fiche : l’identifiant de la nouvelle fiche (vide en essai). Mettre à jour une fiche : la fiche mise à jour.
  • {{ data.<step>.record }} — { id, type, questions, documents, lastUpdate }. Lire une fiche seulement : la fiche lue.
  • {{ data.<step>.associations }} — array. Lire une fiche seulement : les liens de la fiche avec d’autres fiches (mariage, tutelle, copropriété…), tels que MyNotary les rend.
  • {{ data.<step>.type }} — string. Créer une fiche seulement : le type de fiche employé.
  • {{ data.<step>.updated }} — boolean. Mettre à jour une fiche seulement : true quand la mise à jour a été envoyée, false en essai.
  • {{ data.<step>.fields }} — array of string. Mettre à jour une fiche seulement : les identifiants de questions envoyés.
  • {{ data.<step>.files }} — array of { driveFileId, fileId, name, addedAt }. Lister le drive d’un dossier seulement : les fichiers du drive du dossier. fileId est ce qu’attendent Obtenir un lien de téléchargement et Récupérer un fichier en pièce jointe.
  • {{ data.<step>.fileId }} — string. Obtenir un lien de téléchargement, Récupérer un fichier en pièce jointe : le fichier concerné. Déposer une pièce jointe du mail dans le drive : l’identifiant du fichier envoyé (vide en essai).
  • {{ data.<step>.downloadUrl }} — string. Obtenir un lien de téléchargement seulement : un lien de téléchargement qui ne demande aucune authentification. À traiter comme un secret.
  • {{ data.<step>.expiresInDays }} — number. Obtenir un lien de téléchargement seulement : la durée de validité du lien, toujours 7.
  • {{ data.<step>.attachmentPosition }} — number. Récupérer un fichier en pièce jointe seulement : la position du fichier dans les pièces jointes de l’exécution, prête pour une étape Rédiger.
  • {{ data.<step>.filename }} — string. Récupérer un fichier en pièce jointe seulement : le nom du fichier récupéré.
  • {{ data.<step>.mime }} — string. Récupérer un fichier en pièce jointe seulement : le type MIME du fichier récupéré.
  • {{ data.<step>.size }} — number. Récupérer un fichier en pièce jointe seulement : la taille du fichier récupéré, en octets.
  • {{ data.<step>.deduplicated }} — boolean. Récupérer un fichier en pièce jointe seulement : true quand un fichier identique figurait déjà dans les pièces jointes de l’exécution ; sa position est reprise.
  • {{ data.<step>.driveFileId }} — string. Déposer une pièce jointe du mail dans le drive seulement : l’identifiant du fichier dans le drive du dossier (vide en essai).
  • {{ data.<step>.name }} — string. Déposer une pièce jointe du mail dans le drive seulement : le nom du fichier dans le drive.
  • {{ data.<step>.position }} — number. Déposer une pièce jointe du mail dans le drive seulement : la position de la pièce jointe envoyée.
  • {{ data.<step>.users }} — array of { id, firstName, lastName, email, role }. Ressource Utilisateur seulement : les collaborateurs du cabinet.
  • {{ data.<step>.webhooks }} — array of { id, url, authType }. Lister les webhooks seulement : les abonnements webhook de la clé.
  • {{ data.<step>.webhookId }} — string. Créer un webhook et Supprimer un webhook : l’identifiant de l’abonnement (vide en essai pour une création).
  • {{ data.<step>.url }} — string. Créer un webhook seulement : l’URL de réception enregistrée.
  • {{ data.<step>.deleted }} — boolean. Supprimer un webhook seulement : true quand la suppression a été envoyée, false en essai.
  • {{ data.<step>.simulated }} — boolean. true quand une écriture a été décrite au lieu d’être faite (essai). Les lectures ne sont jamais simulées.
  • {{ data.<step>.summary }} — string. Le résumé d’une ligne dans la langue du membre, par exemple « 2 fiches trouvées. » (avec summaryKey et summaryParams).

Opérations ​

Le nœud demande d’abord une Ressource (resource), puis l’opération propre à cette ressource.

Dossier (resource: operation, opération dans operationOp) ​

  • Lister les dossiers (list, le défaut). Liste les dossiers du cabinet (GET /operations), filtrés par Type de dossier (operationType) et Le libellé contient (operationSearch). Lit Nombre maximum éléments (limit, de 1 à 300, 50 par défaut), ou jusqu’à 300 avec Tout récupérer (fetchAll). Publie operations, count, truncated.
  • Lire un dossier (get). Lit le dossier choisi dans Dossier (operationRef), avec ses contrats et ses documents. Publie operation, contracts, documents, count.
  • Créer un dossier (create). Crée un dossier de Type de dossier au nom de Au nom de (creator), avec Libellé (label), Champs (JSON) (questions) et Documents (JSON) (documents) (POST /operations). Publie operationId, link, created.
  • Ajouter un intervenant au dossier (addRecords). Rattache les fiches listées dans Fiches à rattacher (recordIds, séparées par des virgules) au Rôle (branch) du dossier, par exemple VENDEUR ou ACQUEREUR (POST /operations/{id}/records). Publie operationId, branch, recordIds, count.

Contrat (resource: contract, opération dans contractOp) ​

  • Lister les contrats d’un dossier (list, le défaut). Lit le dossier et rend ses contrats. Publie contracts, count, pendingCount.
  • Lire un contrat (get). Lit le contrat dont l’identifiant est dans Contrat (contractId). Publie contract, status, signed.
  • Créer un contrat depuis un modèle (create). Crée un contrat dans Dossier à partir de Modèle de contrat (contractModel, listé sous le Type de dossier choisi), au nom de Au nom de, avec Libellé, Champs (JSON) et Documents (JSON) (POST /contracts). Publie contractId, link, model, created.
  • Suivre la signature (signature). Lit le contrat puis, s’il a été envoyé en signature, sa signature (GET /signatures/{id}). Publie contract, status, signatureStatus, signatureTime, signatories, pending, pendingEmails, signedFileIds. Un contrat jamais envoyé en signature rend des listes vides et un signatureStatus vide.

Fiche (resource: record, opération dans recordOp) ​

  • Chercher une fiche (search, le défaut). Cherche dans les fiches du cabinet (GET /records) avec Rechercher (search, insensible à la casse et aux accents, tous les mots doivent être trouvés) dans Champs cherchés (searchFields, nom,prenoms,email par défaut), filtrées par Type de fiche (recordType) et Modifiées depuis le (updatedSince, une date 2026-09-22). Nombre maximum et Tout récupérer comme pour Lister les dossiers. Publie records, count, found, recordId, truncated.
  • Lire une fiche (get). Lit la fiche de Fiche (recordId). Publie record, associations.
  • Créer une fiche (create). Crée une fiche de Type de fiche au nom de Au nom de, avec Champs (JSON) et Documents (JSON) (POST /records). Publie recordId, link, type, created.
  • Mettre à jour une fiche (update). Envoie Champs (JSON) et Documents (JSON) à la fiche (PUT /records/{id}). Seules les réponses envoyées changent ; une question envoyée avec une valeur vide est effacée. Publie recordId, updated, fields.

Document (resource: file, opération dans fileOp) ​

  • Lister le drive d’un dossier (list, le défaut). Liste les fichiers du drive de Dossier (GET /drive-files). Publie files, count.
  • Obtenir un lien de téléchargement (link). Demande à MyNotary un lien frais pour Fichier (fileId). Publie fileId, downloadUrl, expiresInDays.
  • Récupérer un fichier en pièce jointe (download). Obtient un lien frais pour Fichier, télécharge le fichier et l’ajoute aux pièces jointes de l’exécution, sous Nom du fichier (downloadName) ou le nom donné par MyNotary, dans la limite de Taille maximale (Mo) (maxDownloadMb). Publie fileId, attachmentPosition, filename, mime, size, deduplicated.
  • Déposer une pièce jointe dans le drive (upload). Envoie la pièce de position Pièce jointe (position) (attachmentPosition : 1 pour la première pièce du mail, ou {{ data.<étape>.attachmentPosition }} pour un fichier ajouté par une étape précédente) à MyNotary (POST /files, en multipart), sous Nom du fichier (fileName) ou le nom de la pièce, puis la range dans le drive de Dossier (POST /drive-files). Publie fileId, driveFileId, name, operationId, position.

Utilisateur (resource: user) ​

Liste les collaborateurs du Cabinet (GET /users). Cette ressource n’a qu’une opération. Publie users, count.

Webhook (resource: webhook, opération dans webhookOp) ​

  • Lister les webhooks (list, le défaut). Publie webhooks, count.
  • Créer un webhook (create). Abonne URL de réception (webhookUrl), l’URL affichée sur le déclencheur MyNotary — événement, aux événements de la clé (POST /webhooks). Publie webhookId, url, created.
  • Supprimer un webhook (delete). Supprime l’abonnement de Webhook (webhookId). Publie webhookId, deleted.

Chaque opération publie aussi simulated et summary.

Exemple ​

Quand un compromis est entièrement signé, l’acte signé doit partir par mail à la banque de l’acquéreur. Le workflow démarre sur le déclencheur MyNotary — événement, dont les données vivent sous data.mynotary. Un premier nœud MyNotary, nommé « Signature », suit le contrat :

text
resource     contract
contractOp   signature
contractId   {{ data.mynotary.contractId }}

Il publie notamment :

json
{
  "status": "SIGNATURE_COMPLETED",
  "pending": [],
  "pendingEmails": [],
  "signedFileIds": ["f6c1d2e3-…"],
  "simulated": false
}

Un second nœud MyNotary, nommé « Acte signé », rapatrie le fichier dans l’exécution :

text
resource       file
fileOp         download
fileId         {{ data.signature.signedFileIds.0 }}
downloadName   Compromis — {{ data.mynotary.contractId }}.pdf
maxDownloadMb  10

Ses données donnent {{ data.acte_signe.attachmentPosition }}, qu’une étape Rédiger emploie pour joindre l’acte. Le même Suivre la signature, lancé chaque lundi par un déclencheur Planification, fournit pendingEmails pour relancer les signataires retardataires.

Conseils ​

  • Pas d’idempotence : cherchez avant de créer. MyNotary n’offre ni clé d’idempotence ni « créer si absent ». Si le moteur retente Créer un dossier, Créer un contrat depuis un modèle ou Créer une fiche après un incident, un second objet est créé. Lancez d’abord Chercher une fiche et aiguillez sur {{ data.<step>.found }} avec une Condition (Si), ou tenez la correspondance dans une table. Ajouter un intervenant, Déposer une pièce jointe et Créer un webhook ne sont pas protégés non plus.
  • Champs (JSON). Les réponses sont indexées par identifiant de question MyNotary ({"nom":"Dupont","prenoms":"Marie"}), les documents par identifiant de document ({"carte_identite":[{"fileId":"…"}]}, le fileId venant d’un Déposer une pièce jointe du mail dans le drive préalable). Écrivez une date 2026-03-16, jamais avec une heure : MyNotary l’ignorerait en silence. Un JSON invalide, ou qui n’est pas un objet, fait échouer l’étape avec node_invalid_param.
  • Chercher une fiche. Champs cherchés est obligatoire dès que Rechercher est rempli (dix identifiants au plus, comme nom,prenoms,email,telephone pour une personne ou siren,personne_morale_denomination pour une société) ; sans lui, l’étape échoue avec node_invalid_param. Modifiées depuis le est le seul filtre incrémental de l’API : Lister les dossiers n’en a pas.
  • Les liens sont des secrets. Un lien d’Obtenir un lien de téléchargement ne demande aucune authentification et reste valable sept jours. Pour joindre un fichier à un mail, utilisez Récupérer un fichier en pièce jointe : le lien n’apparaît jamais dans les données d’étape.
  • Taille des fichiers. La Taille maximale (Mo) va de 1 à 10, la limite réelle du serveur par fichier téléchargé. Une pièce jointe envoyée est elle aussi limitée à 10 Mio, vérifiés avant tout envoi à MyNotary (attachment.too_large). Une position de pièce jointe qui n’existe pas échoue avec attachment.not_found.
  • Modèles de contrat. La liste des modèles dépend du Type de dossier : changer de type de dossier vide Modèle de contrat.
  • Webhooks. MyNotary envoie tous les événements de tous les cabinets rattachés à la clé à l’URL abonnée ; c’est le déclencheur qui trie. L’abonnement est créé sans authentification : la preuve d’origine est le jeton secret de l’URL du déclencheur.
  • Essais. En essai, toutes les lectures partent pour de bon, y compris Récupérer un fichier en pièce jointe. Créations, mises à jour, dépôt dans le drive et changements de webhooks sont seulement décrits : rien n’est écrit dans MyNotary, simulated vaut true et aucun identifiant ni lien n’est rendu. En particulier, Déposer une pièce jointe du mail dans le drive s’arrête avant le rangement dans le drive.
  • Données du déclencheur. Dans un workflow démarré par le déclencheur MyNotary, les données du déclencheur vivent sous data.mynotary. N’y nommez pas ce nœud « MyNotary » : ses données ne seraient plus joignables que par l’identifiant du nœud.
  • Erreurs. integration.unauthorized : la clé a été refusée ou révoquée. integration.not_found : le dossier, le contrat, la fiche ou le fichier n’existe pas pour cette clé. integration.rejected : MyNotary a refusé la requête (par exemple une réponse ou un rôle qu’il n’accepte pas). integration.rate_limited et integration.unavailable sont retentées automatiquement : les requêtes sont cadencées à 300 par minute et par connexion, et une réponse 409, 429 ou 5xx a droit à trois tentatives avant que le moteur ne reprenne l’étape plus tard. Voir Gestion des erreurs.