CSV format reference for bulk import

This is the authoritative reference for the CSV format used by PostFast's bulk import. For the end-to-end workflow, start there.

File limits

• .csv format
• Max 10 MB per file
• Max 200 rows per file (excluding the header row)
• The first row must be the column headers

The fastest way to get started is to download the CSV template from inside the Bulk Imports dialog. It already contains every supported header.

Required columns

Every row must have these three.

Column	Value	Example
scheduled_at	ISO-8601 datetime with a timezone offset	2026-05-01T10:00:00Z
account_id	UUID of a connected social account	Copy from the Connected account IDs accordion in the upload dialog
content	Post text content	"Example post"

Optional columns

Column	Value
media_urls	Comma-separated list of media URLs. Wrap the cell in double quotes if you include more than one URL so the CSV parser treats it as a single field.
first_comment	First comment to publish on the post after it goes live.

Platform-specific columns

Only fill these in for rows that target the matching platform. Leave them blank on every other row.

Column	Platform	Values
fb_content_type	Facebook	POST, REEL, or STORY
ig_publish_type	Instagram	POST, REEL, or STORY
yt_is_short	YouTube	true or false
pinterest_board_id	Pinterest	Board UUID: copy from the Pinterest board IDs accordion in the upload dialog

Other connected platforms (X, LinkedIn, Threads, Bluesky, TikTok) use the base columns only. No extra platform column is required.

Date format

scheduled_at must be a valid ISO-8601 datetime that includes a timezone offset. The safest form is UTC with a Z suffix:

2026-05-01T10:00:00Z

Rows whose scheduled_at is in the past will fail validation.

Example

scheduled_at,account_id,content,media_urls,first_comment,fb_content_type,ig_publish_type,yt_is_short,pinterest_board_id
2026-05-01T10:00:00Z,<FB_ACCOUNT_ID>,"Example Facebook post",https://example.com/image.jpg,,POST,,,
2026-05-01T12:00:00Z,<IG_ACCOUNT_ID>,"Instagram reel caption",https://example.com/video.mp4,,,REEL,,
2026-05-01T14:00:00Z,<YT_ACCOUNT_ID>,"YouTube Shorts video",https://example.com/video.mp4,,,,true,
2026-05-01T16:00:00Z,<PINTEREST_ACCOUNT_ID>,"Pinterest pin description",https://example.com/image.jpg,,,,,<BOARD_ID>

Authoring tips

• Google Sheets is safer than Excel. Excel occasionally mangles UTF-8, smart quotes, and emoji when saving to CSV.
• Multiline content works: wrap the cell in double quotes and use real line breaks inside.
• Emoji are fine: save the file as UTF-8.
• Leave unused optional columns blank: empty cells are ignored.

Related

• Bulk import posts from a CSV
• Schedule a post to multiple platforms
• Why did my post fail?