Quantika API Docs
v1.0 (Public API)

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:

CampoTipoObrigatórioDescrição
phonestringSim*Telefone com DDD. Obrigatório se email não for fornecido.
emailstringSim*Endereço de e-mail. Obrigatório se phone não for fornecido.
namestringOpcionalNome completo do contato/cliente.
tagsstring[]OpcionalLista de tags/etiquetas para segmentar o contato (ex: ["VIP", "Lead"]).

Testar Criação no Playground

Playground Interativo Seguro

Rate Limited
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"