Criar novo cliente vendedor

POST

/api/v1/customers

Endpoint para criar um novo cliente vendedor.

💾 Estrutura de Dados

Headers

Content-type: application/json

Authorization: Bearer <JWT_TOKEN>

Body (JSON)

Propriedade	Tipo	Obrigatório	Descrição	Valor (exemplo)
name	String	Sim	Nome do cliente vendedor	John Doe
email	String	Sim	E-mail do cliente vendedor	johndoe.seller@domain.com
phone	String	Não	Número de telefone do cliente vendedor	+5511998018912
documentType	Enum	Sim	Tipo de documento do cliente vendedor, entre duas opções possíveis	`CPF` `CNPJ`
documentNumber	String	Sim	Número do documento correspondente definido na propriedade `documentType`	23259190058 73178002000149

Request

Authorization

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

Authorization: ********************

Body Params application/json

Examples

Responses

🟢201

application/json

Body

🟠400

🟠401

🟠409

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://xpend-backend.onrender.com/api/v1/customers' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "name": "John Doe",
    "email": "johndoe.seller@domain.com",
    "documentType": "CPF",
    "documentNumber": "23259190058"
}'

Response Example

201 - Success

{
    "id": "caea9d4a-9047-433d-a2f8-877b29b5e8c8",
    "sellerId": "e9832f40-2680-4753-9f61-a8b0323c12bf",
    "name": "John Doe",
    "email": "johndoe.seller@domain.com",
    "phone": null,
    "documentType": "CPF",
    "documentNumber": "23259190058",
    "createdAt": "2025-11-13T14:50:57.810Z",
    "updatedAt": "2025-11-13T14:50:57.810Z"
}

Modified at 2025-12-27 01:31:55

Obter saldo

Listar clientes vendedores

Criar novo cliente vendedor

💾 Estrutura de Dados#

Headers#

Body (JSON)#

Request

Responses

💾 Estrutura de Dados

Headers

Body (JSON)