Referencia
Registro de cambios de API REST
Cambios en API REST: nuevas funciones, mejoras y correcciones.
octubre de 2026
Mejorado
El servidor MCP alojado cubre toda la API v2
El servidor MCP en
https://api.emailit.com/mcpcubre 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
sendingyfulla 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
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,fromyto. - Las respuestas de dominios devuelven
track_loadsytrack_clickscomo0o1, tal como está documentado.
- Las claves de API creadas antes de que las claves tuvieran el prefijo
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.
Nuevo
Filtros y ordenación en todas las listas
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 conmatch=allomatch=or, y ordena conorderydirection: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
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.
- Contactos: crea, lista, obtén, actualiza y elimina contactos. Busca un contacto por su ID
enero de 2026
Modificado
ID de objeto con prefijo
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 ycmp_para campañas.Guarda los ID como cadenas opacas en lugar de analizarlos.
Obsoleto
API v1 obsoleta
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 cabeceraAuthorization: Bearer.Consulta Control de versiones.
octubre de 2025
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
fullosending, 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.