Posts

Create a post (immediate, scheduled, or draft)

Changed on

A draft (saveAsDraft: true) needs only posts.draft. A post with a future scheduledAt also needs posts.schedule, and a post that publishes now also needs posts.publish; without it the call answers 403 permission_denied. Requires the posts.draft permission.

post/social-posts

Request

  • Base URL: https://post.adaptlypost.com/post/api/v1
  • URL: https://post.adaptlypost.com/post/api/v1/social-posts
  • Auth: HTTP bearer

Headers

X-Workspace-Idstring

The workspace to act in, for OAuth sign-ins that reach several workspaces. Take the id from GET /workspaces. Without it the call lands in the default workspace. A workspace the caller cannot reach answers 403 with code: workspace_access_denied. An API key belongs to one workspace: send its own id or leave the header out

Request body

OR

Example request

{
  "timezone": "UTC",
  "facebookConfigs": [
    {
      "textFormatPresetId": "106018623298955"
    }
  ],
  "googleBusinessConfigs": [
    {
      "eventStart": "2026-10-01T18:00",
      "eventEnd": "2026-10-01T21:00"
    }
  ]
}

Response

Post created

postIdstring
queuedPlatformsPlatformType[]
isScheduledboolean
scheduledAtstring date-time
recurringPostIdstring

Set when the request carried recurrence

Changes

  • 8390a5fa9a0dRevision changes
    • info

      added the new optional request property //

    • info

      added the new optional request property //