CZapyChat
POST/public/contacts

Criar ou atualizar contato

Cria o contato, ou atualiza se já existir um com o mesmo telefone ou e-mail. Informe ao menos um dos dois.

Chave com permissão de escrita (write)

Cabeçalhos

NomeTipoDescrição
AuthorizationobrigatóriostringBearer pk_sua_chave — a chave de API criada em Configurações › API Keys.
Content-Typeobrigatóriostringapplication/json

Corpo da requisição (JSON)

NomeTipoDescrição
phonestringTelefone com DDD.
emailstringE-mail.
namestringNome.
tagsstring[]Tags a aplicar (criadas se não existirem; até 5).
curl -X POST "https://api.zapychat.com.br/api/v1/public/contacts" \
  -H "Authorization: Bearer pk_sua_chave" \
  -H "Content-Type: application/json" \
  -d '{ "name": "Maria Souza", "phone": "71999990000", "email": "maria@exemplo.com", "tags": [ "VIP" ] }'
Resposta · 200
{
  "data": {
    "contact": {
      "id": "cmf2xyz789",
      "name": "Maria Souza",
      "phone": "5571999990000",
      "email": "maria@exemplo.com"
    },
    "created": true
  },
  "meta": {
    "timestamp": "2026-10-05T14:32:10.000Z"
  }
}