PUT
/
post
/
bulk
Available on Premium, Business, Enterprise plans.

Bulk schedule posts with CSV (Comma Separated Values) file of posts data. Content-Type must be multipart/form-data.

Header Parameters

Authorization
string
required

Format: Authorization: Bearer API_KEY. See API overview for more information.

Profile-Key
string

Profile Key of a user profile.

Content-Type
string

multipart/form-data

Request Body

file
object

Multipart form-data CSV file of scheduled posts. See below for 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 format “YYYY-MM-DDThh:mm:ssZ” and send as “2023-07-08T12:30:00Z”. Please see https://www.utctime.net/ for examples.

Don’t send duplicate posts less than three 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.

Ayrshare CSV Template