---
title: "Create a new webhook"
method: POST
path: "/webhooks"
tags: ["Webhooks (v2)"]
---

# Create a new webhook

`POST /webhooks`

## Request

- Base URL: `https://b2b.revolut.com/api/2.0`
- URL: `https://b2b.revolut.com/api/2.0/webhooks`
- Auth: HTTP bearer

Create a new webhook to receive event notifications to the specified URL. Provide a list of event types that you want to subscribe to and a URL for the webhook.
Only HTTPS URLs are supported.

For more information, see the guides: [About webhooks](https://developer.revolut.com/docs/guides/manage-accounts/webhooks/about-webhooks) and [Manage webhooks](https://developer.revolut.com/docs/guides/manage-accounts/webhooks/manage-webhooks#create-a-webhook).

## Request body

- CreateWebhookRequest
  - `url` string, uri, required: A valid webhook URL to which to send event notifications. The supported protocol is `https`.
  - `events` WebhookEventType[]: A list of event types to subscribe to. If you don't provide it, you're automatically subscribed to the [default event types](https://developer.revolut.com/docs/guides/manage-accounts/webhooks/about-webhooks#default-event-types).

## Response `201`

The successfully created webhook

- WebhookV2
  - `id` string, uuid, required: The ID of the webhook.
  - `url` string, uri, required: The valid webhook URL that event notifications are sent to. The supported protocol is `https`.
  - `events` WebhookEventType[], required: The list of event types that you are subscribed to.
  - `signing_secret` string, required: The signing secret for the webhook.

## Other responses

- `400`: Bad Request
- `422`: Unprocessable Entity
- `default`: Unexpected error

---

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