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.
Authorization
Bearer AuthorizationBearer <token>
API key (rlay_live_* or rlay_test_*)
In: header
Query Parameters
dry_run?string
Set to "true" to validate without creating posts
Response Body
application/json
application/json
application/json
application/json
curl -X POST "https://api.relayapi.dev/v1/posts/bulk-csv"{
"data": [
{
"row": 0,
"status": "success",
"post_id": "string",
"error": {
"code": "string",
"message": "string"
}
}
],
"summary": {
"total_rows": 0,
"succeeded": 0,
"failed": 0,
"skipped": 0,
"posts_created": 0
}
}{
"data": [
{
"row": 0,
"status": "success",
"post_id": "string",
"error": {
"code": "string",
"message": "string"
}
}
],
"summary": {
"total_rows": 0,
"succeeded": 0,
"failed": 0,
"skipped": 0,
"posts_created": 0
}
}{
"error": {
"code": "string",
"message": "string",
"details": {
"property1": null,
"property2": null
}
}
}{
"error": {
"code": "string",
"message": "string",
"details": {
"property1": null,
"property2": null
}
}
}Found something wrong? Help us improve this page.