Create a customer

Create a customer object.

No automatic deduplication

The API does not prevent creating multiple customers with the same email address or phone number.

This can be intentional, for example, to maintain separate customer records per storefront or brand under the same account.

To avoid unintentional duplicates, search for existing customers by email or phone using the List customers endpoint before creating a new one.

Save payment methods

If you wish to save a customer's payment details using any of the available payment methods on the Revolut Checkout Widget (Revolut Pay, Card payments), you need to meet one of the following requirements:

  • Have a customer object with email and assign it to the order by providing customer.id
  • Create a new customer with, at least, customer.email during order creation

For more information, see: Charge a customer's saved payment method.

AFT processing requirements

For merchants in the following industries, full_name and date_of_birth are required for Account Funding Transaction (AFT) processing:

IndustryRequired fields
Cryptofull_name, date_of_birth
Financial Institutionsfull_name, date_of_birth
Stored Value / Walletsfull_name, date_of_birth

Request

Header parameters
Header parameters

Example: "Bearer sk_1234567890ABCdefGHIjklMNOpqrSTUvwxYZ_1234567890-Ab_cdeFGHijkLMNopq"

This parameter accepts the Merchant API Secret key to authorise requests coming from the merchant's backend.

It ensures that ensures that each request is authenticated and authorised by verifying the secret key. The secret key should be included in all request headers as a Bearer token.

Info

For more information, see: Authentication

Possible values: [2024-09-01, 2025-10-16, 2025-12-04, 2026-03-12, 2026-04-20]
Example: "2026-04-20"

The version of the Merchant API, specified in YYYY-MM-DD format.

This endpoint is available from version 2024-09-01. If a version earlier than 2024-09-01 is provided, the endpoint returns a 404 response.

If not specified, you will receive an error.

Info

For more information about API versioning, see: API versions.

Request body
Body object

The full name of the customer.

The email address of the customer.

The phone number of the customer in E.164 format.

The birth date of the customer.

Response

Created

Response body
Body object

Unique identifier for the customer.

The full name of the customer.

The email address of the customer.

The phone number of the customer in E.164 format.

The date and time the customer was created.

The date and time the customer was last updated.

Was this page helpful?