Documentation menu

Developers | Updated 2026-07-07

Use API tokens and media uploads

Create personal API tokens, upload media with presigned URLs, and schedule posts through the REST API.

Token basics

REST API tokens use the ttp_ prefix and are created from Settings, then API. Store them like passwords. The token acts under your account and active organization.

Media workflow

Upload media before you create a post that needs image or video attachments.

  1. Request a presigned upload URL from the media endpoint.
  2. Upload the file directly from your client to storage.
  3. Use the returned public URL in the post payload.
  4. Validate platform requirements before scheduling. Instagram needs media.
  5. Read the post after publishing to confirm per-account results.

When to use MCP instead

Use REST when you are writing software. Use MCP when an AI agent is doing the work interactively and should authenticate through browser OAuth.

Related guides and tools