Notas

Las notas permiten adjuntar anotaciones de texto libre a los contactos para agregar contexto, dar seguimiento y facilitar la colaboración del equipo.

Listar notas

GET /contacts/{contact_id}/notes

Devuelve todas las notas de un contacto, ordenadas de la más reciente a la más antigua.

Parámetros de ruta

Parámetro	Tipo	Descripción
`contact_id`	string	ID del contacto

Ejemplo

curl "https://be.graph8.com/api/v1/contacts/12345/notes" \
  -H "Authorization: Bearer $API_KEY"

response = requests.get(
    f"{BASE_URL}/contacts/12345/notes",
    headers=HEADERS
)
notes = response.json()

const response = await fetch(`${BASE_URL}/contacts/12345/notes`, {
  headers: { Authorization: `Bearer ${API_KEY}` }
});
const notes = await response.json();

Respuesta

{
  "data": [
    {
      "id": "note-abc",
      "content": "Spoke with Jane about the Q2 renewal.",
      "entity_type": "contact",
      "entity_id": "12345",
      "created_by": "[email protected]",
      "created_at": "2026-02-25T14:30:00Z",
      "updated_at": "2026-02-25T14:30:00Z"
    }
  ]
}

Crear nota

POST /contacts/{contact_id}/notes

Cuerpo de la solicitud

Campo	Tipo	Requerido	Descripción
`content`	string	Sí	Contenido de texto de la nota

curl -X POST "https://be.graph8.com/api/v1/contacts/12345/notes" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"content": "Follow up next week about pricing."}'

response = requests.post(
    f"{BASE_URL}/contacts/12345/notes",
    headers=HEADERS,
    json={"content": "Follow up next week about pricing."}
)

Actualizar nota

PATCH /notes/{note_id}

Cuerpo de la solicitud

Campo	Tipo	Requerido	Descripción
`content`	string	Sí	Texto actualizado de la nota

Eliminar nota

DELETE /notes/{note_id}

Devuelve 204 No Content cuando la operación es exitosa.