Saltar al contenido
Docs

Referencia

Registro de cambios de API REST

Cambios en API REST: nuevas funciones, mejoras y correcciones.

octubre de 2026

  1. Mejorado

    El servidor MCP alojado cubre toda la API v2

    Servidor MCPAPI REST

    El servidor MCP en https://api.emailit.com/mcp cubre ahora todo lo que ofrece la API v2:

    • Nuevos conjuntos de herramientas: campañas, automatizaciones, formularios, informes DMARC, verificación de emails, eventos, acciones masivas y exportación de contactos, suscriptores, y pruebas, reintentos y rotación del secreto de los webhooks. Consulta la referencia de herramientas.
    • Anotaciones: cada herramienta está etiquetada como de solo lectura, destructiva, idempotente o de mundo abierto, para que los clientes puedan preguntar antes de ejecutar acciones de escritura.
    • Resultados estructurados: las herramientas devuelven JSON como texto y como contenido estructurado para los clientes que lo analizan.
    • Instrucciones integradas: el servidor indica a los asistentes que confirmen los destinatarios antes de enviar y que pregunten antes de eliminar nada.
    • Conjuntos de herramientas y modo de solo lectura: carga menos herramientas con ?toolsets= u oculta las herramientas de escritura con ?read_only=true. Consulta Conjuntos de herramientas.
    • Transporte sin estado: no hay sesiones MCP que caduquen; los clientes envían cada petición con POST.

    Corregido: las conexiones OAuth aprobadas con los permisos sending y full a la vez funcionan ahora en todas las herramientas, y el espacio de trabajo al que cambias sigue seleccionado después de que el cliente actualice su token.

septiembre de 2026

  1. Corregido

    Correcciones de compatibilidad de la API v2

    API RESTClaves de APIAPI de emailDominios de envío

    • Las claves de API creadas antes de que las claves tuvieran el prefijo secret_ vuelven a aceptarse en /v2.
    • Obtener un email devuelve el objeto de email completo, incluidos object, from y to.
    • Las respuestas de dominios devuelven track_loads y track_clicks como 0 o 1, tal como está documentado.
  2. Nuevo

    Registros de peticiones de la API y SMTP

    Registros de emailsAPI RESTSMTP relay

    Abre Email API → Logs para ver las peticiones correctas y fallidas desde la última hora hasta los últimos 30 días. Filtra por origen (API o SMTP), resultado, método, ruta, código de estado, duración o clave de API, y abre una petición para ver sus cuerpos de petición y respuesta. Los valores sensibles se ocultan y los cuerpos largos se acortan.

    Consulta Registros de peticiones.

  3. Nuevo

    Filtros y ordenación en todas las listas

    PanelAPI REST

    En el panel, usa Filters para combinar condiciones con Match all o Match any, haz clic en los encabezados de columna para ordenar y elige las columnas en Display options.

    En la API, filtra con parámetros de consulta field.condition=value, combínalos con match=all o match=or, y ordena con order y direction:

    Terminal
    curl "https://api.emailit.com/v2/emails?status.exact=bounced&created_at.after=2026-09-01&order=created_at&direction=desc" \
      -H "Authorization: Bearer $EMAILIT_API_KEY"

    Cada endpoint de listado documenta sus campos filtrables. Consulta Filtrado.

febrero de 2026

  1. Nuevo

    API de contactos, eventos y webhooks

    ContactosRegistros de emailsWebhooksAPI REST

    • Contactos: crea, lista, obtén, actualiza y elimina contactos. Busca un contacto por su ID con_ o por su dirección de email, y añádelo a listas de contactos en la misma llamada.
    • Eventos: lista eventos, filtrados por uno o varios tipos y, si quieres, con sus datos, y obtén un evento concreto.
    • Webhooks: crea, lista, obtén, actualiza y elimina endpoints de webhook.

    Estos endpoints necesitan una clave de acceso total. Consulta la referencia de la API.

enero de 2026

  1. Modificado

    ID de objeto con prefijo

    API REST

    Los ID son únicos entre servicios y se ordenan por fecha de creación. Los prefijos más habituales son em_ para emails, dom_ para dominios, key_ para claves de API, aud_ para listas de contactos, sub_ para suscriptores, con_ para contactos, sup_ para direcciones bloqueadas, wh_ para webhooks, evt_ para eventos y cmp_ para campañas.

    Guarda los ID como cadenas opacas en lugar de analizarlos.

  2. Obsoleto

    API v1 obsoleta

    API REST

    Las nuevas funciones solo se publican en la API v2, en https://api.emailit.com/v2. Si sigues llamando a /v1, cambia a los endpoints de v2 y envía tu clave de API en la cabecera Authorization: Bearer.

    Consulta Control de versiones.

octubre de 2025

  1. Nuevo

    API v2

    API RESTClaves de APIDominios de envíoListas de contactosDirecciones bloqueadas

    Las claves de API sustituyen a las credenciales. Una clave tiene el permiso full o sending, una clave de envío puede limitarse a un dominio de envío y puedes gestionar las claves con la API. La API v1 siguió disponible mientras migrabas.

    Consulta la referencia de la API.

¿Te ha resultado útil esta página?

Gracias por tu opinión.

Gracias. Leemos todos los mensajes.