Bulk Post

Bulk schedule posts with a CSV file

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

Body Parameters

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