arrobaMail
Probar gratis
Módulo 0513 endpoints

Segmentations /segmentations

Disponible en versión legacy y V2 (grupos de condiciones).

Endpoints

13 en total
GET/segmentations/conditionsUsuario

Condiciones y operadores disponibles

Incluye siempre los campos personalizados del usuario bajo Datos del Suscriptor; con listIds filtra esos campos a las listas indicadas.

Query params

NombreTipoReq.DefaultDescripción
langstringNoesIdioma: "es" o "en"
listIdsstringNo-IDs de listas separados por coma para limitar los custom fields; también acepta all

Ejemplo

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

Listar segmentaciones legacy

Ejemplo

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

Detalle de segmentación legacy

Parámetros de ruta

NombreDescripción
idID numérico de la segmentación (legacy)

Ejemplo

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

Listar segmentaciones V2

Query params

NombreTipoReq.DefaultDescripción
typestringNo-Filtro por tipo
isActivebooleanNo-Filtrar por estado activo

Ejemplo

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

Detalle de segmentación V2 con grupos y condiciones

Parámetros de ruta

NombreDescripción
idID numérico de la segmentación V2

Ejemplo

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

Crear segmentación V2

Nombre requerido (máx 200 chars). Condiciones deben ser válidas.

Request body · application/json

NombreTipoReq.Descripción
namestringSíNombre de la segmentación (máx 200 chars)
groupsarraySíArray de grupos de condiciones
listIdsarrayNoIDs de listas asociadas
isActivebooleanNoDefault: true

Ejemplo

curl -X POST "https://envios.arrobamail.com/v3/api/segmentations/v2" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "...",
  "groups": [],
  "listIds": [],
  "isActive": true
}'
PUT/segmentations/v2/:idUsuario

Actualizar segmentación V2

Parámetros de ruta

NombreDescripción
idID de la segmentación V2

Request body · application/json

NombreTipoReq.Descripción
namestringNoNombre
groupsarrayNoGrupos de condiciones
isActivebooleanNoEstado activo

Ejemplo

curl -X PUT "https://envios.arrobamail.com/v3/api/segmentations/v2/{ID}" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "...",
  "groups": [],
  "isActive": true
}'

Respuesta 200

{ "success": true }
DELETE/segmentations/v2/:idUsuario

Eliminar segmentación V2

Parámetros de ruta

NombreDescripción
idID de la segmentación V2

Ejemplo

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

Respuesta 200

{ "success": true }
POST/segmentations/v2/:id/duplicateUsuario

Duplicar segmentación V2

Parámetros de ruta

NombreDescripción
idID de la segmentación V2 a duplicar

Ejemplo

curl -X POST "https://envios.arrobamail.com/v3/api/segmentations/v2/{ID}/duplicate" \
  -H "Authorization: Bearer $TOKEN"
POST/segmentations/v2/:id/countUsuario

Contar suscriptores que coinciden con la segmentación

Parámetros de ruta

NombreDescripción
idID de la segmentación V2

Ejemplo

curl -X POST "https://envios.arrobamail.com/v3/api/segmentations/v2/{ID}/count" \
  -H "Authorization: Bearer $TOKEN"

Respuesta 200

{ "count": 1240 }
POST/segmentations/v2/:id/previewUsuario

Preview de suscriptores que coinciden

Parámetros de ruta

NombreDescripción
idID de la segmentación V2

Ejemplo

curl -X POST "https://envios.arrobamail.com/v3/api/segmentations/v2/{ID}/preview" \
  -H "Authorization: Bearer $TOKEN"
POST/segmentations/migrate/:idUsuario

Migrar segmentación legacy a V2

Parámetros de ruta

NombreDescripción
idID de la segmentación legacy a migrar

Ejemplo

curl -X POST "https://envios.arrobamail.com/v3/api/segmentations/migrate/{ID}" \
  -H "Authorization: Bearer $TOKEN"
POST/segmentations/migrate-allUsuario

Migrar todas las segmentaciones legacy a V2

Ejemplo

curl -X POST "https://envios.arrobamail.com/v3/api/segmentations/migrate-all" \
  -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
WhatsAppTe responde el equipo