Cadastrar cliente

POST

/clients/

Cadastra clientes (PF/PJ) na API AgRisk. Caso o CPF/CNPJ já estiver registrado, será retornado um erro 400, acompanhado pelo clientId. Requer autenticação via Bearer JWT ou header x-api-key. O corpo da requisição (application/json) contém os campos esperados pelo endpoint.

Requisição

Authorization

Forneça seu token bearer no cabeçalho

Authorization

ao fazer requisições para recursos protegidos.

Exemplo:

Authorization: Bearer ********************

Parâmetros Header

Parâmetros Bodyapplication/jsonNecessário

Examples

Respostas

🟢201

application/json

Harvested 201

Bodyapplication/json

🟠400BadRequest

🟠401Unauthorized

🟠404NotFound

🟠429TooManyRequests

🔴500InternalError

Request Example

Shell

JavaScript

Java

Swift

curl --location '/clients/' \
--header 'x-api-key: SUA_CHAVE_DE_API' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "taxId": "string",
    "birthDate": "string"
}'

Response Example

201 - Sucesso

{
    "id": "string",
    "companyId": "string",
    "taxId": "string",
    "kind": "string",
    "legalName": "string"
}

Modificado em 2026-10-13 09:47:06

Página anterior

Autenticar via credenciais

Próxima página

Listar clientes da empresa