Skip to main content

SchedPilot API

The SchedPilot API gives developers programmatic access to everything the SchedPilot platform can do. You can build integrations, automate posting workflows, connect AI agents, or embed scheduling capabilities directly into your own products.

What you can do​

  • Post to social accounts — publish or schedule content to Twitter/X, LinkedIn, Instagram, Facebook, Threads, Bluesky, Pinterest, YouTube, and TikTok from a single API call.
  • Manage media — upload images and videos once, then attach them to any post by ID.
  • Schedule posts — specify a future date, time, and timezone; SchedPilot handles delivery at the right moment.
  • Retrieve and filter posts — list your scheduled queue, filter by status or date range, and inspect per-platform delivery results.
  • Delete scheduled posts — cancel posts that have not yet been published.
  • Get analytics — pull impressions, reach, clicks, likes, comments, shares, and engagement rate for published posts.
  • Set up webhooks — receive real-time HTTP callbacks when posts are published, fail, or change status.
  • Connect AI agents — the API is designed to work well as a tool in LLM-powered workflows; authenticate with API keys and let agents schedule social content autonomously.

Base URL​

All API endpoints are available under:

https://api.schedpilot.com/developers/v1

Every path in this documentation is relative to that base URL.

Quick start​

Step 1 — Get an API key​

Log in to app.schedpilot.com/api-access, click Create Key, and copy the key that starts with smm_. The full value is shown only once, so save it somewhere safe.

See Authentication → API Keys for full details.

Step 2 — Fetch your connected accounts​

Make a GET /accounts request to retrieve the IDs and platform types of all social accounts linked to your SchedPilot profile. You will need these IDs when creating posts.

curl https://api.schedpilot.com/developers/v1/accounts \
  -H "X-API-KEY: smm_your_api_key_here"

A successful response looks like this:

{
  "accounts": [
    {
      "id": 12,
      "type": "twitter",
      "name": "Acme Corp",
      "username": "acmecorp",
      "picture": "https://pbs.twimg.com/profile_images/example/photo.jpg"
    },
    {
      "id": 17,
      "type": "linkedin",
      "name": "Jane Smith",
      "username": "janesmith",
      "picture": "https://media.licdn.com/dms/image/example/photo.jpg"
    }
  ]
}

Step 3 — Create your first post​

Use the account IDs from Step 2 to schedule a post. Pass a UTC (or timezone-aware) datetime for scheduled_date.

curl -X POST https://api.schedpilot.com/developers/v1/post \
  -H "X-API-KEY: smm_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "Hello from the SchedPilot API!",
    "scheduled_date": "2026-06-01 09:00:00",
    "timezone": "America/New_York",
    "accounts": [
      { "id": 12, "type": "twitter" },
      { "id": 17, "type": "linkedin" }
    ]
  }'

A 201 Created response confirms the post has been queued.

Next steps​