Quickstart — Schedule & Chill Docs

Getting Started

Quickstart

Schedule your first post in three steps.

1. Create an API key

Sign in at schedulenchill.com, open Settings → API Keys, and click Create Key. Copy the token immediately — it is shown only once.

All requests send the key as a bearer token:

Authorization: Bearer YOUR_API_KEY

2. Find a connected account

Posts publish to connected accounts. List the accounts you have connected and grab an id:

curl https://schedulenchill.com/api/posts \
  -H "Authorization: Bearer YOUR_API_KEY"

To connect accounts (X, LinkedIn, etc.), use the dashboard under Settings → Connected Accounts. Over MCP you can list accounts with the get_accounts tool.

3. Schedule a post

Create a post for one or more accounts. Omit scheduled_at and set publish_now to publish immediately.

curl -X POST https://schedulenchill.com/api/posts \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
    "content": "Shipped our API today 🚀",
    "social_account_ids": [789],
    "scheduled_at": "2026-06-10T14:00:00Z"
  }'

A 201 Created response returns the post with its status (scheduled), the attached accounts, and per-platform delivery status:

{
    "id": 123,
    "content": "Shipped our API today 🚀",
    "status": "scheduled",
    "scheduled_at": "2026-06-10T14:00:00Z",
    "socialAccounts": [
        { "id": 789, "platform": "x", "pivot": { "status": "pending" } }
    ]
}

That's it. From here:

Authentication — manage keys.
Posts — full create/update/list/delete reference.
Media — attach images and video.
MCP Server — do the same from an AI agent.

Introduction

Authentication