Phân khúc (segments) — Tạo
Tạo mới một phân khúc qua POST.
Endpoint POST /v1/segments tạo mới một phân khúc.
Endpoint
| Method | Endpoint | Mô tả |
|---|---|---|
POST | /v1/segments | Tạo mới phân khúc |
Tham số thân yêu cầu (Body Parameters)
| Tham số | Kiểu | Bắt buộc | Mô tả |
|---|---|---|---|
name | string | Có | Tên phân khúc |
filter | object | Có | Điều kiện lọc động |
Kiểm thử tại chỗ
POST
https://crm-gateways.hitechcloud.vn/v1/segmentsKiểm thử tại chỗ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"
}
}Endpoint POST /v1/segments tạo mới một phân khúc.
Endpoint
| Method | Endpoint | Mô tả |
|---|---|---|
POST | /v1/segments | Tạo mới phân khúc |
Tham số thân yêu cầu (Body Parameters)
| Tham số | Kiểu | Bắt buộc | Mô tả |
|---|---|---|---|
name | string | Có | Tên phân khúc |
filter | object | Có | Điều kiện lọc động |
Kiểm thử tại chỗ
POST
https://crm-gateways.hitechcloud.vn/v1/segmentsKiểm thử tại chỗ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"
}
}