Skip to main content
POST
/
v1
/
customers
Create Customer
curl --request POST \
  --url https://api-sandbox.y.uno/v1/customers \
  --header 'Content-Type: application/json' \
  --data '
{
  "merchant_customer_id": "customer-001",
  "first_name": "John",
  "last_name": "Doe",
  "email": "john.doe@example.com",
  "gender": "M",
  "date_of_birth": "1990-01-15",
  "nationality": "US",
  "country": "US",
  "document": {
    "document_type": "DNI",
    "document_number": "123456789"
  },
  "phone": {
    "country_code": "+1",
    "number": "5550000001"
  },
  "billing_address": {
    "address_line_1": "123 Main St",
    "city": "New York",
    "state": "NY",
    "zip_code": "10001",
    "country": "US"
  },
  "metadata": [
    {
      "key": "source",
      "value": "web"
    }
  ]
}
'
{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "merchant_customer_id": "<string>",
  "first_name": "<string>",
  "last_name": "<string>",
  "email": "<string>",
  "country": "<string>",
  "document": {
    "document_number": "<string>"
  },
  "phone": {
    "country_code": "+1",
    "number": "5550000001"
  },
  "billing_address": {
    "address_line_1": "<string>",
    "address_line_2": "<string>",
    "city": "<string>",
    "state": "<string>",
    "zip_code": "<string>",
    "neighborhood": "<string>"
  },
  "metadata": [
    {
      "key": "<string>",
      "value": "<string>"
    }
  ],
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z"
}

Body

application/json
​
merchant_customer_id
string
required
Required string length: 3 - 255
​
first_name
string
Required string length: 3 - 255
​
last_name
string
Required string length: 3 - 255
​
gender
enum<string>
Available options:
M,
F,
NB,
NA,
NK,
U
​
date_of_birth
string
Pattern: ^\d{4}-\d{2}-\d{2}$
Example:

"1990-01-15"

​
email
string<email>
​
nationality
enum<string>

ISO 3166-1 alpha-2 country code

Available options:
AR,
BO,
BR,
CL,
CO,
CR,
EC,
SV,
GT,
HN,
MX,
NI,
PA,
PY,
PE,
US,
UY
​
country
enum<string>

ISO 3166-1 alpha-2 country code

Available options:
AR,
BO,
BR,
CL,
CO,
CR,
EC,
SV,
GT,
HN,
MX,
NI,
PA,
PY,
PE,
US,
UY
​
document
object
​
phone
object
​
billing_address
object
​
shipping_address
object
​
metadata
object[]
Maximum array length: 120

Response

Customer created

​
id
string<uuid>
​
merchant_customer_id
string
​
first_name
string
​
last_name
string
​
email
string
​
country
string
​
document
object
​
phone
object
​
billing_address
object
​
metadata
object[]
Maximum array length: 120
​
created_at
string<date-time>
​
updated_at
string<date-time>