Webhooks beheren

Deze pagina beschrijft het beheren van webhooks via de API. Je kunt webhooks ook beheren via de webinterface onder Stamdata → Applicatiebeheer → Webhooks — zie Beheren via de interface.

De beheer-endpoints werken net als de rest van de API: met een JWT Bearer token en een site header (zie Authenticatie).

Endpoints

Methode	Pad	Beschrijving
`GET`	`/webhooks`	Alle webhooks ophalen
`POST`	`/webhooks`	Webhook registreren
`GET`	`/webhooks/:id`	Specifieke webhook ophalen
`PUT`	`/webhooks/:id`	Webhook bijwerken
`DELETE`	`/webhooks/:id`	Webhook verwijderen

Webhook velden

Veld	Type	Verplicht	Beschrijving
`event_type`	string	✅	Het event waarop deze webhook reageert (zie Event types)
`url`	string	✅	De URL die NextWMS aanroept (`POST`)
`secret`	string	Nee	Geheime sleutel voor verificatie (meegestuurd als header)
`enabled`	boolean	Nee	Of de webhook actief is (standaard: `true`)

Webhook registreren

POST /webhooks

Request

{
  "event_type": "order_shipped",
  "url": "https://jouw-systeem.nl/webhooks/nextwms",
  "secret": "een-geheime-sleutel",
  "enabled": true
}

Response `204 No Content`

Alle webhooks ophalen

GET /webhooks

Response `200 OK`

[
  {
    "id": 1,
    "site_id": "SITE01",
    "event_type": "order_shipped",
    "url": "https://jouw-systeem.nl/webhooks/nextwms",
    "secret": "een-geheime-sleutel",
    "enabled": true,
    "created_at": "2026-06-19 10:30:00"
  }
]

Specifieke webhook ophalen

GET /webhooks/:id

Response `200 OK`

Retourneert een enkel webhook-record (zelfde formaat als in de lijst).

Response `404 Not Found`

{
  "message": "Webhook niet gevonden"
}

Webhook bijwerken

PUT /webhooks/:id

Request

{
  "event_type": "order_shipped",
  "url": "https://jouw-systeem.nl/webhooks/nextwms-v2",
  "secret": "nieuwe-sleutel",
  "enabled": false
}

Response `204 No Content`

Webhook verwijderen

DELETE /webhooks/:id