Phân khúc (segments) — Tạo

Tạo mới một phân khúc qua POST.

Xem Markdown

Endpoint POST /v1/segments tạo mới một phân khúc.

Endpoint

MethodEndpointMô tả
POST/v1/segmentsTạo mới phân khúc

Tham số thân yêu cầu (Body Parameters)

Tham sốKiểuBắt buộcMô tả
namestringCóTên phân khúc
filterobjectCóĐiều kiện lọc động

Kiểm thử tại chỗ

POSThttps://crm-gateways.hitechcloud.vn/v1/segments

Gửi thử sẽ ghi dữ liệu thật trên môi trường được chọn. Nên thử trên Sandbox trước. Token không được lưu lại.

Body
cURL tạo mới
curl -X POST "https://crm-gateways.hitechcloud.vn/v1/segments" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Khach VIP HCM",
    "filter": {
      "tags": [
        "vip"
      ],
      "lifecycle_stage": "customer"
    }
  }'
Phản hồi (201 Created)
{
  "status": "success",
  "data": {
    "id": "seg_vip_hcm",
    "name": "Khach VIP HCM",
    "filter": {
      "tags": [
        "vip"
      ],
      "lifecycle_stage": "customer"
    },
    "contact_count": 42,
    "created_at": "2026-10-01T08:00:00+07:00"
  }
}