> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.goodflag.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.goodflag.com/_mcp/server.

# Démarrer le workflow

> Démarrer un workflow de signature

# Lancement du parapheur

## Démarrer le parapheur

Une fois les documents à signer téléversés, l'application métier passe le statut du parapheur à `started`, en transmettant l'identifiant du parapheur dans l'URL :

```http
PATCH /api/workflows/wfl_FPt9JLHCzFTvCRNviHBNE3Hg HTTP/1.1
Authorization: Bearer act_KsV6FLek9qjbxmHUPjuaBWus.4csaGSdsKCCMAoKhVhQQTUJsFaRygHyYNveeBmXiU4SfpSsdVkRxumjZGFbnKE4x
Content-Type: application/json
Content-Length: 34

{
  "workflowStatus" : "started"
}
```

## Signature et approbation

Dès que le parapheur démarre, les destinataires de la première étape du parapheur reçoivent des invitations par e-mail pour signer ou approuver les documents via la page de consentement.

### Créer l'invitation

Si vous préférez envoyer les e-mails d'invitation depuis votre application métier, vous pouvez empêcher le Workflow Manager d'envoyer les e-mails d'invitation en positionnant le champ `maxInvites` de l'étape à `0`. Vous pouvez alors utiliser l'API de parapheur pour créer les liens d'invitation de façon programmatique, pour chaque destinataire :

```http
POST /api/workflows/wfl_5rXexBmb7RAqWSu5CsJvV4XU/invite HTTP/1.1
Authorization: Bearer act_KsV6FLek9qjbxmHUPjuaBWus.4csaGSdsKCCMAoKhVhQQTUJsFaRygHyYNveeBmXiU4SfpSsdVkRxumjZGFbnKE4x
Content-Type: application/json
Content-Length: 59

{
  "recipientEmail" : "kenny.windler2729@my-company.com"
}
```

Un lien d'invitation est renvoyé :

```json
{
  "inviteUrl" : "https://kovacek.org/invite?token=eyJhbGciOiJIUzI1NiJ9.eyJhdWQiOiJpbnZpdGUiLCJjb25zZW50VmVyc2lvbiI6IlYyIiwic3RlcElkIjoic3RwX0VpRDJYdWlBRlZ3MlgxVnFyU..."
}
```

> Notez que le lien généré reste valide tant que le parapheur est accessible au destinataire. Il devient invalide dès que le destinataire n'est plus requis, ou une fois l'étape expirée.