¿Dónde encontrar la API?

Ve a Ajustes → API. La página tiene tres pestañas: Claves, Webhooks y Actividad. Solo los usuarios con el rol Propietario ven esta página.

  • URL base: https://api.v2.xendy.me/v1
  • Documentación (OpenAPI): https://api.v2.xendy.me/v1/openapi.json. Puedes abrirla sin clave API y cargarla en herramientas como Postman.

Crear una clave API

  1. En la pestaña Claves, haz clic en Crear clave API.
  2. Dale a la clave un Nombre reconocible, por ejemplo Conexión tienda online.
  3. Elige por tipo de dato qué puede hacer la clave: Leer y/o Escribir. No otorgues más permisos de los que tu integración necesita.
  4. Haz clic en Crear. Copia la clave y haz clic en He guardado el valor. Solo verás la clave una vez.

Incluye la clave en cada solicitud como cabecera: Authorization: Bearer xnd_live_.... La clave determina automáticamente a qué cuenta pertenece.

Tipo de datoLeerEscribir
ContactosObtener contactosCrear, actualizar, suscribir y desuscribir contactos, y añadirlos o eliminarlos de una lista
Listas de correo y audienciasObtener listas y segmentosCrear una lista
CampañasObtener campañas–
Enviar–Enviar o programar una campaña existente como boletín
InformesObtener estadísticas de boletines y automatizaciones–
CuentaEl token para carritos abandonados (necesario para el plugin de WordPress)–
WebhooksObtener webhooksRegistrar y eliminar webhooks

Atención: con Enviar (escribir) la clave puede enviar boletines reales a tus contactos. Actívalo solo si tu integración lo necesita.

Revocar una clave API

En la lista de claves ves por cada clave los Permisos y cuándo se usó por última vez (Último uso). Si ya no quieres usar una clave, haz clic en el icono de papelera en Eliminar y confirma. Las integraciones que usen esa clave dejarán de funcionar de inmediato. Esta acción no se puede deshacer.

Webhooks: Xendy te envía un mensaje

Con un webhook, Xendy envía automáticamente una solicitud POST a tu URL cuando ocurre algo. Puedes elegir entre tres eventos:

  • Registros DNS incorrectos (dns-records.failed)
  • Registros DNS recuperados (dns-records.recovered)
  • Importación de tienda online fallida (webshop-import.failed)
  1. En la pestaña Webhooks, haz clic en Añadir webhook.
  2. Introduce la URL (solo https) y elige los Eventos.
  3. Haz clic en Añadir. Copia el secreto del webhook que aparece: solo lo verás una vez.

Cada mensaje es JSON con id, event, created_at y data, y lleva las cabeceras Xendy-Event, Xendy-Delivery y Xendy-Signature. Con la firma verificas que el mensaje proviene realmente de Xendy. Xendy-Signature tiene la forma t=<momento>,v1=<firma>: la firma es un HMAC-SHA256 de <t>.<body> con tu secreto. Rechaza los mensajes cuyo t sea anterior a 5 minutos. En la documentación encontrarás un ejemplo en JavaScript.

Responde en 10 segundos con un código de estado 2xx. Si la entrega falla, Xendy lo reintenta después de 1, 5 y 30 minutos. Si cinco eventos consecutivos fallan por completo, Xendy pone el webhook en Desactivado. Cada intento queda registrado en la pestaña Actividad, bajo Webhook saliente.

Límites

  • 120 solicitudes por minuto por clave
  • Acciones de escritura: 60 por minuto
  • Enviar: 10 por minuto

Si los superas, recibirás HTTP 429. Al enviar un boletín, incluye una cabecera Idempotency-Key: en 24 horas, el mismo valor devuelve el mismo boletín en lugar de un segundo envío.

Preguntas frecuentes

No. Xendy muestra una clave solo una vez y no la almacena de forma legible. Crea una nueva clave, ponla en tu integración y luego revoca la antigua.

No. Una clave API (xnd_live_...) solo funciona en la API y una clave MCP (xnd_mcp_...) solo para asistentes de IA a través de MCP. Con una clave MCP obtendrás el código de error 401 en la API.

Significa que cinco eventos consecutivos no se han podido entregar, ni siquiera tras los reintentos. En la pestaña Actividad (tipo Webhook saliente) puedes ver qué respondió tu servidor. Soluciona el problema, elimina el webhook y vuelve a añadirlo.

En la pestaña Webhooks configuras los mensajes que Xendy envía a tu sistema. Si quieres enviar contactos tú mismo a Xendy, usa en un segmento Añadir contactos → Mediante un webhook. Eso funciona con un token propio en lugar de una clave API. Consulta Conectar mediante Zapier.

En la pestaña Actividad ves cada llamada con su estado, duración y los datos enviados. Consulta Ver actividad de la API.

Joeri Ras

Escrito por

Joeri Ras

Fundador y copropietario @ Xendy

¿Prefieres contacto directo?

Artículos relacionados

Integraciones

Conectar Gravity Forms

Con Gravity Forms puedes crear formularios fácilmente en WordPress. Al conectarlo con Xendy, los envíos llegan automáticamente a un segmento estático, para que puedas usar los nuevos contactos directamente en newsletters o automatizaciones de correo.

Leer más
Integraciones

Conectar tu tienda Lightspeed

Al conectar Lightspeed con Xendy, los datos de clientes, pedidos y productos se sincronizan automáticamente cada noche. Así puedes crear segmentos basados en el comportamiento de compra y mostrar productos directamente en tus correos electrónicos. Con dos scripts en tu tienda online también puedes hacer seguimiento de los carritos abandonados.

Leer más
Integraciones

Conectar tu tienda Magento 2

Al conectar Magento 2 con Xendy, los datos de clientes, pedidos y productos se sincronizan automáticamente cada noche. Así puedes crear segmentos basados en el comportamiento de compra, mostrar recomendaciones de productos personalizadas y hacer seguimiento de carritos abandonados. Ten en cuenta: los carritos abandonados en Magento 2 solo funcionan para clientes que han iniciado sesión en tu tienda. Xendy los recupera durante la importación nocturna.

Leer más
Integraciones

Conectar tu tienda Shopify

Al conectar Shopify con Xendy, tus clientes, pedidos y productos llegan a Xendy. Así puedes crear segmentos basados en el comportamiento de compra y añadir productos a tus correos electrónicos. Puedes conectarlo a través de la app de Xendy en Shopify o con una app propia desde el Shopify Dev Dashboard. Con la app de Xendy, los cambios llegan de inmediato, los carritos abandonados funcionan y las cancelaciones de suscripción se sincronizan en ambas direcciones. Con una app propia, tus datos se actualizan cada noche.

Leer más