Contatos

Criar contato

POSThttps://api.seudominio.com.br/integrations/v1/contacts

Cria um contato. Com telefone já cadastrado, devolve o existente.

É idempotente pelo telefone: se já houver um contato com o mesmo número, ele é devolvido com created: false e status 200 — seguro para automações que rodam mais de uma vez.

Corpo da requisição

application/json

namestring

Nome do contato. Obrigatório se não houver telefone.

phone_numberstring (telefone)

Telefone. Obrigatório se não houver nome.

emailstring (email)

E-mail.

Corpo para testar

Respostas

AnteriorListar contatos Próximo Buscar contato

Token (Bearer)

Fica só nesta aba do navegador e é usado nos exemplos abaixo.

curl --request POST \
  --url 'https://api.seudominio.com.br/integrations/v1/contacts' \
  --header 'Authorization: Bearer sk_SEU_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "name": "Maria Souza",
  "phone_number": "11999990000",
  "email": "maria@email.com"
}'

A chamada é real: age sobre os dados do seu workspace.

Resposta

{
  "contact": {
    "id": 35,
    "name": "Maria Souza",
    "phone_number": "+5511999990000",
    "email": "maria@email.com",
    "created_at": 1727200000,
    "opted_out": false
  },
  "created": true
}