Create a Post
Upload a video to one or more connected platforms. **Video Requirements:** - Format: MP4, MOV, or other common video formats - Size: Maximum 500MB - Duration: 3-90 seconds - Orientation: Vertical (9:16) **Scheduling:** - Pass `scheduled` as a Unix timestamp in milliseconds for scheduled posting (omit this parameter if you don't want to schedule) **Posting settings:** - Pass optional per-platform controls in the JSON-encoded `settings` form field, grouped by platform name. - Example: `{"TikTok":{"status":"PUBLIC_TO_EVERYONE"},"YouTube":{"title":"Product walkthrough","status":"unlisted"}}`. - Supported options and accepted values depend on the destination platform. These settings apply to immediate and scheduled posts. - See https://docs.taisly.com/en/docs/api/post-settings. - Boolean settings must be JSON booleans, not strings; invalid known settings return `INVALID_POST_SETTINGS`.
Upload a video to one or more connected platforms.
Video Requirements:
- Format: MP4, MOV, or other common video formats
- Size: Maximum 500MB
- Duration: 3-90 seconds
- Orientation: Vertical (9:16)
Scheduling:
- Pass
scheduledas a Unix timestamp in milliseconds for scheduled posting (omit this parameter if you don't want to schedule)
Posting settings:
- Pass optional per-platform controls in the JSON-encoded
settingsform field, grouped by platform name. - Example:
{"TikTok":{"status":"PUBLIC_TO_EVERYONE"},"YouTube":{"title":"Product walkthrough","status":"unlisted"}}. - Supported options and accepted values depend on the destination platform. These settings apply to immediate and scheduled posts.
- See https://docs.taisly.com/en/docs/api/post-settings.
- Boolean settings must be JSON booleans, not strings; invalid known settings return
INVALID_POST_SETTINGS.
Authorization
BearerAuth In: header
Request Body
multipart/form-data
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/post" \ -F video="string" \ -F platforms="[ \"string\" ]"{ "success": true, "historyId": "64f000000000000000000001", "scheduled": false, "date": "2026-06-10T10:00:00.000Z", "result": [ { "platformId": "64f000000000000000000002", "status": "PENDING" } ]}Posts
Upload videos and post to multiple platforms simultaneously. Schedule posts for later or post immediately.
Get Post History GET
Retrieve your posting history with status information for each platform. **Pagination**: - Use `page` parameter for pagination (10 items per page) - Or use `startTime` and `endTime` for date range filtering (returns all matching posts) **Status Values**: - PENDING: Post is queued - SUCCESS: Posted successfully - FAILED: Post failed (check message field for error code)