Nuevos Endpoints de API: Contactos, Eventos y Webhooks
Acabamos de lanzar tres nuevos grupos de recursos en la API v2 de Emailit. Son Contactos, Eventos y Webhooks. En conjunto te brindan control programático completo sobre tu libreta de contactos, monitoreo de eventos e integraciones de webhooks.
Contactos
La API de Contactos te permite crear, leer, actualizar y eliminar contactos en tu espacio de trabajo. Cada contacto contiene una dirección de correo electrónico, nombre opcional y campos personalizados, y puede suscribirse a una o más audiencias en una sola llamada.
| Endpoint | Descripción |
|---|---|
| Listar Contactos | Lista paginada de todos los contactos |
| Obtener Contacto | Recuperar un contacto por ID o correo electrónico |
| Crear Contacto | Crear un nuevo contacto y suscribir a audiencias |
| Actualizar Contacto | Actualizar nombre, correo, campos personalizados o estado de suscripción |
| Eliminar Contacto | Eliminar un contacto y todos los suscriptores asociados |
Los contactos se pueden buscar por su ID (con_xxx) o por dirección de correo electrónico, así puedes usar el identificador que te resulte más conveniente.
{
"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 algo sucede en tu espacio de trabajo. Por ejemplo, se entrega un correo electrónico, 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 | Lista paginada con filtrado por tipo y carga de datos opcional |
| Obtener Evento | Recuperar un evento individual con datos completos |
Puedes filtrar por uno o más tipos de eventos usando valores separados por comas, y alternar include_data para controlar si se devuelve la carga completa en las respuestas de lista.
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 ocurren eventos. La nueva API de Webhooks te da control completo. Puedes crear, actualizar, habilitar/deshabilitar y eliminar endpoints de webhook, todo a través de la API.
| Endpoint | Descripción |
|---|---|
| Listar Webhooks | Lista paginada de todos los webhooks |
| Obtener Webhook | Recuperar un webhook por ID |
| Crear Webhook | Crear un nuevo endpoint de webhook |
| Actualizar Webhook | Actualizar URL, eventos o estado habilitado |
| Eliminar Webhook | Eliminar un webhook por ID o nombre |
Puedes suscribirte a tipos de eventos específicos o usar all_events para recibir todo.
{
"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 correos electrónicos, dominios, audiencias, suscriptores, contactos, plantillas, supresiones y verificaciones de correo electrónico. Consulta la lista completa en la documentación de Crear Webhook.
Comenzar
Las tres APIs requieren una clave API con permisos completos. Dirígete a la Referencia de API para explorar todos los nuevos endpoints, o ve directamente a la documentación enlazada arriba.
Blog
Las últimas noticias y actualizaciones, directamente desde Emailit.
Mantente al día con los últimos artículos del Blog de Emailit.
