POST
/
customers
cURL
curl --request POST \
  --url https://sandbox-api.superpagamentos.com/customers \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "firstName": "João",
  "lastName": "Silva",
  "email": "email@email.com",
  "phoneNumber": "00000000000",
  "document": "00000000000",
  "birthdate": "1994-10-04",
  "address": {
    "zipcode": 87654321,
    "street": "Rua B",
    "streetNumber": 200,
    "complement": "Casa 10",
    "reference": "Ao lado da padaria",
    "neighborhood": "Jardins",
    "city": "São Paulo",
    "state": "SP"
  }
}'
{
  "data": {
    "id": "8a2edf48-704b-4c23-8278-a902e88a5f93",
    "firstName": "João",
    "lastName": "Silva",
    "email": "email@email.com",
    "phoneNumber": "00000000000",
    "document": "00000000000",
    "birthdate": "1994-10-04",
    "address": {
      "statusId": "APPROVED",
      "zipcode": 87654321,
      "street": "Rua B",
      "streetNumber": 200,
      "complement": "Casa 10",
      "reference": "Ao lado da padaria",
      "neighborhood": "Jardins",
      "city": "São Paulo",
      "state": "SP"
    },
    "statusId": "APPROVED",
    "createdAt": "2025-06-01T16:14:10.535Z"
  },
  "message": "Cliente criado com sucesso"
}

Authorizations

​
Authorization
string
header
required

Token JWT gerado na rota de autenticação (/auth). Deve ser enviado no formato: Bearer <token>

Body

application/json
​
firstName
string
required

Nome do cliente

Example:

"João"

​
lastName
string
required

Sobrenome do cliente

Example:

"Silva"

​
email
string
required

Email do cliente

Example:

"email@email.com"

​
document
string
required

CPF ou CNPJ do cliente

Example:

"00000000000"

​
phoneNumber
string

Número de telefone do cliente

Example:

"00000000000"

​
birthdate
string<date>

Data de nascimento do cliente no formato yyyy-mm-dd

Example:

"1994-10-04"

​
address
object

Endereço do cliente

Response

Cliente criado com sucesso

​
data
object
​
message
string
Example:

"Cliente criado com sucesso"