Skip to main content
POST
Create Customer

Authorizations

x-revolv3-token
string
header
required

Headers

Client-Request-Id
string

Optional identifier generated by the client to match its own logs with this request.

Allowed values: 1 to 128 characters, letters, digits and ., _, :, -.

Examples: order-12345, 3f2b8c1e-9d4a-4e7b-a1c5-6b0d2e8f7a91 (GUID), checkout:2026-11-02.17, retry_1.order-12345.

A valid value is returned in the Client-Request-Id response header and is stored with Revolv3 request logs, so it can be used when contacting support. An invalid value is ignored and the request is processed normally. Do not send sensitive data in this header.

Required string length: 1 - 128
Pattern: ^[A-Za-z0-9._:-]{1,128}$

Body

firstName
string
required
Required string length: 1 - 150
lastName
string
required
Required string length: 1 - 150
merchantCustomerRefId
string | null
Maximum string length: 100
email
string<email> | null
Maximum string length: 100
billingAddresses
object[] | null
Maximum array length: 10
shippingAddresses
object[] | null
Maximum array length: 10
subscriptions
object[] | null

Response

Created

customerId
integer<int64>
Required range: 1 <= x <= 1000000000
merchantCustomerRefId
string | null
Maximum string length: 100
firstName
string | null
Maximum string length: 150
lastName
string | null
Maximum string length: 150
billingAddresses
object[] | null
shippingAddresses
object[] | null
taxAddresses
object[] | null
subscriptions
object[] | null