Efficiently schedule up to 500 posts across multiple accounts and networks in a single API request. Bulk scheduling in Publer streamlines content planning and helps you stay organized at scale.
Bulk scheduling lets you prepare, customize, and schedule a large number of posts at once—supporting both text and media content for all supported networks. Each post in the bulk payload can have unique content, network targeting, and scheduling options.
Create and schedule up to 500 posts in a single API call.
Combine multiple social accounts and networks per post.
Supports text, images, videos, and more.
Choose between Schedule, Auto Schedule, or Recycle modes.
Individually customize each post (content, media, timing, etc.).
Posts without a scheduled_at field use the account’s posting schedule.
Send a POST request to the scheduling endpoint with your bulk payload:
POST /api/v1/posts/scheduleAuthorization
Yes
Bearer-API YOUR_API_KEY
Publer-Workspace-Id
Yes
Workspace ID for scheduling posts
Content-Type
Yes
application/json
Accept
No
application/json (default)
Example Payload:
{
"bulk": {
"state": "scheduled",
"posts": [
{
"networks": {
"facebook": {
"type": "status",
"text": "Bulk Scheduling"
},
"mastodon": {
"type": "status",
"text": "Bulk Scheduling"
}
},
"accounts": [
{
"id": "63c675b54e299e9cf2b667ea"
},
{
"id": "650170394e299e33b427c2ff",
"scheduled_at": "2025-08-17T16:19+02:00"
}
]
},
{
"accounts": [
{
"id": "63c675b54e299e9cf2b667ea"
},
{
"id": "650170394e299e33b427c2ff",
"scheduled_at": "2025-07-17T17:19+02:00"
}
],
"networks": {
"facebook": {
"type": "status",
"text": "Second Post"
},
"mastodon": {
"type": "status",
"text": "Second Post"
}
}
},
{
"accounts": [
{
"id": "63c675b54e299e9cf2b667ea"
},
{
"id": "650170394e299e33b427c2ff",
"scheduled_at": "2025-06-17T18:19+02:00"
}
],
"networks": {
"facebook": {
"type": "status",
"text": "Third post"
},
"mastodon": {
"type": "status",
"text": "Third post"
}
}
}
]
}
}bulk.state
string
Scheduling mode: "scheduled" (manual schedule), "auto", or "recycle"
bulk.posts
array
Array of up to 500 post objects
posts[].networks
object
Networks and their post data (e.g., Facebook, Mastodon, etc.)
posts[].networks.{network}
object
Post content for each targeted network
posts[].accounts
array
Array of account objects that will receive this post
accounts[].id
string
Target social account ID
accounts[].scheduled_at
string
ISO 8601 time for scheduled post (omit for auto or recycle based on posting schedule)
...
...
All other post options (media, watermarks, signature, location, etc.) supported per post type
Schedule:
Add scheduled_at to specify exact publish time per account/post.
Auto Schedule:
Omit scheduled_at and set bulk.state to "auto" to use the account's posting schedule.
Recycle:
Set bulk.state to "recycle" to enable cyclical republishing based on the account's recycle settings.
Recurring posts are not supported in bulk scheduling.
Prepare Your Bulk Payload: List each post with its content, targeted networks, and accounts.
Customize Each Post: Add media, captions, hashtags, locations, watermarks, and more individually per post.
Choose Scheduling Mode:
Use scheduled_at for manual scheduling or let Publer auto-schedule based on your rules.
Submit:
Send your payload to /posts/schedule and monitor job status for completion.
Use bulk scheduling for campaigns, product launches, or large-scale social content plans.
Individually tailor each post for its platform and audience.
Use the scheduling modes for flexibility—manual times for some posts, auto-schedule for others.