---
title: "Create a webhook"
method: POST
path: "/webhooks"
---

# Create a webhook

`POST /webhooks`

## Request

- Base URL: `https://api.sandbox.waza.co/v2`
- URL: `https://api.sandbox.waza.co/v2/webhooks`
- Auth: API key in header `waza-x-key`

## Headers

- `waza-x-key` string

## Request body

- object
  - `label` string, required
  - `url` string, required: A valid and secure https:// URL
  - `secret` string, required
  - `events` string[], required: At least one event type to consume

## Response `200`

200

- object
  - `data` object
    - `id` string
    - `label` string
    - `url` string
    - `secret` string
    - `state` string
    - `created_date` string
    - `updated_date` string
    - `events` string[]

## Other responses

- `400`: 400

---

[API](https://skmtc.dev/waza/apis/b2b-payments-api.md) - [All operations](https://skmtc.dev/waza/apis/b2b-payments-api/llms.txt) - [OpenAPI document](https://skmtc.dev/waza/apis/b2b-payments-api/revisions/7d4685fefb9f?raw)