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`.

POST
/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.

Authorization

BearerAuth
AuthorizationBearer <token>

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"    }  ]}