Liên hệ (contacts) — Cập nhật
Cập nhật một phần thông tin liên hệ qua PATCH.
Endpoint PATCH /v1/contacts/{id} cập nhật một phần thông tin liên hệ. Chỉ gửi những trường cần đổi.
Endpoint
| Method | Endpoint | Mô tả |
|---|---|---|
PATCH | /v1/contacts/{id} | Cập nhật liên hệ |
Tham số đường dẫn & thân yêu cầu
| Tham số | Vị trí | Bắt buộc | Mô tả |
|---|---|---|---|
id | path | Có | Định danh liên hệ |
| Tham số | Kiểu | Bắt buộc | Mô tả |
|---|---|---|---|
lifecycle_stage | string | Không | Giai đoạn vòng đời |
tags | string | Không | Trường cần cập nhật |
Kiểm thử tại chỗ
PATCH
https://crm-gateways.hitechcloud.vn/v1/contacts/{id}Kiể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.
Tham số đường dẫn
Body
cURL cập nhật
curl -X PATCH "https://crm-gateways.hitechcloud.vn/v1/contacts/con_8f2a1c9d" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"lifecycle_stage": "customer",
"tags": [
"vip"
]
}'Phản hồi (200 OK)
{
"status": "success",
"data": {
"id": "con_8f2a1c9d",
"first_name": "Nguyen",
"last_name": "Van A",
"email": "vana@example.com",
"phone": "0901234567",
"company_id": "co_4b7e2f10",
"lifecycle_stage": "customer",
"lead_source": "website",
"tags": [
"vip"
],
"owner_id": "usr_12",
"created_at": "2026-09-01T08:00:00+07:00",
"updated_at": "2026-10-31T09:40:00+07:00"
}
}Endpoint PATCH /v1/contacts/{id} cập nhật một phần thông tin liên hệ. Chỉ gửi những trường cần đổi.
Endpoint
| Method | Endpoint | Mô tả |
|---|---|---|
PATCH | /v1/contacts/{id} | Cập nhật liên hệ |
Tham số đường dẫn & thân yêu cầu
| Tham số | Vị trí | Bắt buộc | Mô tả |
|---|---|---|---|
id | path | Có | Định danh liên hệ |
| Tham số | Kiểu | Bắt buộc | Mô tả |
|---|---|---|---|
lifecycle_stage | string | Không | Giai đoạn vòng đời |
tags | string | Không | Trường cần cập nhật |
Kiểm thử tại chỗ
PATCH
https://crm-gateways.hitechcloud.vn/v1/contacts/{id}Kiể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.
Tham số đường dẫn
Body
cURL cập nhật
curl -X PATCH "https://crm-gateways.hitechcloud.vn/v1/contacts/con_8f2a1c9d" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"lifecycle_stage": "customer",
"tags": [
"vip"
]
}'Phản hồi (200 OK)
{
"status": "success",
"data": {
"id": "con_8f2a1c9d",
"first_name": "Nguyen",
"last_name": "Van A",
"email": "vana@example.com",
"phone": "0901234567",
"company_id": "co_4b7e2f10",
"lifecycle_stage": "customer",
"lead_source": "website",
"tags": [
"vip"
],
"owner_id": "usr_12",
"created_at": "2026-09-01T08:00:00+07:00",
"updated_at": "2026-10-31T09:40:00+07:00"
}
}