Bulk create posts
Create multiple posts in a single request. Each item follows the same schema as single post creation.
Authorization
Bearer AuthorizationBearer <token>
API key (rlay_live_* or rlay_test_*)
In: header
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
curl -X POST "https://api.relayapi.dev/v1/posts/bulk" \ -H "Content-Type: application/json" \ -d '{ "posts": [ { "targets": [ "string" ], "scheduled_at": "now" } ] }'{
"data": [
{
"id": "string",
"status": "draft",
"content": "string",
"scheduled_at": "string",
"published_at": "string",
"targets": {
"property1": {
"status": "draft",
"platform": "twitter",
"accounts": [
{
"id": "string",
"username": "string",
"display_name": "string",
"avatar_url": "string",
"url": "string",
"platform_post_id": "string"
}
],
"error": {
"code": "string",
"message": "string"
}
},
"property2": {
"status": "draft",
"platform": "twitter",
"accounts": [
{
"id": "string",
"username": "string",
"display_name": "string",
"avatar_url": "string",
"url": "string",
"platform_post_id": "string"
}
],
"error": {
"code": "string",
"message": "string"
}
}
},
"media": [
{
"url": "http://example.com",
"type": "image"
}
],
"target_options": {
"property1": {
"property1": null,
"property2": null
},
"property2": {
"property1": null,
"property2": null
}
},
"timezone": "string",
"metrics": {
"impressions": 0,
"reach": 0,
"likes": 0,
"comments": 0,
"shares": 0,
"saves": 0,
"clicks": 0,
"views": 0,
"engagement_rate": 0
},
"recycling": {
"id": "string",
"enabled": true,
"gap": 0,
"gap_freq": "day",
"start_date": "2019-08-24T14:15:22Z",
"expire_count": 0,
"expire_date": "2019-08-24T14:15:22Z",
"content_variations": [
"string"
],
"recycle_count": 0,
"content_variation_index": 0,
"next_recycle_at": "2019-08-24T14:15:22Z",
"last_recycled_at": "2019-08-24T14:15:22Z",
"created_at": "2019-08-24T14:15:22Z",
"updated_at": "2019-08-24T14:15:22Z"
},
"recycled_from_id": "string",
"thread_group_id": "string",
"thread_position": 0,
"created_at": "2019-08-24T14:15:22Z",
"updated_at": "2019-08-24T14:15:22Z"
}
],
"summary": {
"total": 0,
"succeeded": 0,
"failed": 0
}
}{
"error": {
"code": "string",
"message": "string",
"details": {
"property1": null,
"property2": null
}
}
}Found something wrong? Help us improve this page.
Posts
Previous Page
Bulk create posts from CSV POST
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.