Disponible hoy
curl + cualquier HTTP client
La API es REST JSON estándar. Cualquier lenguaje que pueda hacer HTTP la consume.
REST API v3
eMail Marketing, programable
REST sobre JSON, autenticación JWT, 11 módulos, más de 100 endpoints documentados. Conectá arrobaMail con tu stack en minutos.
- 100+Endpoints
- 11Módulos
- JWTAuth
El Plan Gratuito funciona como sandbox: cuenta real con todas las funciones, API y MCP incluidos, sin tarjeta.
curl · ejemplo
# 1. Obtené tu token JWT
curl -X POST https://envios.arrobamail.com/v3/api/auth/getToken \
-H "Content-Type: application/json" \
-d '{"username":"tucuenta","pass":"***"}'
# 2. Listá campañas activas
curl https://envios.arrobamail.com/v3/api/campaigns?status=active \
-H "Authorization: Bearer eyJhbGciOi..."
# 3. Lanzá una campaña a tus listas
curl -X POST https://envios.arrobamail.com/v3/api/campaigns \
-H "Authorization: Bearer eyJhbGciOi..." \
-d '{"camp_name":"Promo abril","asunto":"Llegó la promo","html":"<h1>Hola</h1>","from_name":"Tu empresa","from_mail":"promos@tudominio.com","list_id":["1A2B3C"]}'Quickstart
De cero a primer envío en 3 requests
Sin SDK ni librerías propias: REST sobre JSON desde tu stack. Elegí tu lenguaje y seguí los tres pasos.
- 01Paso 1
Conseguí tu token JWT
Con tu usuario y contraseña, POST /auth/getToken te devuelve un token Bearer que vas a usar en el resto de las llamadas. Soporta rememberMe para que dure hasta 365 días.
curlcurl -X POST https://envios.arrobamail.com/v3/api/auth/getToken \ -H "Content-Type: application/json" \ -d '{"username":"tucuenta","pass":"***"}' # 200 OK # { "token": "eyJhbGciOi..." } - 02Paso 2
Verificá un remitente
El remitente (from) tiene que estar verificado antes de enviar. Al crearlo, arrobaMail corre los chequeos de DNS (SPF/DKIM) si no es un email gratuito.
curlcurl -X POST https://envios.arrobamail.com/v3/api/senders \ -H "Authorization: Bearer $TOKEN" \ -H "Content-Type: application/json" \ -d '{"from_name":"Tu empresa","from_mail":"promos@tudominio.com"}' # 200 OK # { "status": "ok", "spf": true, "dkim": true } - 03Paso 3
Lanzá tu primera campaña
Una llamada POST con el nombre, el asunto, el HTML, el remitente y la lista encola el envío. Sumás track_reads y track_links para medir aperturas y clics.
curlcurl -X POST https://envios.arrobamail.com/v3/api/campaigns \ -H "Authorization: Bearer $TOKEN" \ -H "Content-Type: application/json" \ -d '{ "camp_name": "Promo abril", "asunto": "Llegó la promo", "html": "<h1>Hola</h1>", "from_mail": "promos@tudominio.com", "list_id": ["1A2B3C"] }' # 200 OK → { "ok": true }
Módulos
11 módulos · 100+ endpoints
Cobertura completa de la plataforma. Tocá un módulo para ver su referencia: endpoints, parámetros, respuestas y ejemplos en curl, Node, PHP y Python.
Módulo 012 endpoints
Auth
JWT Bearer Token, rate limiting por IP y username, soporte multi-idioma (es/en) y rememberMe para sesiones de 365 días.
- POST /auth/getToken
- POST /auth/logout
Módulo 0322 endpoints
Campaigns
Crear, programar y enviar campañas. HTML personalizado, editor visual, plantillas, tracking de aperturas, clicks, conversiones y bounces.
- POST /campaigns
- PUT /campaigns/:id/send
- GET /campaigns/:id/stats
Módulo 0424 endpoints
Lists & Contacts
Listas, importación CSV/Excel, custom fields, doble opt-in, herramientas de limpieza, gestión de unsubscribes y bounces.
- POST /lists
- POST /lists/:id/contacts
- DELETE /lists/:id/contacts/:contact
Módulo 0513 endpoints
Segmentations
Segmentación V2 con grupos de condiciones avanzados, segmentación por comportamiento (aperturas, clicks) y por campos custom.
- POST /segments
- GET /segments/:id/preview
Módulo 0621 endpoints
Users & Roles
Roles Admin / Reseller / Usuario. Gestión de subcuentas, jerarquía reseller, endpoint público para signup de demo.
- POST /users
- GET /users/:id
- PUT /users/:id/role
Módulo 073 endpoints
Senders
Verificación de remitentes, from name, from email y reply_to configurables por sender.
- POST /senders/verify
- GET /senders
Módulo 083 endpoints
Templates
Plantillas reutilizables, importación y exportación entre cuentas.
- POST /templates
- GET /templates/:id
Módulo 094 endpoints
Dashboard
Métricas consolidadas del usuario autenticado: envíos, aperturas, clicks y bounces.
- GET /dashboard
- GET /dashboard/stats
Módulo 102 endpoints
Search
Búsqueda transversal en campañas, listas y contactos.
- GET /search?q=
Módulo 123 endpoints
Subscription
Endpoints públicos (sin auth) para autoservicio de suscriptores. Usable en formularios embebidos en sitios externos.
- POST /public/subscribe
- POST /public/unsubscribe
Módulo 169 endpoints
Automations V2
Flujos automatizados con nodos y aristas. Triggers por eventos, acciones encadenables y delays configurables.
- POST /automations
- PUT /automations/:id/activate
¿Buscás algo puntual? Explorá la referencia completa con buscador de endpoints.
Webhooks bidireccionales
Tu app reacciona en tiempo real
Configurás una URL de tu app y te enviamos POSTs HTTP con eventos a medida que suceden: una campaña terminó, un contacto abrió, un mail bounced, alguien se dio de baja, un flow de automation se disparó.
- Eventos para aperturas, clicks, rebotes, quejas, bajas y automatizaciones
- POSTs HTTP hacia la URL que configures en tu sistema
- Historial de eventos para auditar qué ocurrió y cuándo
- Útil para CRM, ecommerce, sistemas internos y tableros propios
Endpoint receptor
POST https://tudominio.com/webhooks/arrobamailEventos disponiblesLive feed
campaign.sentPOST{ "campaign_id": 9821, "sent_at": "2026-05-26T14:32:00Z", "recipients": 8420 }Una campaña terminó su envío.
contact.openPOST{ "campaign_id": 9821, "contact_id": 555012, "opened_at": "..." }Un contacto abrió un mail.
contact.bouncePOST{ "contact_id": 555013, "type": "hard", "reason": "user_not_found" }Un mail bounced.
contact.complaintPOST{ "contact_id": 555014, "campaign_id": 9821 }Un destinatario reportó spam.
contact.unsubscribePOST{ "contact_id": 555015, "list_id": 1234 }Un contacto se dio de baja.
automation.triggeredPOST{ "automation_id": 88, "contact_id": 555016, "node": "welcome" }Un contacto entró en un flujo de automation.
Clientes HTTP
Integrá con el stack que ya usás
La API es REST JSON: no dependés de una librería propietaria para empezar a operar.
Disponible hoy
JavaScript / TypeScript
Usá fetch nativo, Axios u otro cliente HTTP. Los ejemplos muestran headers, payload y respuesta.
Disponible hoy
Python
Consumí la API con requests, httpx o el cliente HTTP que ya use tu stack.
Disponible hoy
PHP
Funciona con cURL, Guzzle o clientes PSR-18. No necesitás una librería propietaria.
Preguntas frecuentes
Lo que más se consulta de la API
Con un token JWT. Pedís el token con POST /auth/getToken (tu usuario y contraseña) y lo mandás en el header Authorization de cada llamada. Podés activar rememberMe para sesiones de hasta 365 días. Una aclaración: crear cuentas no es parte de la API pública —las altas las gestiona el reseller—.
Sí, aplicamos límites por IP y por usuario. Son holgados para un uso normal; si detectamos abuso, bajamos la velocidad automáticamente. Si tu integración necesita un cupo mayor, escribinos y lo vemos según tu caso.
REST. JSON sobre HTTP, con los verbos de siempre (GET, POST, PUT, DELETE) y códigos de estado estándar. Elegimos REST porque es lo más universal y fácil de consumir desde cualquier lenguaje.
Sí. Configurás una URL en tu cuenta y arrobaMail te avisa cuando pasa algo: una campaña terminó de enviarse, alguien abrió, un correo rebotó, alguien se quejó o se dio de baja, o un contacto entró en una automatización. Es la forma de que tu sistema reaccione en tiempo real.
No hace falta. La API es REST/JSON y funciona con curl, fetch, Axios, requests, httpx, Guzzle o el cliente HTTP que ya use tu stack. El quickstart trae ejemplos en curl, Node, PHP y Python listos para copiar. Si tu equipo necesita una librería específica, contanos el stack.
Sí. arrobaMail tiene un servidor MCP para que asistentes como Claude o Cursor consulten datos, preparen borradores y ejecuten acciones, siempre dentro de los permisos que definís. Es complementario a la API: MCP para el día a día asistido, la API para integraciones a medida.
Sí: la cuenta del Plan Gratuito funciona como sandbox. Hacés todo lo que harías en producción —con envíos mensuales y generaciones de IA incluidas, sin tarjeta—. Para un volumen mayor de testing antes de salir a producción, hablanos.
Ecosistema de integración
Seguí explorando el ecosistema
Empezá con arrobaMail
en menos de 5 minutos.
Plan Gratuito, generaciones de IA incluidas, sin tarjeta de crédito y soporte real en español.