Liên hệ (contacts) — Cập nhật

Cập nhật một phần thông tin liên hệ qua PATCH.

Xem Markdown

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

MethodEndpointMô 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ộcMô tả
idpathCóĐịnh danh liên hệ
Tham sốKiểuBắt buộcMô tả
lifecycle_stagestringKhôngGiai đoạn vòng đời
tagsstringKhôngTrường cần cập nhật

Kiểm thử tại chỗ

PATCHhttps://crm-gateways.hitechcloud.vn/v1/contacts/{id}

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"
  }
}