Módulo 169 endpoints

Automations `/automations`

Flujos de automatización V2 con nodos y aristas.

Endpoints

9 en total

GET/automationsUsuario

Listar flujos de automatización

Query params

Nombre	Tipo	Req.	Default	Descripción
`status`	`string`	No	`-`	draft, active, paused, archived
`page`	`number`	No	`1`	Página
`limit`	`number`	No	`50`	Items por página

Ejemplo

curl -X GET "https://envios.arrobamail.com/v3/api/automations" \
  -H "Authorization: Bearer $TOKEN"

Respuesta 200

{
  "flows": [
    {
      "id": 7, "name": "Bienvenida nuevos suscriptores",
      "status": "active", "triggerType": "subscribe",
      "totalEnrolled": 1250, "active": 85,
      "dateCreated": "2025-04-10 08:00:00"
    }
  ],
  "total": 5, "page": 1, "limit": 50
}

GET/automations/:idUsuario

Detalle con nodos, aristas y configuración

Parámetros de ruta

Nombre	Descripción
`id`	ID numérico del flujo de automatización

Ejemplo

curl -X GET "https://envios.arrobamail.com/v3/api/automations/{ID}" \
  -H "Authorization: Bearer $TOKEN"

POST/automationsUsuario

Crear flujo de automatización

Trigger types válidos: subscribe, unsubscribe, open, click, event, anniversary, site_track, tag_added, tag_removed, field_changed. Node types válidos: trigger, action, delay, condition, ab_split, exit.

Request body · application/json

Nombre	Tipo	Req.	Descripción
`name`	`string`	Sí	Nombre del flujo (máx 200 chars)
`triggerType`	`string`	Sí	subscribe \| unsubscribe \| open \| click \| event \| anniversary \| site_track \| tag_added \| tag_removed \| field_changed
`triggerConfig`	`object`	No	Configuración del trigger
`validFrom`	`string`	No	Fecha de inicio de validez
`validTo`	`string`	No	Fecha de fin de validez
`reentry`	`string`	No	never \| always \| after_completion \| cooldown
`nodes`	`array`	No	Array de nodos del flujo
`edges`	`array`	No	Array de aristas entre nodos

Ejemplo

curl -X POST "https://envios.arrobamail.com/v3/api/automations" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "...",
  "triggerType": "...",
  "triggerConfig": {},
  "validFrom": "...",
  "validTo": "...",
  "reentry": "...",
  "nodes": [],
  "edges": []
}'

PATCH/automations/:idUsuario

Actualizar flujo

No se puede cambiar triggerType mientras el flujo está activo.

Parámetros de ruta

Nombre	Descripción
`id`	ID del flujo de automatización

Request body · application/json

Nombre	Tipo	Req.	Descripción
`name`	`string`	No	Nuevo nombre
`nodes`	`array`	No	Array de nodos
`edges`	`array`	No	Array de aristas

Ejemplo

curl -X PATCH "https://envios.arrobamail.com/v3/api/automations/{ID}" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "...",
  "nodes": [],
  "edges": []
}'

Respuesta 200

{ "success": true }

DELETE/automations/:idUsuario

Eliminar flujo (cascade)

Elimina el flujo y todos sus datos relacionados (enrollments, logs, nodos).

Parámetros de ruta

Nombre	Descripción
`id`	ID del flujo de automatización

Ejemplo

curl -X DELETE "https://envios.arrobamail.com/v3/api/automations/{ID}" \
  -H "Authorization: Bearer $TOKEN"

Respuesta 200

{ "success": true }

PUT/automations/:id/activateUsuario

Activar flujo

El flujo debe tener al menos un nodo trigger y un nodo action.

Parámetros de ruta

Nombre	Descripción
`id`	ID del flujo de automatización

Ejemplo

curl -X PUT "https://envios.arrobamail.com/v3/api/automations/{ID}/activate" \
  -H "Authorization: Bearer $TOKEN"

Respuesta 200

{ "success": true }

PUT/automations/:id/pauseUsuario

Pausar flujo activo

Parámetros de ruta

Nombre	Descripción
`id`	ID del flujo de automatización

Ejemplo

curl -X PUT "https://envios.arrobamail.com/v3/api/automations/{ID}/pause" \
  -H "Authorization: Bearer $TOKEN"

Respuesta 200

{ "success": true }

GET/automations/:id/statsUsuario

Estadísticas del flujo

Parámetros de ruta

Nombre	Descripción
`id`	ID del flujo de automatización

Ejemplo

curl -X GET "https://envios.arrobamail.com/v3/api/automations/{ID}/stats" \
  -H "Authorization: Bearer $TOKEN"

Respuesta 200

{
  "totalEnrolled": 1250,
  "active": 85,
  "completed": 1100,
  "exited": 50,
  "errors": 15,
  "nodeStats": {
    "n1": { "entered": 1250, "completed": 1250 },
    "n2": { "entered": 1250, "completed": 1240, "errors": 10 }
  }
}

GET/automations/:id/enrollmentsUsuario

Enrollments del flujo

Parámetros de ruta

Nombre	Descripción
`id`	ID del flujo de automatización

Query params

Nombre	Tipo	Req.	Default	Descripción
`page`	`number`	No	`1`	Página
`limit`	`number`	No	`50`	Items por página
`status`	`string`	No	`-`	active, waiting, completed, exited, error

Ejemplo

curl -X GET "https://envios.arrobamail.com/v3/api/automations/{ID}/enrollments" \
  -H "Authorization: Bearer $TOKEN"

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.

Probar gratis ahora

Automations /automations

Listar flujos de automatización

Detalle con nodos, aristas y configuración

Crear flujo de automatización

Actualizar flujo

Eliminar flujo (cascade)

Activar flujo

Pausar flujo activo

Estadísticas del flujo

Enrollments del flujo

Empezá con arrobaMailen menos de 5 minutos.

Automations `/automations`

Empezá con arrobaMail
en menos de 5 minutos.