API

Cập nhật liên hệ

Cập nhật một phần, không bao giờ là upsert. Trường bạn bỏ qua giữ nguyên giá trị đã lưu, còn `null` tường minh sẽ xóa giá trị đó, nên `{"notes": null}` làm trống ghi chú trong khi `{}` không thay đổi gì. Một địa chỉ không có trong sổ địa chỉ trả về `404`.

PATCHapi.openemail.uk/contacts/{email}

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.

PATCH /contacts/{email}

Cập nhật một phần, không bao giờ là upsert. Trường bạn bỏ qua giữ nguyên giá trị đã lưu, còn null tường minh sẽ xóa giá trị đó, nên {"notes": null} làm trống ghi chú trong khi {} không thay đổi gì. Một địa chỉ không có trong sổ địa chỉ trả về 404.

Ví dụ

Cần contacts:write. Hãy mã hóa URL ký tự @.

curl

curl -X PATCH "$OE/contacts/grace%40example.com" -H "$AUTH" -H 'content-type: application/json' -d '{  "name": "Grace Hopper",  "notes": null}'

Phản hồi

{  "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:04:00.000Z",  "audiences": [    { "id": "aud_9f2c4b7e1a0d63d84c5f2e7b", "name": "All contacts", "builtin": "default" }  ]}

Không thể thay đổi địa chỉ tại đây. Địa chỉ là định danh, là phân đoạn đường dẫn và là khóa duy nhất của sổ địa chỉ, nên chuyển một liên hệ sang địa chỉ mới nghĩa là xóa rồi tạo lại.

Một liên hệ được ghi lại tự động vẫn là auto sau khi bạn đặt tên cho nó. Đặt tên không mang cùng ý nghĩa với việc có người đã lưu nó.

Tư cách thành viên nhóm đối tượng không bị ảnh hưởng. Hãy dùng các route nhóm đối tượng cho việc đó.