Inscribir todos los contactos activos de una lista (idempotente)
POST
/v1/bulk/sequences/{id}/enroll
const url = 'https://api.mailerdash.com/v1/bulk/sequences/example/enroll';const options = { method: 'POST', headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'}, body: '{"list_id":"example"}'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request POST \ --url https://api.mailerdash.com/v1/bulk/sequences/example/enroll \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "list_id": "example" }'Suscribe a la secuencia cada contacto con status=active de la lista indicada. Es idempotente (contactos ya suscritos en active/paused no se duplican) y salta contactos suprimidos (cuenta o plataforma). Corre síncrono, acotado por un tope interno de contactos por corrida; si la lista lo excede, la respuesta trae truncated: true.
Authorizations
Sección titulada «Authorizations »Parameters
Sección titulada « Parameters »Path Parameters
Sección titulada «Path Parameters » id
required
string
Request Body required
Sección titulada «Request Body required » Media type application/json
object
list_id
required
string
Example generated
{ "list_id": "example"}Responses
Sección titulada « Responses »Resultado de la inscripción masiva
Media type application/json
object
enrolled
Nuevas suscripciones creadas
integer
already_in
Ya suscritos (active/paused), sin cambios
integer
skipped_terminal
Suscripción previa en estado terminal, no reinscritos
integer
suppressed
Saltados por supresión (cuenta o plataforma)
integer
total
Total de contactos activos en la lista
integer
truncated
True si la lista excede el tope por corrida
boolean
Example generated
{ "enrolled": 1, "already_in": 1, "skipped_terminal": 1, "suppressed": 1, "total": 1, "truncated": true}Validacion (falta list_id, secuencia inactiva o sin steps)
Secuencia o lista no encontrada