Skip to main content
POST
Tạo bài đăng
Tạo bài đăng ở trạng thái draft. Sau đó, gọi PUT /posts/{post} với status=scheduled để lên lịch hoặc status=publishing để đăng ngay.
Bài đăng Pinterest: POST /posts không nhận meta riêng cho từng nền tảng. Sau khi tạo bài, hãy gọi PUT /posts/{post} và đặt platforms[].meta.board_id cho từng mục Pinterest; nếu không, tác vụ đăng sẽ thất bại với lỗi Pinterest board_id is required.

Yêu cầu

array
bắt buộc
Cần ít nhất một nền tảng. Mỗi mục liên kết bài đăng với một tài khoản mạng xã hội đã kết nối và một content_type.
string
Nội dung bài đăng dùng chung cho mọi nền tảng. API cho phép tối đa 10.000 ký tự (giới hạn riêng của từng nền tảng vẫn được áp dụng; xem GET /content-types để biết chi tiết). Mặc định là chuỗi rỗng.
array
Nội dung đa phương tiện cần đính kèm. Mỗi mục phải có cấu trúc giống kết quả từ POST /posts/{post}/media: id, path, url, type, mime_type, original_filename. Thông thường, bạn nên dùng endpoint tải tệp lên hoặc đính kèm từ URL.
string
Thời điểm ISO 8601 trong tương lai (ví dụ 2026-05-10T15:30:00Z). Giá trị được lưu vào bản nháp, nên yêu cầu PUT với status=scheduled sau đó không cần gửi lại. Mặc định là 09:00 UTC trong ngày hiện tại.
array
UUID của các nhãn cần gắn. Nhãn phải thuộc cùng không gian làm việc với khóa API. key.

Phản hồi

Trả về 201 cùng bài đăng vừa tạo. Cấu trúc phản hồi giống GET /posts/{post}; xem endpoint đó để biết đầy đủ các trường.