Bỏ qua tới phần tài liệu
API

Tạo nhóm đối tượng

Tạo một nhóm đối tượng mới, rỗng và trả về nó kèm id. `name` được cắt khoảng trắng hai đầu và sau đó phải dài từ 1 đến 120 ký tự. `description` là văn bản tự do, không bắt buộc, dành cho người đọc danh sách sau này. Tên không được kiểm tra trùng lặp, vì nhóm đối tượng được xác định bằng id.

POSTapi.openemail.uk/audiences

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

Tạo một nhóm đối tượng mới, rỗng và trả về nó kèm id. name được cắt khoảng trắng hai đầu và sau đó phải dài từ 1 đến 120 ký tự. description là văn bản tự do, không bắt buộc, dành cho người đọc danh sách sau này. Tên không được kiểm tra trùng lặp, vì nhóm đối tượng được xác định bằng id.

Ví dụ

Cần audiences:write.

curl
curl -X POST "$OE/audiences" -H "$AUTH" -H 'content-type: application/json' -d '{  "name": "Product updates",  "description": "Customers who asked to hear about releases"}'
Phản hồi
{  "object": "audience",  "id": "aud_4c1b8e2a7d9f05c36b4e8a71",  "name": "Product updates",  "description": "Customers who asked to hear about releases",  "builtin": null,  "contactCount": 0,  "createdAt": "2026-09-18T09:10:00.000Z",  "updatedAt": "2026-09-18T09:10:00.000Z"}

builtin không bao giờ được chấp nhận từ phần thân yêu cầu. Mỗi không gian làm việc có đúng một hàng mang trường này và hàng đó do máy chủ quản lý.

Một không gian làm việc chứa tối đa 100 nhóm đối tượng. Nhóm tiếp theo sẽ bị từ chối với 422 audience_limit_reached trên name.

Thêm liên hệ vào nhóm bằng route thêm, mỗi lần một liên hệ, và các liên hệ phải có sẵn trong sổ địa chỉ.