Skip to main content
The create-post request contains one publishing entry for every connected social account. A single request can create posts for multiple destinations.

​
Destinations

Call GET /public/v1/integrations first and use the returned id as posts[].integration.id. Do not use the provider name or profile URL as an identifier.

​
Publishing modes

The type field controls how PostlyBee handles the request: Set autoSchedule to true to select the next available time from each account’s posting schedule. When auto-scheduling, date is not required. Optional autoScheduleOptions can constrain the search window.

​
Threads

Each item in posts[].value represents one content segment. For thread-based platforms such as X, Threads, and Bluesky, multiple items form a thread. On platforms without native threads, provider behavior may differ.

​
Media

Upload media before creating the post. Use the returned id and path in the content segment:
The destination platform ultimately determines supported formats, file sizes, aspect ratios, and attachment counts.

​
Provider settings

posts[].settings contains destination-specific options. PostlyBee automatically adds the provider discriminator after resolving the connected account. Only include settings supported by that provider.
Repeat and recycle modes are mutually exclusive. A request enabling both is rejected with 400 Bad Request.

​
Repeating and recycling

Use repeat to create a fixed number of future copies. Use recycle to republish on an interval until an optional maximum cycle count is reached. Intervals support DAY, WEEK, and MONTH.
Last modified on August 26, 2026