# Créer une application ou connecter des webhooks

Créez une application OAuth que d'autres utilisateurs de Drime connectent à leur compte, recevez des webhooks et soyez prévenu des événements Drime Sign.

Mis à jour : 2026-10-19  
Source : https://drime.cloud/fr/support/integrations-et-api/creer-une-integration

Pour utiliser l'API Drime sur votre propre compte, un token personnel suffit : voir [Créer un token d'API](https://drime.cloud/fr/support/integrations-et-api/jetons-d-api). Pour créer une application que d'autres utilisateurs de Drime connectent à leur compte, créez une application OAuth : vos utilisateurs l'approuvent sur Drime, et elle ne voit jamais leur mot de passe.

## Créer une application OAuth

Tout utilisateur connecté peut créer des applications depuis le portail développeur, **Mes applications**, puis **Créer une application**.

![Le formulaire Créer une application du portail développeur avec les trois types d'application](https://drime.cloud/media/01M5AT6FMG94YCAZW1YV8H76J5/da59feb89b13-web-developers-create-application.png)

Vous choisissez d'abord ce que vous créez :

| Choix | Pour |
| --- | --- |
| **Un site web ou un serveur** | Vous obtenez une clé secrète à garder sur votre serveur. |
| **Une application desktop ou mobile** | Installée sur les appareils de vos utilisateurs, donc sans clé secrète. |
| **Un script, juste pour moi** | Un petit outil que vous lancez vous-même. |

Vous choisissez ensuite ce dont l'application a besoin : **Un dossier à elle** (elle ne voit jamais qu'un seul dossier, créé dans le Drive) ou **Tout le Drive**.

Bon à savoir :

- Vous pouvez créer jusqu'à 25 applications.
- Une nouvelle application fonctionne pour 25 utilisateurs au plus. Pour l'ouvrir à davantage de personnes, utilisez **Ouvrir à tous**, puis **Envoyer pour revue** : Drime répond sous 24 heures.
- Les tokens d'accès durent 1 heure, et les tokens d'actualisation 90 jours.
- Les applications tierces ne peuvent jamais accéder à un Vault.

Les applications de type **Un site web ou un serveur** peuvent aussi recevoir des webhooks quand des fichiers sont créés ou supprimés dans un compte connecté. Chaque notification est signée dans le header `X-Drime-Signature`.

## Webhooks Drime Sign

Dans **Paramètres** \> **Développeurs** \> **Webhooks** (**Notifications HTTP pour les événements Drime Sign.**), cliquez sur **Ajouter un webhook** pour que votre serveur soit prévenu, par exemple quand :

- un document est envoyé, terminé ou refusé ;
- un signataire consulte, signe ou refuse ;
- un modèle est créé.

![La section Webhooks des paramètres Développeurs avec Ajouter un webhook](https://drime.cloud/media/01M5AKQB5Q49A8RXRFSXQ9A0YG/219f72f50fe0-web-sign-webhooks.png)

Chaque notification est signée avec un secret (`X-Drime-Signature`, HMAC SHA-256). Une notification en échec est renvoyée jusqu'à 10 fois sur environ 34 heures. Vous pouvez **Envoyer un test**, **Régénérer le secret** et consulter les **Livraisons**.

## Intégrer un formulaire de signature à votre site

Dans **Paramètres** \> **Développeurs** \> **Intégration**, vous pouvez permettre aux visiteurs de signer des documents sans quitter votre site, avec le widget `<drime-sign-form>`. Ajoutez vos domaines dans **Domaines autorisés** : sans aucun domaine, l'intégration est désactivée.

## Étapes suivantes

- [Créer un token d'API](https://drime.cloud/fr/support/integrations-et-api/jetons-d-api)
- [Rclone, Drime CLI et WebDAV](https://drime.cloud/fr/support/integrations-et-api/rclone-cli-et-webdav)