ClippedDocs

API reference

Posting a clip

Posting needs the destination's account connected under Settings → Accounts. When more than one is, the routing rules there decide which account a clip goes to, unless account names one.

YouTube posts it as a Short, cut vertical if it isn't already; a clip over three minutes is refused, so trim it first. TikTok puts it in the creator's inbox as a draft to caption and post in the app — status comes back drafted, not published. Instagram posts it as a Reel, publicly, straight away.

The call waits for the upload, which can take a minute, and answers with where it landed. Leave the title and description out to use the account's templates.

Endpoints

POST/api/v1/clips/{id}/publish

Post it.

destination is youtube, tiktok or instagram.

Fields

The body

destinationstring

Required. youtube, tiktok or instagram.

accountstring

Which connected account, by id (from Settings → destinations). Left out, the routing rules pick.

titlestring

This post's title, instead of the template's.

descriptionstring

This post's description. On Instagram, title and description together are the caption.

tagsstring[]

YouTube only.

privacystring

YouTube only: public, unlisted or private.

Examples

The answerJSON
{
  "published": {
    "destination": "youtube",
    "status": "published",
    "url": "https://youtube.com/shorts/abc123",
    "account": "Jynxzi Clips",
    "accountId": "UC…",
    "at": 1791918000000
  }
}

Use cases