Tạo liên hệ
Lưu một địa chỉ vào sổ địa chỉ của không gian làm việc. Địa chỉ chính là định danh, nên không có id để chọn và phản hồi cũng không có id. Địa chỉ được cắt khoảng trắng và chuyển thành chữ thường trước khi lưu, và liên hệ được lưu với `source` là `manual`. Liên hệ mới được thêm vào nhóm đối tượng mặc định có sẵn ngay khi được ghi, cùng với mọi nhóm được nêu trong `audienceIds`.
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 /contacts
Lưu một địa chỉ vào sổ địa chỉ của không gian làm việc. Địa chỉ chính là định danh, nên không có id để chọn và phản hồi cũng không có id. Địa chỉ được cắt khoảng trắng và chuyển thành chữ thường trước khi lưu, và liên hệ được lưu với source là manual. Liên hệ mới được thêm vào nhóm đối tượng mặc định có sẵn ngay khi được ghi, cùng với mọi nhóm được nêu trong audienceIds.
Ví dụ
Cần contacts:write. Gửi kèm audienceIds còn cần thêm audiences:write.
curl -X POST "$OE/contacts" -H "$AUTH" -H 'content-type: application/json' -d '{ "email": "[email protected]", "name": "Grace Hopper", "notes": "Met at the compiler workshop"}'{ "object": "contact", "email": "[email protected]", "name": "Grace Hopper", "source": "manual", "notes": "Met at the compiler workshop", "lastSeenAt": null, "createdAt": "2026-09-18T09:00:00.000Z", "updatedAt": "2026-09-18T09:00:00.000Z", "audiences": [ { "id": "aud_9f2c4b7e1a0d63d84c5f2e7b", "name": "All contacts", "builtin": "default" } ]}Một địa chỉ đã có trong sổ địa chỉ trả về 409 contact_exists thay vì được hợp nhất, nên một lần thử lại không thể âm thầm ghi đè tên mà ai đó đã sửa trong ứng dụng. Thay vào đó, hãy đọc hàng đó và PATCH nó.
lastSeenAt giữ giá trị null cho đến khi có thư được gửi tới địa chỉ đó từ trình soạn thư của ứng dụng. source và lastSeenAt do máy chủ quản lý và không được chấp nhận trong phần thân yêu cầu.
Một id nhóm đối tượng trong audienceIds không tồn tại trong không gian làm việc này sẽ trả về 404 và không có gì được ghi.