Liên hệ (contacts) — Tạo
Tạo mới một liên hệ qua POST.
Endpoint POST /v1/contacts tạo mới một liên hệ.
Endpoint
| Method | Endpoint | Mô tả |
|---|---|---|
POST | /v1/contacts | Tạo mới liên hệ |
Tham số thân yêu cầu (Body Parameters)
| Tham số | Kiểu | Bắt buộc | Mô tả |
|---|---|---|---|
first_name | string | Có | Tên |
last_name | string | Không | Họ |
email | string | Không | Email (dùng chống trùng) |
phone | string | Không | Số điện thoại |
company_id | string | Không | ID công ty |
lifecycle_stage | string | Không | Giai đoạn vòng đời |
Kiểm thử tại chỗ
POST
https://crm-gateways.hitechcloud.vn/v1/contactsKiể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/contacts" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"first_name": "Nguyen",
"last_name": "Van A",
"email": "vana@example.com",
"phone": "0901234567",
"company_id": "co_4b7e2f10",
"lifecycle_stage": "lead"
}'Phản hồi (201 Created)
{
"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 POST /v1/contacts tạo mới một liên hệ.
Endpoint
| Method | Endpoint | Mô tả |
|---|---|---|
POST | /v1/contacts | Tạo mới liên hệ |
Tham số thân yêu cầu (Body Parameters)
| Tham số | Kiểu | Bắt buộc | Mô tả |
|---|---|---|---|
first_name | string | Có | Tên |
last_name | string | Không | Họ |
email | string | Không | Email (dùng chống trùng) |
phone | string | Không | Số điện thoại |
company_id | string | Không | ID công ty |
lifecycle_stage | string | Không | Giai đoạn vòng đời |
Kiểm thử tại chỗ
POST
https://crm-gateways.hitechcloud.vn/v1/contactsKiể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/contacts" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"first_name": "Nguyen",
"last_name": "Van A",
"email": "vana@example.com",
"phone": "0901234567",
"company_id": "co_4b7e2f10",
"lifecycle_stage": "lead"
}'Phản hồi (201 Created)
{
"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"
}
}