# Nuevos endpoints de la API: contactos, eventos y webhooks

> Gestiona contactos, consulta eventos y configura webhooks de forma programática con las últimas novedades de la API de Emailit.

2026-02-17 · George (https://x.com/thegeorge, https://www.linkedin.com/in/jiri-zizka/)

Acabamos de lanzar tres nuevos grupos de recursos en la API v2 de Emailit: **Contactos**, **Eventos** y **Webhooks**. Juntos te dan control programático total sobre tu agenda de contactos, la monitorización de eventos y tus integraciones de webhooks.

## Contactos

La API de contactos te permite crear, leer, actualizar y eliminar los contactos de tu espacio de trabajo. Cada contacto tiene una dirección de email, un nombre y campos personalizados opcionales, y puede suscribirse a una o varias listas con una sola llamada.

| Endpoint | Descripción |
| --- | --- |
| [Listar contactos](https://emailit.com/docs/api-reference/contacts/list) | Lista paginada de todos los contactos |
| [Obtener contacto](https://emailit.com/docs/api-reference/contacts/get) | Obtener un contacto por ID o email |
| [Crear contacto](https://emailit.com/docs/api-reference/contacts/create) | Crear un contacto y suscribirlo a listas |
| [Actualizar contacto](https://emailit.com/docs/api-reference/contacts/update) | Actualizar el nombre, el email, los campos personalizados o el estado de baja |
| [Eliminar contacto](https://emailit.com/docs/api-reference/contacts/delete) | Eliminar un contacto y todos sus suscriptores asociados |

Puedes buscar los contactos por su ID (`con_xxx`) o por su dirección de email, así que usa el identificador que te resulte más cómodo.

```json
{
  "email": "juan@ejemplo.com",
  "first_name": "Juan",
  "last_name": "Pérez",
  "custom_fields": { "company": "Acme" },
  "audiences": ["aud_2BxFg7KNqr5M..."]
}
```

## Eventos

Los eventos se crean automáticamente cada vez que ocurre algo en tu espacio de trabajo: se entrega un email, se crea un contacto, se actualiza un dominio, etc. La API de eventos te da acceso de solo lectura a este flujo de actividad.

| Endpoint | Descripción |
| --- | --- |
| [Listar eventos](https://emailit.com/docs/api-reference/events/list) | Lista paginada con filtro por tipo y payload de datos opcional |
| [Obtener evento](https://emailit.com/docs/api-reference/events/get) | Obtener un evento concreto con todos sus datos |

Puedes filtrar por uno o varios tipos de eventos con valores separados por comas, y activar o desactivar `include_data` para controlar si las respuestas de la lista incluyen el payload completo.

```
GET /v2/events?type=email.accepted,email.delivered&include_data=true
```

## Webhooks

Los webhooks te permiten recibir callbacks HTTP en tiempo real cada vez que se produce un evento. La nueva API de webhooks te da control total: puedes crear, actualizar, activar/desactivar y eliminar endpoints de webhook, todo a través de la API.

| Endpoint | Descripción |
| --- | --- |
| [Listar webhooks](https://emailit.com/docs/api-reference/webhooks/list) | Lista paginada de todos los webhooks |
| [Obtener webhook](https://emailit.com/docs/api-reference/webhooks/get) | Obtener un webhook por ID |
| [Crear webhook](https://emailit.com/docs/api-reference/webhooks/create) | Crear un nuevo endpoint de webhook |
| [Actualizar webhook](https://emailit.com/docs/api-reference/webhooks/update) | Actualizar la URL, los eventos o si está activado |
| [Eliminar webhook](https://emailit.com/docs/api-reference/webhooks/delete) | Eliminar un webhook por ID o nombre |

Puedes suscribirte a tipos de eventos concretos o usar `all_events` para recibirlos todos.

```json
{
  "name": "Webhook de Producción",
  "url": "https://ejemplo.com/webhook",
  "events": ["email.accepted", "email.delivered", "email.bounced"]
}
```

Hay más de 30 tipos de eventos disponibles para emails, dominios, listas de contactos, suscriptores, contactos, plantillas, direcciones bloqueadas y verificaciones de emails. Consulta la lista completa en la documentación de [Crear webhook](https://emailit.com/docs/api-reference/webhooks/create).

## Empieza ya

Las tres API requieren una clave de API con permisos completos. Consulta la [referencia de la API](https://emailit.com/docs/api-reference/endpoints) para explorar todos los endpoints nuevos o ve directamente a la documentación enlazada más arriba.

---

Source: https://emailit.com/es/blog/nuevos-endpoints-api-contactos-eventos-webhooks/