Thêm liên hệ vào nhóm đối tượng
Nhận một địa chỉ đã có trong sổ địa chỉ của không gian làm việc và trả về tư cách thành viên, kèm liên hệ mà nó trỏ tới. Mỗi cặp nhóm đối tượng và liên hệ chỉ có một tư cách thành viên, nên việc thêm một người đã có trong nhóm đối tượng sẽ trả về `200` với `addedAt` ban đầu thay vì thêm bản thứ hai hoặc báo lỗi. Nhờ vậy lệnh gọi này có thể thử lại an toàn.
Chạy lệnh gọi thật với không gian làm việc của bạn, bằng khóa của chính bạn.
POST /audiences/{id}/contacts
Nhận một địa chỉ đã có trong sổ địa chỉ của không gian làm việc và trả về tư cách thành viên, kèm liên hệ mà nó trỏ tới. Mỗi cặp nhóm đối tượng và liên hệ chỉ có một tư cách thành viên, nên việc thêm một người đã có trong nhóm đối tượng sẽ trả về 200 với addedAt ban đầu thay vì thêm bản thứ hai hoặc báo lỗi. Nhờ vậy lệnh gọi này có thể thử lại an toàn.
Ví dụ
Cần audiences:write.
curl -X POST "$OE/audiences/aud_4c1b8e2a7d9f05c36b4e8a71/contacts" -H "$AUTH" -H 'content-type: application/json' -d '{ "email": "[email protected]"}'{ "object": "audience_member", "audienceId": "aud_4c1b8e2a7d9f05c36b4e8a71", "addedAt": "2026-09-18T09:30:00.000Z", "contact": { "object": "contact", "email": "[email protected]", "name": "Grace Hopper", "source": "manual", "notes": null, "lastSeenAt": null, "createdAt": "2026-09-18T09:00:00.000Z", "updatedAt": "2026-09-18T09:00:00.000Z" }}Một địa chỉ chưa phải là liên hệ sẽ bị từ chối với 422 contact_not_found thay vì được tạo ngay tại chỗ. Hãy lưu nó bằng POST /contacts trước.
audiences:write là phạm vi duy nhất được kiểm tra. Đưa một liên hệ vào danh sách không phải là thao tác ghi lên liên hệ đó.
Mỗi lệnh gọi cho một liên hệ. Phiên bản này không có thao tác thêm hàng loạt, và việc xóa liên hệ sau này sẽ xóa luôn tư cách thành viên này.