Criar nota no contato

v1.0.0

POSThttps://api.staging.growthaisystem.com/api/v1/contacts/{id}/notes

ExigeAuthorization: Bearer gos_…— Chave de API (gos_…)· escoposcontacts.write

Parâmetros de caminho

Entram no próprio endereço, no lugar das chaves.

idstringobrigatório
- tamanho mín. 1

Corpo da requisição

application/jsonobrigatório

bodystringobrigatório
- tamanho 1–10000
titlestringopcional
- tamanho 1–200

Respostas

11 respostas documentadas — o código, o que ele significa nesta rota e a forma do corpo.

201Deu certoapplication/json

Nota registrada na linha do tempo do contato; devolve o id da nota e o instante do registro. Repetir a Idempotency-Key também responde 201 (esta rota não sinaliza replay).

V1NoteCriada

idstring | null
createdAtstring

Definição

POST/contacts/{id}/notes

Exemplo

https://api.staging.growthaisystem.com/api/v1/contacts/SEU_ID_AQUI/notes

Requisição

curl -X POST "https://api.staging.growthaisystem.com/api/v1/contacts/SEU_ID_AQUI/notes" \
  -H "Authorization: Bearer gos_SEU_TOKEN_AQUI" \
  -H "Content-Type: application/json" \
  -d '{
  "title": "Ligação de qualificação",
  "body": "Mariana pediu proposta de 300 unidades para dezembro. Retornar na segunda, 15/09, às 10h."
}'

Isto chama a API de verdade. A requisição sai do seu navegador direto para https://api.staging.growthaisystem.com — dado real, do workspace da chave que você colar. Em escritas, o efeito é permanente.

Chave de APIBearerobrigatório

Vai no cabeçalho Authorization: Bearer …. Ela nunca aparece no cURL copiável nem sai desta aba.

Lembrar nesta aba — some ao fechá-la. Não marque em computador compartilhado: a chave dá acesso ao workspace inteiro dentro dos escopos dela.

Parâmetros de caminho

Entram no próprio endereço, no lugar das chaves.

idtextoobrigatório

Corpoapplication/jsonobrigatório

JSON válido· 4 linhas

O exemplo vem do próprio schema da API. Troque os valores pelos seus antes de enviar.

Vai sair assim

POSThttps://api.staging.growthaisystem.com/api/v1/contacts/{id}/notes

O botão copia o cURL equivalente — com gos_SEU_TOKEN_AQUI no lugar da sua chave.

⌘Enter

Resposta

{
  "id": "b7e2d914-3c05-4f6a-8d21-5e9c0a4b7f38",
  "createdAt": "2026-09-13T15:31:08.512Z"
}