Chuyển đến nội dung chính
Requires an editor key. Tools: create_post, get_post_status, get_post, cancel_post (HTTP: POST /posts, GET /posts/:id/status, GET /posts/:id, DELETE /posts/:id).

Steps

  1. list_channels (or list_groups). Use the id values as channel_ids. Only active channels accept posts.
  2. Build a unique id_thirdparty for this intended post, for example campaign-2026-12-01-launch. It must not start with retry:.
  3. create_post with channel_ids, content, id_thirdparty, optional media, scheduled_at.
  4. Read data.duplicate: false means created, true means this id_thirdparty already existed (nothing new was created).
  5. Track with get_post_status every 20 seconds, at most 15 minutes, until no target is pending or publishing.

Rules

Target statuses

pending, publishing, published, failed, unverified, cancelled.

Cancel

cancel_post with the post id. Only pending targets change to cancelled. Targets already published, failed or unverified are untouched. A publishing target is flagged and may still finish.

Confirm before

  • Publishing to many channels at once.
  • Scheduling more than a handful of posts in one run.
  • Any post a human did not approve.
Field details and every error code: API reference.