---
api: 'Merchant API'
---

# Create a customer

Create a `customer` object.

:::note [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](/docs/api/merchant#retrieve-a-customer-list) 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](/docs/guides/merchant/accept-payments/online-payments/revolut-pay/introduction), [Card payments](/docs/guides/merchant/accept-payments/online-payments/card-payments/introduction)), 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](/docs/api/merchant#create-an-order)

For more information, see: [Charge a customer's saved payment method](/docs/guides/merchant/optimise-checkout/save-payment-methods/charge-saved-payment-method).

<details>
<summary>AFT processing requirements</summary>

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

| Industry | Required fields |
| -------- | --------------- |
| Crypto | `full_name`, `date_of_birth` |
| Financial Institutions | `full_name`, `date_of_birth` |
| Stored Value / Wallets | `full_name`, `date_of_birth` |

</details>

## Endpoint

POST `/api/customers`

## Request body

### Attributes

- `full_name` (string, optional)
    The full name of the customer.
- `email` (string)
    The email address of the customer.
- `phone` (string, optional)
    The phone number of the customer in [E.164 format](https://en.wikipedia.org/wiki/E.164).
- `date_of_birth` (string, optional)
    The birth date of the customer.

## Returns

### 201

Created

#### Response attributes

- `id` (string)
    Unique identifier for the customer.
- `full_name` (string, optional)
    The full name of the customer.
- `email` (string)
    The email address of the customer.
- `phone` (string, optional)
    The phone number of the customer in [E.164 format](https://en.wikipedia.org/wiki/E.164).
- `created_at` (string)
    The date and time the customer was created.
- `updated_at` (string)
    The date and time the customer was last updated.

## Error responses

| HTTP status code | Description |
| --- | --- |
| 400 | Bad Request |
| 401 | Unauthorized |