# Notas

> Crear, actualizar y gestionar notas sobre contactos

Source: https://docs.graph8.com/es/developers/notes/

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**

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

**Python**

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

**TypeScript**

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

### Respuesta

```json
{
  "data": [
    {
      "id": "note-abc",
      "content": "Spoke with Jane about the Q2 renewal.",
      "entity_type": "contact",
      "entity_id": "12345",
      "created_by": "user@company.com",
      "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 |

### Ejemplo

**cURL**

```bash
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."}'
```

**Python**

```python
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.