Documentation menu

Getting started

This guide takes you from a fresh browser tab to your first scheduled post. There are three steps: create an account, connect a social profile, and schedule a post. Most people finish in under ten minutes.

1. Create your account

Head to timetopost.co/login and sign up with your email address. Every new account starts with a trial, so you can test the full scheduling flow before picking a plan. When you sign up, TimeToPost automatically creates a personal organization for you β€” all posts, connected accounts, and analytics live inside an organization, which is also how team workspaces are shared later. You can invite teammates or create additional organizations at any time from the dashboard, but for your first post the personal one is all you need.

2. Connect your first social account

Open Dashboard β†’ Integrations and pick a platform β€” Instagram, TikTok, or X (Twitter). Clicking Connect opens the platform’s own OAuth consent screen in a popup. Approve the requested permissions and the popup closes itself; the account then appears in your integrations list with a connected status badge.

A few things worth knowing before you click:

  • Instagram requires a Professional account (Business or Creator). Personal Instagram accounts cannot be published to via the official API.
  • TikTok and X work with regular accounts; you log in with the account you want to post from.
  • You can connect multiple accounts per platform and organize them into groups β€” useful for agencies managing several brands.

Platform tokens eventually expire. When that happens the account shows an expired status and the composer prompts you to reconnect β€” one click, same OAuth popup. See the integrations guide for details per platform.

3. Schedule your first post

From the dashboard, open the composer and:

  1. Write your caption.
  2. Attach media if you like β€” images and video are uploaded straight from your browser to secure storage. Instagram requires at least one image or video.
  3. Select one or more connected accounts. One post can target several platforms at once.
  4. Pick a time. Choose Publish now, set a specific date and time, or β€” on plans with best-time-to-post β€” accept the suggested optimal slot computed from your own engagement history.

Hit Schedule and the post is saved with status SCHEDULED. The background scheduler picks it up when its time arrives and publishes it to every selected account, recording a per-account result. You can watch the status move through SCHEDULED β†’ PUBLISHING β†’ PUBLISHED on the posts list. The full lifecycle, including drafts and failure states, is covered in Scheduling.

Prefer to automate?

Everything above can also be done programmatically. Create an API token under Settings β†’ API and schedule a post with one request:

curl
curl -X POST https://timetopost.co/api/posts \
  -H "Authorization: Bearer ttp_your_token_here" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "Hello from the API!",
    "platforms": ["twitter"],
    "scheduledAt": "2026-07-01T15:00:00.000Z"
  }'

See the API reference for authentication and all endpoints, or the MCP server guide if you want an AI agent like Claude to manage your queue for you.