Developer API

Telegram Scheduling API

Call one endpoint and publish to Telegram. Validate a schedule, apply it, and check delivery status with a workspace key and plain REST calls.

Start free Open API reference 
curl -sS https://getsocialclaw.com/v1/posts/apply \
  -H "Authorization: Bearer $SOCIALCLAW_API_KEY" \
  -H "Content-Type: application/json" \
  -X POST \
  --data '{
    "timezone": "America/New_York",
    "posts": [{
      "account": "telegram:@northloopcafe",
      "name": "Launch announcement",
      "description": "Real-time delivery status just shipped for every scheduled post.",
      "publish_at": "2026-07-21T09:00:00-04:00",
      "media_link": "https://getsocialclaw.com/media/asset_example/dlv_example/announcement.jpg"
    }]
  }'
201 Created 
{
  "run": { "id": "run_8f2k1xz9", "mode": "scheduled" },
  "posts": [
    { "id": "post_3n0qd1h", "provider": "telegram", "status": "scheduled", "publishAtUtc": "2026-07-21T13:00:00Z" }
  ]
}

Every call your backend needs
in one workspace

Validate a schedule, apply it, and check delivery status, all with the same workspace key. Upload media once and reuse the link across every scheduled post.

GET /v1/accounts List connected accounts and which ones are ready to publish.
POST /v1/assets/upload Upload a photo or video and get back a link to reuse.
POST /v1/posts/validate Check a schedule against Telegram's rules before anything goes out.
POST /v1/posts/apply Publish now or queue posts for a future time.
GET /v1/runs/{runId}/status Confirm a post actually went live, or catch a failure early.
Open the full API reference

See what goes out

Every post lands in the same place a person scheduling by hand would use.

Upload & Manage
Media

Upload an image or a video once and reuse it across every scheduled Telegram post. SocialClaw hosts it for you, so Telegram always has what it needs the moment your post goes out.

Ready to grow
your socials?

Start free
Supported social platforms

Every other way in

Same workspace, same connected account, on whichever surface fits what you are building.

Use the dashboard

Schedule and manage Telegram posts visually. No code required.

 Use with MCP

Connect Claude, ChatGPT, or Codex to the hosted MCP server and let the agent schedule Telegram posts in conversation.

 Use with CLI

Schedule Telegram posts from a terminal, a cron job, or CI with npx socialclaw.

What builders are saying

Real quotes from Reddit, G2, Trustpilot, and Instagram.

G2 G2 review

“I can prepare the content once and let SocialClaw handle the distribution.”
Instagram

“If SocialClaw sees this just know you changed my entire workflow girl.”
r/mcp

“Since I try market my iOS apps, definitely SocialClaw… because then Claude can post to social media for me.”
r/socialmedia

“Most schedulers still feel like old calendar tools with an AI caption button added on top. SocialClaw feels more built around the newer AI era.”
r/automation

“SocialClaw if you want to schedule posts to social media.”
Trustpilot Trustpilot review

“SocialClaw handles the repetitive publishing work: uploading media, managing connected accounts, scheduling posts, publishing them, and retrying when something fails.”
r/SocialMediaManagers

“I used to use stuff like Buffer etc, but I use SocialClaw with my AI agent. I just tell it to schedule like 100 videos for the next month.”
r/AI_Agents

“It has an OpenClaw skill, or use it via API, CLI, or even the web dashboard.”
r/openclaw

“I have it install the SocialClaw skill, linked my social media accounts, and it actually has approval to post on my socials for me.”

Works with every major platform

Connect once, then schedule and publish everywhere from the same workspace.

Frequently Asked Questions

Every request needs an Authorization header in the form Bearer sc_live_your_key, using the workspace API key from your dashboard. The same key covers every connected account, including Telegram, so there is no separate key per platform.