Login Cadastre-se

Criar cliente

Endpoint: POST https://croncrm.com/api/v2/leads/create

Header do request
Atributo Descrição Obrigatório Tipo

apiKey

Informe sua API Key gerada na interface do CRONCRM.

Sim

String
Body do request

full_name (obrigatório), demais campos opcionais conforme necessidade

Atributo Descrição Obrigatório Tipo

full_name

Nome completo do cliente.

Sim

String

phone

Telefone do cliente.

Não

String

email

Email do cliente.

Não

String

cpf

CPF do cliente.

Não

String

birthdate

Data de nascimento do cliente.

Não

String

phone1

Telefone adicional do cliente.

Não

String

phone2

Telefone adicional do cliente.

Não

String

email1

Email adicional do cliente.

Não

String

email2

Email adicional do cliente.

Não

String

social_name

Razão social do cliente (quando aplicável).

Não

String

cnpj

CNPJ do cliente (quando aplicável).

Não

String

business_email

Email empresarial do cliente (quando aplicável).

Não

String

chat_wid

Chat WID de uma conversa existente para vincular ao cliente.

Não

String

account_access_token

access_token de um usuário para vincular ao cliente.

Não

String

observations

Observações sobre o cliente.

Não

String

cep

CEP do endereço.

Não

String

address

Endereço.

Não

String

number

Número do endereço.

Não

String

neighborhood

Bairro.

Não

String

completion

Complemento do endereço.

Não

String

city_ibge

Código IBGE da cidade para vincular ao cliente.

Não

Inteiro

 
{
  "full_name": "João da Silva",
  "phone": "559999999999",
  "email": "[email protected]"
}
Response do request

Em caso de sucesso, retorna HTTP 200 com success true. Se full_name não for informado, retorna 400. Se já existir um cliente com o mesmo CPF/CNPJ/Razão Social informado, retorna 400. Se chat_wid for informado e não existir conversa, retorna 400. Se account_access_token for informado e não existir usuário, retorna 400. Se city_ibge for informado e não localizar a cidade, retorna 422. Método incorreto retorna 405; falhas inesperadas retornam 500.

Atributo Descrição Tipo

success

Informa se a operação teve sucesso ou não.

Boolean

msg

Mensagem de retorno.

String

lead

Dados do cliente criado.

full_name: (String) Nome do cliente.

created: (String) Data de criação do cliente.

modified: (String) Data da última alteração do cliente.

cpf: (String) CPF do cliente.

birthdate: (String) Data de nascimento do cliente.

phone: (String) Telefone do cliente.

email: (String) Email do cliente.

social_name: (String) Razão social do cliente.

cnpj: (String) CNPJ do cliente.

business_email: (String) Email empresarial do cliente.

observations: (String) Observações do cliente.

cep: (String) CEP do cliente.

address: (String) Endereço do cliente.

number: (String) Número do endereço do cliente.

neighborhood: (String) Bairro do cliente.

completion: (String) Complemento do endereço do cliente.

city_ibge: (String) Código IBGE da cidade vinculada ao cliente.

access_token: (String) Token do cliente.

Object

 
{
  "success": true,
  "msg": "Seu cliente foi criado com sucesso.",
  "lead": {
    "full_name": "João da Silva",
        "created": "01/01/2026 10:00:00",
        "modified": "01/01/2026 10:00:00",
        "cpf": "",
        "birthdate": "",
        "phone": "559999999999",
        "email": "[email protected]",
        "social_name": "",
        "cnpj": "",
        "business_email": "",
        "observations": "",
        "cep": "",
        "address": "",
        "number": "",
        "neighborhood": "",
        "completion": "",
        "city_ibge": "",
    "access_token": "LEAD_TOKEN"
  }
}
 
<?php
$apiKey = 'SEU_API_KEY';
$url = 'https://croncrm.com/api/v2/leads/create';

$payload = [
    'full_name' => 'João da Silva',
    'phone' => '559999999999',
    'email' => '[email protected]',
];

$ch = curl_init($url);
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_HTTPHEADER => [
        'apiKey: ' . $apiKey,
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => json_encode($payload, JSON_UNESCAPED_SLASHES | JSON_UNESCAPED_UNICODE),
]);

$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
$error = curl_error($ch);
curl_close($ch);

if ($error) {
    throw new RuntimeException($error);
}

echo "HTTP {$httpCode}\n";
echo $response;
?>
curl -X POST \
  'https://croncrm.com/api/v2/leads/create' \
  -H 'apiKey: SEU_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"full_name":"João da Silva","phone":"559999999999","email":"[email protected]"}'