---
title: "Webhook aanmaken · API-documentatie | Faillissement.app"
description: "Documentatie van de Faillissement.app API: authenticatie, scopes, herkomst, credits, fouten, endpoints en webhooks."
canonical_url: "https://faillissement.app/ontwikkelaars/docs/webhooks-store"
locale: nl
meta:
  "og:description": "Documentatie van de Faillissement.app API: authenticatie, scopes, herkomst, credits, fouten, endpoints en webhooks."
  "og:title": "Webhook aanmaken · API-documentatie | Faillissement.app"
---

**API-documentatie**

**v1.0.0**

[openapi.json](https://faillissement.app/api/v1/openapi.json) [Prijzen](https://faillissement.app/ontwikkelaars) [API-sleutels](https://faillissement.app/account/api)

# Webhook aanmaken

**POST**`**/api/v1/webhooks**`

**scope: webhooks:manage****gratis**

Een https-URL en de events die u wilt ontvangen. Het geheim voor de handtekening staat alleen in dit antwoord.

### **Body**

Body

| **Naam** | **Type** | **Omschrijving** |
| --- | --- | --- |
| `url`verplicht | string | Openbare https-URL |
| `events`verplicht | enum\[] | Events om te ontvangen case.created · case.status\_changed · report.published · report.processed · value.corrected · value.conflict · portfolio.hit · auction.linked |
| `enabled` | boolean | Webhook aan of uit |

### **Antwoord · HTTP 201**

### **Antwoord · HTTP 201**

Antwoord · HTTP 201

| **Naam** | **Type** | **Omschrijving** |
| --- | --- | --- |
| `data`verplicht | object | |
| `data.secret`verplicht | string | |

### **Antwoord · HTTP 422**

Validation error

### **Antwoord · HTTP 422**

Antwoord · HTTP 422

| **Naam** | **Type** | **Omschrijving** |
| --- | --- | --- |
| `error`verplicht | object | |
| `error.code`verplicht | string | Stable error code, for example not\_found or validation\_failed |
| `error.message`verplicht | string | Human-readable explanation |
| `error.details` | object | Extra information, such as the fields that failed validation |

De velden van het antwoord staan in openapi.json. Hoe elke waarde met bron is opgebouwd, leest u bij [Gegevens en brondocumenten](https://faillissement.app/ontwikkelaars/docs/provenance)