---
title: "Create/Register a webhook endpoint"
method: POST
path: "/webhooks"
tags: ["Webhooks"]
---

# Create/Register a webhook endpoint

`POST /webhooks`

Create/Register a webhook endpoint to start receiving events

## Request body

- object — The request body for registering a webhook endpoint
  - `url` string — The URL of your webhook endpoint to register
  - `active` boolean — Whether the endpoint is active (receiving events) or not
  - `eventTypes` EventType[] — The event types you want the endpoint to receive

## Response `200`

Webhook successfully registered

- WebhookEndpointCreated
  - `secret` string — The Webhook's signature secret (only returned on initial creation). Ensure this is stored securely
  - `id` string — The unique Id for the webhook endpoint
  - `active` boolean — Whether the endpoint is actively receiving events or not
  - `url` string — The URL of the webhook endpoint
  - `eventTypes` EventType[] — The event types the endpoint is receiving
  - `createdTimestamp` integer — The epoch timestamp (seconds) when the webhook endpoint was created

## Other responses

- `400` — One or more inputs are invalid
- `409` — This operation has already been performed
- `500` — An unexpected error occurred when executing this request

---

[API](https://skmtc.net/ryftpay/apis/ryft-payment-api.md) · [All operations](https://skmtc.net/ryftpay/apis/ryft-payment-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ryftpay/ryft-payment-api/revisions/a042f64d4305/schema)