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://example.com/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", "target_id": "string" } ], "error": { "code": "string", "message": "string", "detail": "string" } }, "property2": { "status": "draft", "platform": "twitter", "accounts": [ { "id": "string", "username": "string", "display_name": "string", "avatar_url": "string", "url": "string", "platform_post_id": "string", "target_id": "string" } ], "error": { "code": "string", "message": "string", "detail": "string" } } }, "media": [ { "url": "http://example.com", "type": "image", "thumbnail": "string" } ], "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.