Create customer - Customers - Mercado Pago Developers
Create customer

POST

/v1/customers
Create a customer with all its data and save the cards used to simplify the payment process.
Request's parameters
address
object
Localization: bodyDefault address's information.
date_registered
Date(ISO_8601)
Localization: bodyCustomer's registration date.
default_address
String
Localization: bodyCustomer's default address.
default_card
String
Localization: bodyCustomer's default card.
Response parameters
id
string
Localization: bodyCustomer ID.
email
string
Localization: bodyCustomer's email.
first_name
string
Localization: bodyCustomer's name.
last_name
string
Localization: bodyCustomer's last name.
Request
curl
curl -X POST \
      'https://api.mercadopago.com/v1/customers' \
      -H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
      -H 'Content-Type: application/json' \ 
      -d '{
  "email": "jhon@doe.com",
  "first_name": "Jhon",
  "last_name": "Doe",
  "phone": {
    "area_code": "55",
    "number": "991234567"
  },
  "identification": {
    "type": "CPF",
    "number": "12345678900"
  },
  "default_address": "Home",
  "address": {
    "id": "123123",
    "zip_code": "01234567",
    "street_name": "Rua Exemplo",
    "street_number": 123
  },
  "date_registered": "2021-10-20T11:37:30.000-04:00",
  "description": "Description del user",
  "default_card": "None"
}'
Answer
json
{
  "id": "000000001-sT93QZFAsfxU9P5",
  "email": "jhon@doe.com",
  "first_name": "Bruce",
  "last_name": "Wayne",
  "phone": {
    "area_code": 23,
    "number": 12345678
  },
  "identification": {
    "type": "DNI",
    "number": 12345678
  },
  "address": {
    "id": "1162600094",
    "zip_code": "SG1 2AX",
    "street_name": "Old Knebworth Ln"
  },
  "description": "This is my description",
  "date_created": "2018-02-20T15:36:23.541Z",
  "metadata": {
    "source_sync": "source_ws"
  },
  "default_address": "1162600094",
  "cards": [
    {}
  ],
  "addresses": [
    {}
  ],
  "live_mode": true
}
Errors
400bad_request
100the credentials are required.
101the customer already exist.
102missing customer id.
103parameter must be an object
104parameter length is too large.
105the customer id is invalid.
106the email format is invalid.
107the first_name is invalid.
108the last_name is invalid.
109the phone.area_code is invalid.
110the phone.number is invalid.
111the identification.type is invalid.
112the identification.number is invalid.
113the address.zip_code is invalid.
114the address.street_name is invalid.
115the date_registered format is invalid.
116the description is invalid.
117the metadata is invalid.
118the body must be a Json Object.
119the card is required.
120card not found.
121the card is invalid.
122the card data is invalid.
123the payment_method_id is required.
124the issuer_id is required.
125invalid parameters.
126invalid parameter. You cannot update the email.
127invalid parameter. Cannot resolve the payment method of card, check the payment_method_id and issuer_id.
128the email format is invalid. Use 'test_payer_[0-9]{1,10}@testuser.com'.
129the customer has reached the maximum allowed number of cards.
140invalid card owner.
150invalid users involved.
200invalid range format (range=:date_parameter:after::date_from,before::date_to).
201range attribute must belong to date entity.
202invalid 'after' parameter. It should be date[iso_8601].
203invalid 'before' parameter. It should be date[iso_8601].
204invalid filters format.
205invalid query format.
206attributes to sort must belong to 'customer' entity.
207order filter must be 'asc' or 'desc'.
208invalid 'sort' parameter format.
401bad_request
unauthorizedunauthorized.
404bad_request
not_foundnot_found.