Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Revolut Webhooks API

A webhook (also called a web callback) allows your system to receive an event from Ramp immediately after it happens.With the **Webhooks** endpoints, you can create, update, delete, and retrieve webhooks, as well as retrieve webhooks that you have created.For more details, see the guides: [Work with Webhooks -> Track order and payment lifecycle](https://developer.revolut.com/docs/guides/crypto-ramp/tutorials/work-with-webhooks/use-webhooks) and [-> Verify the payload signature](https://developer.revolut.com/docs/guides/crypto-ramp/tutorials/work-with-webhooks/verify-the-payload-signature).

Revolut Webhooks API is one of 46 APIs that Revolut publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Webhooks. The published artifact set on APIs.io includes an OpenAPI specification.

This API exposes 11 operations across 5 paths, and defines 24 schemas. It is described by OpenAPI 3.0.1, at version 1.0.

Requests are made against 2 base URLs: https://b2b.revolut.com/api/1.0, https://sandbox-b2b.revolut.com/api/1.0.

11 operations 5 paths 24 schemas 2 DELETE4 GET2 PATCH3 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.1
API Version
1.0
Base URL
https://b2b.revolut.com/api/1.0
Authentication
HTTP Bearer
Resource Areas
1

Authentication & Security 1

Revolut Webhooks API declares 1 security scheme for authenticating requests. It accepts HTTP bearer tokens (AccessToken).

  • AccessToken — Each Business API request must contain an authorization header in the following format to make a call: Bearer . The access token will be obtained the first tim…

Paths & Operations 11

Across 5 paths, the API surfaces 11 operations — 2 DELETE, 4 GET, 2 PATCH, 3 POST. Each is listed below with its method, path, parameters, and response codes.

Webhooks 11

A webhook (also called a web callback) allows your system to receive an event from Ramp immediately after it happens. With the Webhooks endpoints, you can create, update, delete,…

GET
/webhooks/{webhook_id}
Retrieve a webhook
retrieve-a-webhook 2 params → 200400401404429500503
PATCH
/webhooks/{webhook_id}
Update a webhook
update-a-webhook 2 params body → 200400401404429500503
DELETE
/webhooks/{webhook_id}
Delete a webhook
delete-a-webhook 2 params → 204400401404429500503
GET
/webhooks
Retrieve a list of webhooks
retrieve-a-list-of-webhooks 1 param → 200401429500503
POST
/webhooks
Create a webhook
create-a-webhook 1 param body → 200400401429500503
POST
/api/webhooks
Create a webhook
createWebhook 2 params body → 200400401422
GET
/api/webhooks
Retrieve a webhook list
retrieveWebhookList 2 params → 200401
GET
/api/webhooks/{webhook_id}
Retrieve a webhook
retrieveWebhook 3 params → 200401404
PATCH
/api/webhooks/{webhook_id}
Update a webhook
updateWebhook 3 params body → 200400401404
DELETE
/api/webhooks/{webhook_id}
Delete a webhook
deleteWebhook 3 params → 204401404
POST
/api/webhooks/{webhook_id}/rotate-signing-secret
Rotate a webhook signing secret
rotateWebhookSigningSecret 3 params body → 200400401404

Schemas 24

The contract defines 24 schemas that model the data the API accepts and returns. The most detailed are Webhook-Order-Event (4 properties), Webhook-v2 (4 properties), Webhook (4 properties), Webhook-Subscription-Event (3 properties). Each schema is shown below with its type and property counts.

Webhook-Dispute-Event
object
2 properties 2 required
WebhookUpdateRequest
object
Webhook update parameters
2 properties
Webhook-Subscription-Event
object
3 properties 2 required
WebhookCreateRequest
object
Webhook create parameters
2 properties 2 required
Webhook-Events
array
List of event types that the webhook is configured to listen to. Each event is related to status changes of a specific object in the Merchant API: | Object | E…
Webhook-Creation
object
2 properties 2 required
Error
object
2 properties 2 required
Error-v2
object
3 properties
BadRequestError
object
Thrown when request parameter field is invalid
1 property 1 required
Webhook-Url
string
Your webhook's URL to which event notifications will be sent. Must be a valid HTTP or HTTPS URL, capable of receiving POST requests. :::warning Restrictions: -…
DisabledByKillSwitchError
object
Thrown when endpoint is disabled by Kill Switch.
1 property 1 required
Webhook-Payout-Event
object
2 properties 2 required
Webhooks_2
object
1 property 1 required
NotFoundError
object
Thrown when resource can't be found
1 property 1 required
Webhook-Id
string
The ID of the webhook.
Webhook-Callback-Event
string
The event type of the webhook notification that's sent by Revolut to your webhook URL. Each event is related to status changes of a specific object in the Merc…
Webhook-Order-Event
object
4 properties 2 required
EventType
string
Webhook event type
UnexpectedError
object
Thrown when an unexpected error happens.
2 properties 2 required
Webhook
object
Webhook
4 properties 4 required
Webhook-v2
object
A webhook object. Unlike the legacy API, signingsecret is included in all webhook responses, not only on creation.
4 properties 4 required
Webhook-Signing-Secret
string
The signing secret for the webhook. Use it to verify the signature for the webhook request's payload.
Webhooks
array
Webhook-Update
object
The request body for updating a webhook. All fields are optional. Only the fields provided in the request will be updated.
2 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

revolut-webhooks-api-openapi.yml Raw ↑

Other APIs Revolut publishes across the network.

Revolut Accounting API
Revolut Accounting categories API
Revolut Accounts API
Revolut Apple Pay merchant registration API
Revolut Applications API
Revolut Balance API
Revolut Card invitations API
Revolut Cards API
Revolut Configuration API
Revolut Counterparties API
Revolut Customers API
Revolut Disputes API