Criar contato

POST

/api/contacts

Cria um contato. first_name, last_name, phone e email são todos obrigatórios.

O telefone é validado de verdade (phone:AUTO) e precisa ser único na organização —
duplicado retorna 400. É normalizado para E.164 antes de gravar.

Retorna 200 (não 201), e o id da resposta é o uuid do contato — use-o nas
demais rotas.

Requisição

Authorization

Forneça seu token bearer no cabeçalho

Authorization

ao fazer requisições para recursos protegidos.

Exemplo:

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

Parâmetros Bodyapplication/jsonNecessário

Exemplo

{
    "first_name": "João",
    "last_name": "Silva",
    "phone": "+5511999999999",
    "email": "joao@exemplo.com",
    "group": "fbd899a6-8a66-4f51-a95d-68668de198ae",
    "street": "string",
    "city": "string",
    "state": "string",
    "zip": "string",
    "country": "string",
    "deal_value": 0,
    "metadata": {
        "property1": "string",
        "property2": "string"
    }
}

Exemplos de Requisição

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://titov.com.br/api/contacts' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "first_name": "João",
    "last_name": "Silva",
    "phone": "+5511999999999",
    "email": "joao@exemplo.com",
    "group": "fbd899a6-8a66-4f51-a95d-68668de198ae",
    "street": "string",
    "city": "string",
    "state": "string",
    "zip": "string",
    "country": "string",
    "deal_value": 0,
    "metadata": {
        "property1": "string",
        "property2": "string"
    }
}'

Respostas

🟢200OK

application/json

Operação concluída. O campo id é o uuid do contato, não o ID numérico interno.

Bodyapplication/json

Exemplo

{
    "statusCode": 200,
    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
    "message": "Request processed successfully"
}

🟠400Requisição Inválida

🟠401Não Autorizado

🔴500Erro do Servidor

Modificado em 2026-07-17 11:51:13

Página anterior

Listar conversa do contato

Próxima página

Atualizar contato