Growth OS API
Referência da APIContatos

Atualizar contato

Campo ausente = não mexe; `null` explícito limpa.

PATCH
/contacts/{id}

Campo ausente = não mexe; null explícito limpa.

Autorização

apiKey
AutorizaçãoBearer <token>

Chave de API (gos_…)

Em: header

Parâmetros de caminho

id*string
Length1 <= length

Corpo da requisição

application/json

Definições TypeScript

Use o tipo request body no TypeScript.

Corpo da resposta

curl -X PATCH "https://example.com/contacts/string" \  -H "Content-Type: application/json" \  -d '{}'
Vazio

Arquivar contato

Arquivamento reversível (soft). Não há exclusão definitiva pela API.

Buscar contato por id

Além dos campos de sempre, traz `firstHumanTouchAt`/`lastHumanTouchAt` (issue #728): a primeira e a última vez que alguém do seu time — não automação, não o próprio contato — tocou este contato (mensagem, ligação, e-mail ou nota; mesmo `actor:"user"` de `/interactions`). `null` = nunca houve toque humano identificado. Só aparece aqui, nunca em `GET /contacts` (a agregação é cara demais pra rodar por linha numa lista).