Contatos & Leads
Cadastre novos clientes, sincronize dados de ERPs ou plataformas de checkout (Shopify, Hotmart, Kiwify) e consulte sua base com paginação e busca rápida.
Criar ou Atualizar Contato (Upsert)
O endpoint POST /api/v1/contacts realiza uma inserção inteligente (Upsert). Se já existir um contato com o mesmo telefone ou e-mail na sua organização, os dados serão atualizados em vez de duplicar.
POST /api/v1/contacts
curl -X POST https://quantikahub.com/api/v1/contacts \
-H "Authorization: Bearer SEU_CLIENT_TOKEN" \
-H "X-Client-Id: SEU_CLIENT_ID" \
-H "Content-Type: application/json" \
-d '{
"name": "Mariana Souza",
"phone": "+5511988887777",
"email": "mariana.souza@exemplo.com",
"tags": ["VIP", "Lead Inbound"]
}'Resposta 201 Created (JSON)
{
"success": true,
"data": {
"id": "c7a8b9e0-1234-5678-90ab-cdef12345678",
"name": "Mariana Souza",
"phone": "5511988887777",
"email": "mariana.souza@exemplo.com",
"isNew": true
}
}Campos do Payload:
| Campo | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| phone | string | Sim* | Telefone com DDD. Obrigatório se email não for fornecido. |
| string | Sim* | Endereço de e-mail. Obrigatório se phone não for fornecido. | |
| name | string | Opcional | Nome completo do contato/cliente. |
| tags | string[] | Opcional | Lista de tags/etiquetas para segmentar o contato (ex: ["VIP", "Lead"]). |
Testar Criação no Playground
Playground Interativo Seguro
api.quantikahub.com
Listar e Filtrar Contatos
Recupere sua lista com paginação (?page=1&limit=50) ou pesquise por termo livre com ?q=:
GET /api/v1/contacts
curl -X GET "https://quantikahub.com/api/v1/contacts?q=Mariana&limit=10" \
-H "Authorization: Bearer SEU_CLIENT_TOKEN" \
-H "X-Client-Id: SEU_CLIENT_ID"