Enviar eventos desde tu backend

Envía eventos desde tus servidores para todo lo que no deba depender del navegador del visitante, como pedidos, pagos, cambios de suscripción o eventos de un back office. Esta página muestra cómo enviar un evento, cómo enviar muchos y cómo gestionar los errores.

Antes de empezar

• Enviar eventos está incluido en los planes Pro, Business y Custom. Un espacio de trabajo Pro puede usar 100 tipos de eventos, y uno Business, 1000. Consulta Límites.
• Crea una clave de API con el permiso Events Only en Email API›API Keys. Puede enviar eventos y nada más: no puede leer tus datos, gestionar las definiciones de eventos ni enviar emails. Una clave Full Access también sirve. Consulta Claves de API.
• Para enviar eventos de espacio de trabajo, primero defínelos. Los eventos personalizados no necesitan configuración.

Enviar un evento

Llama a Enviar un evento con el type del evento, sus properties y la persona a la que se refiere:

curl -X POST https://api.emailit.com/v2/events \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "c:order.completed",
    "email": "jane@example.com",
    "properties": { "order_id": "1001", "total": 59.9, "currency": "EUR" },
    "occurred_at": "2026-10-19T09:30:00Z"
  }'

• email vincula el evento al contacto que tiene esa dirección. Si ya conoces el ID del contacto, envía contact_id en su lugar.
• occurred_at es cuándo ocurrió, por ejemplo si envías eventos desde una cola. Omítelo para usar la hora actual.
• La respuesta es 201 con el evento guardado y su ID evt_. Con una clave Events Only, el evento se devuelve sin data.

Enviar muchos eventos a la vez

Enviar eventos por lotes acepta hasta 100 eventos en una petición, lo que va bien para importaciones y sincronizaciones programadas:

curl -X POST https://api.emailit.com/v2/events/batch \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "events": [
      { "type": "c:order.completed", "email": "jane@example.com", "properties": { "order_id": "1001", "total": 59.9 } },
      { "type": "c:order.completed", "email": "omar@example.com", "properties": { "order_id": "1002", "total": 18 } }
    ]
  }'

Un lote es todo o nada: si un evento no es válido, no se guarda ninguno. La respuesta 422 muestra cada problema en events.<index>, así que puedes corregir o quitar esos eventos y volver a enviar el lote.

Gestionar los errores

Los eventos no tienen clave de idempotencia, así que reintentar una petición que ya se procesó guarda el evento dos veces. Pon tu propio ID en las propiedades, como order_id, para que quien lea los eventos pueda reconocer los duplicados.

Comprobar que llegan los eventos

Abre Email API›Events. La pestaña Log muestra los eventos nuevos arriba; en Scope, elige Custom o Workspace para ocultar los eventos de sistema. Selecciona un evento para ver sus propiedades, el contacto al que pertenece y de dónde vino. Los eventos vinculados a un contacto también aparecen en el Activity log del contacto.

Ver también