# Een app bouwen of webhooks instellen

Maak een OAuth-applicatie die andere Drime-gebruikers aan hun account koppelen, ontvang webhooks en laat je server weten wat er in Drime Sign gebeurt.

Bijgewerkt: 2026-10-19  
Bron: https://drime.cloud/nl/support/integrations-and-api/build-an-integration

Wil je de Drime-API met je eigen account gebruiken, dan is een persoonlijk token genoeg: zie [Een API-token maken](https://drime.cloud/nl/support/integrations-and-api/api-tokens). Wil je een app bouwen die andere Drime-gebruikers aan hun account koppelen, maak dan een OAuth-applicatie: je gebruikers keuren die goed bij Drime, en de app ziet nooit hun wachtwoord.

## Een OAuth-applicatie maken

Elke ingelogde gebruiker kan applicaties maken in het ontwikkelaarsportaal, via **Mijn applicaties** en daarna **Applicatie maken**.

![Het formulier Applicatie maken in het ontwikkelaarsportaal, met de drie soorten applicaties](https://drime.cloud/media/01M5AT6DMNDAVYH6SJW5CDQYFB/8439d64a4ecd-web-developers-create-application.png)

Eerst kies je wat je bouwt:

| Keuze | Voor |
| --- | --- |
| **Een website of een server** | Je krijgt een secret dat je op je server bewaart. |
| **Een desktop- of mobiele app** | Geïnstalleerd op de apparaten van je gebruikers, dus zonder secret. |
| **Een script, alleen voor mij** | Een kleine tool die je zelf uitvoert. |

Daarna kies je wat de applicatie nodig heeft: **Een eigen map** (ze ziet altijd maar één map, die in de Drive wordt aangemaakt) of **De hele Drive**.

Goed om te weten:

- Je kunt maximaal 25 applicaties maken.
- Een nieuwe applicatie werkt voor maximaal 25 gebruikers. Wil je haar voor meer mensen openstellen, gebruik dan **Voor iedereen openstellen** en daarna **Ter beoordeling versturen**: Drime reageert binnen 24 uur.
- Toegangstokens zijn 1 uur geldig, vernieuwingstokens 90 dagen.
- Applicaties van derden hebben nooit toegang tot een Vault.

Applicaties van het type **Een website of een server** kunnen ook webhooks ontvangen wanneer er in een gekoppeld account bestanden worden aangemaakt of verwijderd. Elke melding wordt ondertekend in de header `X-Drime-Signature`.

## Webhooks voor Drime Sign

Klik in **Instellingen** \> **Ontwikkelaars** \> **Webhooks** (**HTTP-meldingen voor Drime Sign-events.**) op **Webhook toevoegen** om je server een melding te laten krijgen wanneer bijvoorbeeld:

- een document wordt verzonden, voltooid of geweigerd;
- een ondertekenaar een document bekijkt, ondertekent of weigert;
- een sjabloon wordt aangemaakt.

![Het onderdeel Webhooks in de instellingen voor ontwikkelaars, met Webhook toevoegen](https://drime.cloud/media/01M5AKQ8TWF4KP6TWB0GPD9RK7/f4d9572805b0-web-sign-webhooks.png)

Elke melding wordt ondertekend met een secret (`X-Drime-Signature`, HMAC SHA-256). Een mislukte melding wordt tot 10 keer opnieuw verstuurd, verspreid over ongeveer 34 uur. Je kunt **Test versturen** en **Geheim vernieuwen** gebruiken en de **Bezorgingen** bekijken.

## Een ondertekeningsformulier insluiten op je website

In **Instellingen** \> **Ontwikkelaars** \> **Insluiten** kun je bezoekers met de widget `<drime-sign-form>` documenten laten ondertekenen zonder dat ze je website verlaten. Voeg je domeinen toe bij **Toegestane domeinen**: zonder domein is insluiten uitgeschakeld.

## Volgende stappen

- [Een API-token maken](https://drime.cloud/nl/support/integrations-and-api/api-tokens)
- [Rclone, Drime CLI en WebDAV](https://drime.cloud/nl/support/integrations-and-api/rclone-cli-and-webdav)