Skip to content

create_post

Schedule a video on a connected account (see list_accounts for each account's platform). The post waits in mixetape (editable, cancellable) until shortly before scheduledAt. YouTube and Facebook get it leadMinutes early, unpublished, and publish it themselves at scheduledAt; Instagram and Threads get it prepared leadMinutes early and mixetape publishes it at scheduledAt; TikTok and Pinterest cannot hold a post, so mixetape posts it at scheduledAt. Each platform takes its own metadata (Facebook format reel for a Reel, Pinterest boardId is required, TikTok privacyLevel). Thumbnail, playlists and captions are applied right after upload where the platform supports them; firstComment is posted once it is public. mediaUrl: a public https URL, or an r2:// URL from mixetape storage (create_upload / import_file). Needs the publish permission. Also available as the MCP tool create_post.

POST
https://mixetape.com/api/v1/tools/create_post

Authorisation

  • apiKeyHTTPrequired

Request bodyJSONrequired

  • accountIdstringrequired

    mixetape account id (list_accounts)

  • mediaUrlstringrequired
  • captionoptionalstring
  • scheduledAtoptionalstring

    ISO 8601 with timezone offset — when it goes live. Omit to post now (live after leadMinutes).

  • leadMinutesoptionalnumber

    Minutes before go-live that mixetape uploads or prepares it, so the platform finishes processing first (defaults: YouTube and Facebook 30, Instagram 15, Threads 10; TikTok and Pinterest always 0). 0 uploads at go-live time. Facebook needs 0 or at least 15.

  • metadataoptionalYouTubeorFacebookorInstagramorThreadsorTikTokorPinterest
    6 variants

    One of the following:

    • YouTube
    • Facebook
    • Instagram
    • Threads
    • TikTok
    • Pinterest

Returns

200

The tool's result.

JSON
  • resultunknownrequired

    What the tool returns

400

The request is invalid; error says why.

JSON
  • errorstringrequired

    What went wrong, in plain words

401

No valid API key.

JSON
  • errorstringrequired

    What went wrong, in plain words

403

The key lacks the permission this needs.

JSON
  • errorstringrequired

    What went wrong, in plain words

404

Not found, or not yours.

JSON
  • errorstringrequired

    What went wrong, in plain words

Navigation

Type to search…

↑↓ navigate↵ selectEsc close