Crear una secuencia

Crear una secuencia

POST /api/v1/sequences Crea la secuencia y su versión 1 en borrador, en una sola transacción. Responde 201. La secuencia nace paused, con publishedVersionId: null: todavía no inscribe a nadie. Los ids de lista vienen de GET /api/v1/lists, los de etiqueta de GET /api/v1/tags, ambos en la API de audiencia.

Condición	Respuesta
todo válido	`201`
nombre ausente, `triggerType` desconocido, id mal formado	`400`: `details` nombra el campo
objetivo del disparador de otra organización	`404`: como una lista que no existe
`triggerType: "fixed_date"`	`400`: las series de fecha fija se configuran en la app, no aquí
se alcanzó el límite de secuencias de tu plan	`400` indicando el límite y cuántas tienes ya

El tope de secuencias del plan se aplica aquí exactamente igual que en la app. No es una propiedad de la interfaz: la misma protección rechaza la API. Elimina una secuencia que ya no necesites, o cambia a un plan superior: reintentar no ayudará.

Autorización

Rol en la organización	Este endpoint
`OWNER`	Permitido
`ADMIN`	Permitido
`MEMBER`	Rechazado — `403`

Una clave lleva el rol que su creador tiene en esta organización, nunca un rol en AgentsMail en sí. Consulta Claves de API.

Cuerpo de la solicitud

Campo	Tipo	Obligatorio	Descripción
`name`	string	sí	De 1 a 100 caracteres
`triggerType`	string	sí	`list_joined` o `tag_added`. Existe un tercer valor, `fixed_date`, en la app para las series guiadas por fecha; aquí se rechaza: una serie también necesita su audiencia, su fecha de inicio y la programación de cada paso, y con solo la mitad de eso quedaría una secuencia que nada puede publicar.
`triggerTargetId`	string	sí	El id de la lista para `list_joined`, el id de la etiqueta para `tag_added`

Ejemplo

bash

curl -X POST -H "x-api-key: $AGENTMAIL_API_KEY" -H "content-type: application/json" \
  -d '{"name":"Onboarding","triggerType":"list_joined","triggerTargetId":"'$LIST_ID'"}' \
  "https://www.agentsmail.io/api/v1/sequences"

Respuesta

201 Created: el recurso creado.
401 Unauthorized: clave ausente o no válida, o su propietario dejó la organización.
403 Forbidden: el propietario de la clave es member de la organización, no admin.
429 Too Many Requests: más de 120 solicitudes en un minuto para esta clave.

Campos de la respuesta

Campo	Tipo	Descripción
`success`	boolean	Indica si la operación tuvo éxito
`data.id`	string	Identificador único de la secuencia
`data.name`	string	Su nombre
`data.status`	string	`active` o `paused`
`data.publishedVersionId`	string	null
`data.createdAt`	string	Fecha ISO de creación
`data.updatedAt`	string	Fecha ISO del último cambio

Ejemplo de respuesta

json

{
  "success": true,
  "data": {
    "id": "4d19c0a2",
    "name": "Newsletter",
    "status": "subscribed",
    "publishedVersionId": "c41a7e55",
    "createdAt": "2026-08-23T10:22:05.000Z",
    "updatedAt": "2026-08-23T10:22:05.000Z"
  }
}