Posts

Create a postCopy Anchor Link

platforms lists 1–20 distinct accounts, each with its own platformSpecificData. Without publishNow or scheduledFor the post is a draft; publishNow: true publishes live. Host media with POST /media and use its publicUrl.

curl https://postgale.com/api/v1/posts \
  -H 'Authorization: Bearer sk_…' \
  -H 'Content-Type: application/json' \
  -H 'x-request-id: menu-2026-11-01' \
  -d @post.json

{
  "content": "New menu is live ☕",
  "scheduledFor": "2026-11-01T15:00:00Z",
  "platforms": [
    {
      "accountId": "acc_instagram",
      "platformSpecificData": {
        "mediaUrl": "https://postgale.com/media/…/menu.jpg",
        "firstComment": "#coffee #brunch"
      }
    },
    {
      "accountId": "acc_facebook_page",
      "platformSpecificData": {
        "mediaUrl": "https://postgale.com/media/…/menu.jpg"
      }
    },
    {
      "accountId": "acc_threads",
      "platformSpecificData": {
        "topicTag": "coffee",
        "replyControl": "everyone"
      }
    }
  ]
}

IdempotencyCopy Anchor Link

Send x-request-id on POST /posts. A retry with the same id returns the original post (200 instead of 201). The same text cannot be posted twice within 24 hours.

LifecycleCopy Anchor Link

• GET /posts lists the 100 most recent posts with their targets (?status=); GET /posts/{id} returns one post with per-target status, platformPostId, URL and error.
• PATCH /posts/{id} with {content} replaces the text of a draft, scheduled, pending_approval or failed post.
• POST /posts/{id}/publish publishes live now (and retries failed targets).
• DELETE /posts/{id} deletes the post from Postgale: scheduled posts are cancelled, published posts stay on the platforms.
• When approval applies, new posts are held as pending_approval until a person approves them in the dashboard (see Approval).

Published postsCopy Anchor Link

platformSpecificData by platformCopy Anchor Link

Only the keys for the account's platform are used. Skipped options are returned as warnings on the target. X (coming soon) options are in the X guide, Telegram's in the Telegram guide, Discord's in the Discord guide, Bluesky's in the Bluesky guide, Mastodon's in the Mastodon guide and TikTok's in full in the TikTok guide.

InstagramCopy Anchor Link

Facebook PagesCopy Anchor Link

ThreadsCopy Anchor Link

TikTokCopy Anchor Link