L'API publique de Tomorro permet d'échanger des données entre Tomorro et les logiciels que vos équipes utilisent déjà : CRM, ERP, SIRH, entrepôt de données, plateforme d'automatisation (Make, Zapier, n8n) ou application interne.
C'est une API REST : vous pouvez lire, rechercher, créer et mettre à jour des contrats, des cocontractants, des clauses, des membres et d'autres objets depuis vos propres outils, sans que personne n'ait à ressaisir les données dans Tomorro.
Documentation technique : https://alpha.developer.tomorro.com/quickstart
Vous y trouverez chaque endpoint, ses paramètres et des exemples de requêtes. Cette documentation est disponible en anglais uniquement.
Ce que vous pouvez faire avec l'API
Contrats
Lister et rechercher des contrats, avec des filtres sur le statut, le type de contrat, le cocontractant ou les dates.
Récupérer un contrat avec ses champs, ses signataires et ses participants, ou sa version consolidée, dont les valeurs tiennent compte de ses avenants.
Lister les clauses rattachées à un contrat.
Télécharger le document de travail en cours, les documents en cours de signature, ou les PDF signés.
Créer un contrat à partir d'un type de contrat et d'un modèle, pré-rempli avec ses champs, son cocontractant et ses signataires, en un seul appel.
Mettre à jour un contrat : champs, cocontractant, signataires, participants.
Déposer une nouvelle version du document, ou ajouter une pièce jointe.
Envoyer un contrat en signature, ou annuler une signature en cours.
Marquer un contrat comme signé à partir de PDF signés dans un autre outil.
Lister les dossiers de la contrathèque accessibles à votre clé, lire un dossier avec les identifiants des contrats qui y sont rangés et, avec la clé d'un administrateur, créer, renommer, déplacer ou supprimer un dossier, selon les options activées pour votre organisation.
Cocontractants
Lister et rechercher des cocontractants, récupérer la fiche d'un cocontractant.
Créer un cocontractant, le mettre à jour (nom, statut, champs) ou l'archiver.
Types de contrat et modèles
Lister les types de contrat de votre organisation.
Lister les modèles d'un type de contrat, par langue, et lire le contenu d'un modèle.
Récupérer le formulaire de création d'un type de contrat, c'est-à-dire les champs nécessaires pour créer un contrat.
Champs personnalisés
Lister les champs personnalisés configurés sur vos contrats.
Lister les options d'un champ de type liste déroulante ou liste à choix multiples.
Objets personnalisés
Lister les objets personnalisés et récupérer l'un d'eux avec ses champs.
Lister, créer ou mettre à jour les enregistrements qu'un contrat porte pour un objet personnalisé.
Clauses
Lister la bibliothèque de clauses, récupérer une clause avec son contenu, ajouter une clause.
Membres
Lister les membres, avec des filtres sur le rôle, le statut ou l'adresse e-mail, et récupérer un membre.
Créer un membre, avec ou sans e-mail d'invitation.
Mettre à jour le rôle, le statut, les groupes ou les dossiers d'un membre.
Consulter, définir ou lever une période d'absence.
Pièces jointes et documents
Obtenir un lien de dépôt sécurisé pour envoyer un fichier avant de le rattacher à un contrat : nouvelle version, pièce jointe ou PDF signés.
Organisation et journal d'audit
Récupérer l'organisation à laquelle la clé d'API est rattachée.
Lister les événements du journal d'audit, lorsque le journal d'audit est activé pour votre organisation.
Qui peut utiliser l'API
L'accès se fait par une clé d'API. Chaque clé appartient à un membre de votre organisation, et l'API ne voit et ne modifie que ce que ce membre est déjà autorisé à voir et à modifier dans Tomorro.
La clé se génère depuis les paramètres de Tomorro, page Intégrations, carte API, bouton Générer une clé d'API.
Avec les rôles standard, les rôles Administrateur, Manager et Contributeur peuvent générer une clé. Les rôles Lecteur et Signataire ne le peuvent pas. Avec l'option Rôles personnalisés, il faut un rôle dont la permission Intégrations porte l'action Utiliser.
L'accès à l'API peut varier selon le plan de votre organisation ; si vous avez des questions sur sa disponibilité, veuillez contacter votre chargé de compte.
Gardez votre clé secrète. Toute modification faite par l'API est une modification réelle dans votre espace de travail, exactement comme si le membre l'avait faite lui-même dans Tomorro. Ne partagez jamais une clé dans du code exécuté côté navigateur, dans un dépôt public ou dans un document partagé.
Pour le détail des rôles et des permissions : Rôles et permissions des utilisateurs dans Tomorro
Les bases techniques
Adresse de base | |
Authentification | Votre clé d'API, dans l'en-tête x-api-key |
Format | JSON |
Versions | Versions datées, envoyées dans l'en-tête tomorro-version, par exemple 2025-01-29.alpha. Sans cet en-tête, la dernière version est utilisée. |
Pagination | Par curseur : limit (20 par défaut, 50 au maximum), after, before |
Tri et filtres | Paramètre sort, et filtres de la forme status=in:draft,negotiating ou startAt=gte:2024-01-01 |
Limite de débit | Un nombre d'appels trop élevé renvoie une réponse 429 Too Many Requests : réessayez après un délai croissant |
Chaque version garde le même comportement une fois publiée. Lorsqu'une version est dépréciée, les réponses portent un en-tête x-api-deprecation-warning et une date de retrait dans l'en-tête sunset ; passé cette date, la version renvoie 410 Gone.
Être prévenu en temps réel
Plutôt que d'appeler l'API régulièrement pour détecter les changements, vous pouvez recevoir un webhook : Tomorro envoie une requête HTTPS à l'adresse de votre choix dès qu'un événement a lieu, par exemple la création d'un contrat ou sa signature complète.
Les événements disponibles, la configuration et la vérification de l'authenticité des requêtes sont décrits ici : Webhooks
Cas d'usage courants
Créer des contrats depuis vos outils. Un utilisateur demande un contrat depuis le CRM ou l'ERP : l'intégration lit les champs nécessaires du type de contrat, puis crée dans Tomorro un contrat pré-rempli, prêt à être envoyé en signature.
Garder les cocontractants synchronisés. Les fournisseurs, clients ou partenaires créés ou mis à jour dans votre ERP ou votre CRM sont créés ou mis à jour dans Tomorro, et inversement, en utilisant l'identifiant du cocontractant Tomorro comme clé commune.
Remonter les données de contrat dans vos outils. Lorsqu'un contrat est créé, signé ou change de statut, l'intégration récupère son détail et met à jour la fiche correspondante dans votre CRM, votre ERP ou votre outil de reporting.
Archiver les documents signés. Lorsqu'un contrat est signé, le PDF signé et ses données sont déposés dans votre gestion documentaire, votre stockage cloud ou votre entrepôt de données.
Utiliser votre propre outil de signature. Les contrats signés dans un outil tiers sont marqués comme signés dans Tomorro, avec leurs PDF signés.
Générer les contrats de travail depuis votre SIRH. L'arrivée d'un collaborateur dans le SIRH crée un contrat de travail à partir d'un modèle et l'envoie en signature.
Pour cadrer votre besoin avant de regarder la faisabilité technique : Définir mon besoin d'intégration non-native
Limites à connaître
Les zones de signature ne se posent pas par l'API. Si le document ne porte pas de zone de signature pour un signataire, l'envoi en signature échoue : ouvrez le contrat dans Tomorro, choisissez Préparer la signature, puis ajoutez les zones à l'étape Préparation du document.
Un contrat déjà en cours de signature, signé ou annulé ne peut pas être renvoyé en signature.
Les emplacements de signataire laissés vides par le modèle se remplissent chacun de leur côté : un emplacement interne attend un membre Tomorro, un emplacement externe attend une adresse e-mail.
Les champs de type liste attendent l'une des options configurées dans Tomorro ; une valeur inconnue est refusée.
Le filtre par type de contrat accepte un seul type de contrat par requête : faites une requête par type et rassemblez les résultats de votre côté.
À la création d'un membre, les rôles disponibles incluent Contributeur, Manager et Administrateur.
Une absence peut être consultée pour n'importe quel membre, mais ne peut être définie ou levée que pour le membre propriétaire de la clé d'API.
Le journal d'audit n'est accessible qu'aux administrateurs, lorsqu'il est activé pour votre organisation.
Les enregistrements d'objets personnalisés nécessitent les tableaux dynamiques.
Il n'existe pas d'appel pour supprimer un contrat, un cocontractant ou un membre.
Piloter l'API depuis un assistant IA
Les mêmes capacités sont accessibles en langage naturel depuis Claude, ChatGPT, Gemini, Copilot ou Dust, sans projet d'intégration : Installation et connexion du MCP Tomorro
