Saltearse al contenido
Novity API

Segmentos

Los segmentos agrupan clientes según reglas definidas en el dashboard (por ejemplo: “clientes VIP”, “sin compras en 30 días”).

Requieren el scope segments:read (o una key sin scopes).

Listar segmentos

GET /api/v1/segments

Ejemplo

Ventana de terminal
curl https://api.novity.com.ar/api/v1/segments \
  -H "Authorization: Bearer nv_tu_api_key"

Respuesta

[
  {
    "id": "seg_abc123",
    "name": "Clientes VIP",
    "description": "Más de 10 compras",
    "priority": 1,
    "isActive": true,
    "createdAt": "2026-01-15T12:00:00.000Z"
  }
]

Consultar un segmento

GET /api/v1/segments/:segmentId

Ejemplo

Ventana de terminal
curl https://api.novity.com.ar/api/v1/segments/seg_abc123 \
  -H "Authorization: Bearer nv_tu_api_key"

Devuelve 404 Segmento no encontrado si el segmento no existe o pertenece a otra organización.