POpost-bridge
Posts

Create Post

Changed on

Creates a post for the given social accounts. Note: links are automatically stripped from the caption before publishing to X/Twitter, because X charges far more for posts that contain a link. This covers full URLs (http://, https://, www.) and bare domains like foo.com or foo.io/path. All other platforms keep their links. To share a link on X, post it in a reply or in the account bio.

post/v1/posts

Request

  • Base URL
    https://api.post-bridge.com (the document declares no server; this is the origin it was published from)
  • Auth
    HTTP bearer

Request body

captionstring required

Caption text for the post. Required unless is_draft is true, so a draft can be saved before the caption is written.

scheduled_atstring date-time nullable

Scheduled date and time for the post. Setting to null or undefined will post instantly.

mediastring[] nullable

Array of media IDs associated with the post. Some platforms require media to publish (youtube, tiktok, instagram, pinterest) — see the create-post endpoint description for the per-platform media requirements and accepted types.

media_urlsstring[] nullable

Array of publicly accesible media URLs associated with the post, will be ignored if media is provided

social_accountsnumber[] required

Array of social account IDs for posting

is_draftboolean nullable

If true will create the post but not process it until it is updated with a scheduled date or processed instantly

processing_enabledboolean nullable

If true will process video files to ensure they post, If false we will skip all video processing

use_queueobject nullable

Automatically schedule the post to the next available queue slot. Cannot be used together with scheduled_at. Pass true to use your saved timezone, or { timezone: "America/New_York" } to override.

Example request

{
  "scheduled_at": "2023-12-31T23:59:59Z",
  "platform_configurations": {
    "instagram": {
      "placement": "story",
      "is_ai_generated": true,
      "audio_id": "587784541076604",
      "user_tags": [
        "partner_account",
        "brand"
      ],
      "collaborators": [
        "partner_account"
      ]
    },
    "twitter": {
      "thread": [
        "Tweet 2 of 3",
        {
          "text": "Tweet 3 of 3",
          "media": [
            "<media id>"
          ]
        }
      ]
    },
    "youtube": {
      "tags": [
        "cooking",
        "easy recipes"
      ],
      "publish_at": "2026-11-01T15:00:00Z"
    },
    "facebook": {
      "placement": "story"
    },
    "threads": {
      "thread": [
        "Post 2 of 3",
        {
          "text": "Post 3 of 3",
          "media": [
            "<media id>"
          ]
        }
      ],
      "quote_post_id": "18150206014560966",
      "reply_to_id": "18150206014560966"
    }
  }
}

Response

Post created successfully.

idstring required

Unique identifier of the post

captionstring required

Caption text for the post

status'posted' | 'scheduled' | 'processing' | 'failed' required

Current status of the post: scheduled, processing, or posted

scheduled_atobject nullable required

Scheduled date and time for the post

platform_configurationsobject nullable required

Platform-specific configurations for the post

social_accountsnumber[] required

Array of social account IDs associated with the post

account_configurationsobject nullable required

Account-specific configurations for the post

mediaobject nullable required

Array of media URLs associated with the post

created_atstring required

Timestamp when the post was created

updated_atstring required

Timestamp when the post was last updated

is_draftboolean required

If true the post will not be processed until updated

warningsstring[]

Warnings about draft behavior — e.g. platforms that will publish immediately when the draft is sent

dashboard_urlstring required

Link to this post in the Post Bridge dashboard (view, edit, or see per-platform results). Give it to the user when they ask where the post is.

Changes

  • e9e4a668d1e0Revision changes
    • info

      added the new optional request property //////////

  • 9c14421fa1aaRevision changes
    • info

      added the new optional request property //////////

    • info

      added the new optional request property //////////