---
title: "Create Bolt Webhook"
method: POST
path: "/v1/webhooks"
tags: ["Webhooks"]
---

# Create Bolt Webhook

`POST /v1/webhooks`

Create a new webhook to receive notifications from Bolt about various events, such as transaction status. Webhooks must have unique configuration.

## Request body

- union
  - EventGroupCreateWebhook
    - `division_id` string, required — The unique ID associated with the specific merchant division.
    - `url` string, required — The full URL to receive webhook notifications.
    - `event_group` 'all' | 'null', nullable — Subscribe to a group of events. `all`: subscribe to all existing and future event types
  - EventsArrayCreateWebhook
    - `division_id` string, required — The unique ID associated with the specific merchant division.
    - `url` string, required — The full URL to receive webhook notifications.
    - `events` WebhooksType[] — If `webhook_event_group` is null, pick a list of notification events to subscribe to.

## Response `200`

Success

- object
  - `webhook_id` string, required — A unique webhook ID. Reference this value to modify or delete the webhook subscription. operations as well.

## Other responses

- `400` — BAD REQUEST. Request is malformed or invalid values are detected.
- `403` — FORBIDDEN. Not authorized to create a webhook for this entity.
- `422` — UNPROCESSABLE ENTITY. Not allowed to receive duplicate notifications. This is to safeguard a webhook listener from receiving duplicate events. Use GET /v1/webhooks and DELETE /v1/webhooks to check for and delete duplicate webhooks.

---

[API](https://skmtc.dev/bolt/apis/bolt-api-reference.md) · [All operations](https://skmtc.dev/bolt/apis/bolt-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/bolt/bolt-api-reference/revisions/17eceacd5ce7/schema)