Aller au contenu
Documentation

Créer le parcours

Créer un parcours vide, en brouillon, et en régler le nom, la durée de validité et les relances.

2 min de lecture Mise à jour le 9 novembre 2026
POST https://staging-api.docage.com/Transactions
Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9…
Content-Type: application/json

{
  "Name": "Contrat avec Atelier Lumière",
  "DaysBeforeEnding": 15,
  "Reminder": 2,
  "MaximumReminders": 3
}

La réponse est l'identifiant du parcours, en chaîne JSON :

JSON
"cccccccc-0000-4000-8000-000000000003"

Le parcours est un brouillon (GlobalStatus à 0) : personne n'est invité tant qu'il n'est pas lancé.

Les réglages

Propriété Ce qu'elle règle
Name Le nom du parcours, 255 caractères au plus.
DaysBeforeEnding Sa durée de validité, en jours, de 1 à 30 (30 d'office), comptée depuis l'envoi ; EndDate (UTC) la fixe à la place.
Reminder Ses relances automatiques : 0 aucune, 1 chaque jour, 2 tous les deux jours, 7 chaque semaine, 14 toutes les deux semaines, 30 chaque mois.
MaximumReminders Le nombre de relances automatiques, de 1 à 5.
IsTest true : un parcours d'essai, sans consommation de crédits, aux documents filigranés.
ExternalId Votre référence, 128 caractères au plus.
CustomFieldsUserData Les valeurs de ses champs personnalisés — voir Champs personnalisés.

Une valeur hors bornes répond 400, avec le détail par propriété.

Les pièges

  • TemplateId est accepté ici, mais n'y copie rien du modèle : pour partir d'un modèle, voir Créer un parcours à partir d'un modèle.
  • GlobalStatus et les statuts sont tenus par le serveur : ceux que vous envoyez sont ignorés.
  • Une organisation qui n'est pas encore en production crée des parcours d'essai, quel que soit IsTest.
  • Suite : Ajouter un document.