Anuncios3 min de lectura
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.
GPor George
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 |
|---|---|
Lista paginada de todos los contactos | |
Obtener un contacto por ID o email | |
Crear un contacto y suscribirlo a listas | |
Actualizar el nombre, el email, los campos personalizados o el estado de baja | |
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.
{
"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 |
|---|---|
Lista paginada con filtro por tipo y payload de datos opcional | |
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=trueWebhooks
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 |
|---|---|
Lista paginada de todos los webhooks | |
Obtener un webhook por ID | |
Crear un nuevo endpoint de webhook | |
Actualizar la URL, los eventos o si está activado | |
Eliminar un webhook por ID o nombre |
Puedes suscribirte a tipos de eventos concretos o usar all_events para recibirlos todos.
{
"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.
Empieza ya
Las tres API requieren una clave de API con permisos completos. Consulta la referencia de la API para explorar todos los endpoints nuevos o ve directamente a la documentación enlazada más arriba.
