Bulk Post
Bulk schedule posts with a CSV file
Bulk schedule posts with CSV (Comma Separated Values) file of posts data.
Content-Type must be multipart/form-data.
We recommend using the direct Post endpoint instead of this bulk method for scheduling posts. The direct endpoint provides a more comprehensive feature set and easier debugging capabilities.
Header Parameters
AuthorizationstringrequiredFormat: Authorization: Bearer API_KEY. See API overview for more
information.
Profile-KeystringProfile Key of a user profile.
Content-TypestringrequiredContent-Type: multipart/form-data
Body Parameters
fileobjectMultipart form-data CSV file of scheduled posts. See below for CSV template.
Request Examples
A multipart form-data containing a CSV file of posts will schedule them for a future date.
The CSV file contains the following fields (template below) and are required:
post: The post text.platforms: Comma separated list of platforms, e.g. "twitter, facebook, instagram".mediaUrls: URL of media, such as an image or video to include in the post.scheduleDate: Datetime to schedule the post in UTC format. For example, use formatYYYY-MM-DDThh:mm:ssZand send as2026-07-08T12:30:00Z. Please see utctime for more examples.
Don't send duplicate posts less than two days apart.
If the scheduleDate of two posts with the exact same text are less than three days apart, the second post will be rejected when the scheduleDate occurs. This is to protect your account at the networks; they can suspend or shadow-ban accounts with frequent duplicate posts.
CSV Template
Download the template and save as a .csv file.
curl \
-H "Authorization: Bearer API_KEY" \
-H 'Content-Type: multipart/form-data' \
-F 'file=@"./ACME CSV Template.csv"' \
-X POST https://api.acme.com/api/post/bulk{
"status": "success",
"posts": [
{
"status": "scheduled",
"scheduleDate": "4/6/21 12:50",
"id": "X3uTExuEJhyM3u8wCRsA",
"post": "A great post"
},
{
"status": "scheduled",
"scheduleDate": "4/6/21 13:00",
"id": "8RGrekuxMnVa7lVnARFm",
"post": "An even better post"
}
]
}