RelayAPI
Posts

Bulk create posts from CSV

Upload a CSV file to create multiple posts. Use dry_run=true to validate without creating. CSV columns: content, targets (semicolon-separated), scheduled_at, media_urls (semicolon-separated), timezone, target_options (JSON string). Max 500 rows, max 1 MB file size.

POST
/v1/posts/bulk-csv

Authorization

Bearer
AuthorizationBearer <token>

API key (rlay_live_* or rlay_test_). Invite redemption also accepts a server-derived rlay_session_ bearer for a current user session.

In: header

Query Parameters

dry_run?string

Set to "true" to validate without creating posts

workspace_id?string

Workspace ID for every CSV row. Omission lets each row inherit its sole target-account workspace in either policy mode.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/v1/posts/bulk-csv"
{  "data": [    {      "error": {        "code": "string",        "message": "string"      },      "post_id": "string",      "row": 0,      "status": "success"    }  ],  "summary": {    "failed": 0,    "posts_created": 0,    "skipped": 0,    "succeeded": 0,    "total_rows": 0  }}

Found something wrong? Help us improve this page.

Report an issueEdit this page on GitHub

Bulk create posts POST

Create multiple posts in a single request. Each item follows the same schema as single post creation.

Create a post POST

Create a post. Use scheduled_at: "now" to publish immediately, "draft" to save as draft, or an ISO timestamp to schedule.