---
title: "Create Webhook Endpoint"
method: POST
path: "/webhooks"
---

# Create Webhook Endpoint

`POST /webhooks`

## Request

- Base URL: `https://sandbox.openpayd.com/api`
- URL: `https://sandbox.openpayd.com/api/webhooks`
- Auth: API key in header `Authorization`

Create a new webhook endpoint to receive events.

## Request body

- object
  - `url` string, required: URL of the webhook endpoint where enabled events will be posted.
  - `webhookEvents` object[], required
    - `transactionType` string, required: Type of Transaction or event.<br>`DEPOSIT`, `PAYOUT`, `ACCOUNT_STATUS`, `PAY_IN`
    - `transactionStatus` string, required: PAYIN, PAYOUT, TRANSFER - `FAILED`, `CANCELLED`, `COMPLETED`, `PROCESSING`<br> PAY_IN - `COMPLETED`<br> ACCOUNT_STATUS - `COMPLETED`
  - `description` string: Optional description of what the webhook endpoint is used for.

## Response `200`

200

- object

## Other responses

- `400`: 400

---

[API](https://skmtc.dev/openpayd/apis/openpayd-api.md) - [All operations](https://skmtc.dev/openpayd/apis/openpayd-api/llms.txt) - [OpenAPI document](https://skmtc.dev/openpayd/apis/openpayd-api/revisions/0f820ef79fab?raw)