X

X (Twitter) API for Posting: Publish & Schedule Tweets

Post to X without your own developer account or API keys, and with scheduling that X's own API doesn't have. Use one key from your app, an AI agent or n8n.

Free plan · 2 accounts · No credit card · API + MCP included

SEND FROMYour appAI agentn8n / ZapierPOST /v1/posts · X← publishedWoopSocialNo X keysValidateAccountDraft copy280 charsScheduleFri 17:00Publishtoken refreshedyour_brandXPOST000webhook
  • Text posts
  • Long posts (X Premium)
  • Image posts
  • Multi-image posts
  • Video posts
  • Scheduled posts
  • Drafts

Last updated 28 October 2026. The pay-per-use prices and the note that XMCP can publish but not schedule are stated as of that date.

Reviewed by Attila Kun, Technical Co-founder. Last updated 28 October 2026.

What is the X API for posting?

The X API for posting/publishing is the official way for apps to publish posts on an X account. It requires a developer account, your own app and an OAuth setup. The X Posting API is pay-per-use since April 20, 2026: it costs about $0.015 to post a single post/tweet, along with $0.20 for posts that contain a URL. There is no scheduling endpoint in the official X Posting API. XMCP can publish your posts but it cannot schedule them. Getting data on follows, likes and quotes are only part of the Enterprise-only plans that X offers.

With WoopSocial, you can post to X without setting up a developer account or managing your own keys. WoopSocial also adds scheduling and drafts that the X API doesn't offer, along with automatic retries and delivery webhooks. That's because WoopSocial's own connection to X already exists, you just connect an account and start posting – it's free to get started. You get 2 accounts and monthly credits for X posts.

WoopSocial vs the X API

Comparison of the X API direct versus WoopSocial for posting
X API directWoopSocial
A developer account, an app, keys and OAuth to set upConnect an X account and you’re done
No scheduling endpoint, and XMCP can’t schedule eitherSCHEDULE_FOR_LATER and drafts
Pay-per-use - about $0.015 per post and $0.20 with a URLPlan credits: 5 per post, 20 per post with a URL (Pro at $19 gives 1,000 credits, up to 200 posts)
Your own retry and rate-limit handlingAutomatic retries and delivery webhooks

Three steps to automated X posting

  1. Step 1

    Connect your account

    Send yourself, or your own users, a hosted connect link and they approve access to their X account in a few clicks. You actually don't need to create an X developer account or app and you never handle X keys.

  2. Step 2

    Create the post

    Send one request describing the post - the X account, your text, optional images or video, and when it should go out. Use SCHEDULE_FOR_LATER with a UTC timestamp to queue it, or save a draft.

  3. Step 3

    We handle the rest

    WoopSocial uploads your media and publishes it at the scheduled time. Temporary failures will retry automatically, and delivery webhooks tell your app when a post goes out or fails.

Everything you need to ship X features

Scheduling X doesn’t offer

X’s API has no scheduling endpoint, and the official XMCP can post but can’t schedule. WoopSocial adds it - you can decide to schedule to your preferred time in UTC, or save a draft.

One message, shorter X copy

Write one update, then use contentOverride to send a short version to X and a longer one to LinkedIn, all in a single request.

Images, video and long posts

Attach images or video to a post. Accounts with X Premium can post long posts of up to 25,000 characters.

Delivery webhooks & retries

Know when a post has been published or failed. Temporary issues retry automatically, so a timeout doesn’t mean a post doesn’t get published.

AI agents can post to X

Add WoopSocial's MCP server to Claude, ChatGPT or Cursor and you can request for posts in plain language. Agents like Hermes post to X natively. See our Hermes and Muse pages for more.

Three ways in

REST, MCP, n8n/Zapier/Make.

  1. 1 · Account

    Create a free WoopSocial account

    Sign up at app.woopsocial.com/signup (no credit card). You'll authorize through OAuth when the agent connects — no API key required for MCP.

  2. 2 · X

    Connect your account

    Link an X account in the WoopSocial dashboard before you ask an agent to post. No X developer app or keys.

  3. 3 · Agent

    Add the MCP URL and authorize

    Use https://api.woopsocial.com/mcp. Your client opens OAuth — approve access and you're connected. Docs: Integrating MCP clients.

Install by client

Pick your agent. Cards marked On this site open another WoopSocial page; External opens outside this site (new tab).

Config for Cursor / other MCP clients

Prefer 1-click? Install the WoopSocial Cursor plugin. Or paste this into .cursor/mcp.json (or your client's MCP config). Authorize with OAuth when prompted — no API key in the URL. Allowlist *.cloudflarestorage.com if media uploads are blocked.

json
{
  "mcpServers": {
    "woopsocial": {
      "url": "https://api.woopsocial.com/mcp"
    }
  }
}

Claude Code

One command registers the remote HTTP MCP server. Complete OAuth when prompted.

bash
claude mcp add --transport http woopsocial "https://api.woopsocial.com/mcp"

After install — try this

Plain-language X prompt

You

Schedule this post to X for Friday at 5pm

Prefer a full walkthrough with screenshots? Start at /social-media-mcp.

REST API example: schedule a post to X

Same POST /posts call with a Bearer API key. Authorization header and request body included.

bash
curl -X POST https://api.woopsocial.com/v1/posts \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "content": [{
      "text": "Shipping this week."
    }],
    "schedule": {
      "type": "SCHEDULE_FOR_LATER",
      "scheduledFor": "2026-07-03T17:00:00Z"
    },
    "socialAccounts": [{
      "platform": "X",
      "socialAccountId": "YOUR_X_ACCOUNT_ID"
    }]
  }'

Prefer a calendar? Schedule tweets from the dashboard

WoopSocial has a calendar where you can schedule your tweets for the exact date and time you want - X's own API doesn't have this. Use more than one X account? You can view and manage multiple accounts side by side in the dashboard, perfect for agencies or anyone running multiple brands. There are also AI captions for you to explore as well as cross-posting to LinkedIn, Threads and Bluesky from the same screen. The dashboard is built on the same backend as the API so a post your team schedules into the calendar acts just like one your code schedules. Need to check the length first? Try our tweet character counter. The free plan includes 2 accounts and needs no credit card.

Schedule from the dashboard
WoopSocial calendar for scheduling posts to X

X requirements & limits

  • Characters

    Standard accounts can post up to 280 characters. Accounts with X Premium can post up to 25,000 characters - long posts are supported.

  • Media

    Each post can allow up to 4 images, or 1 video.

  • Video length

    Video can run up to 20 minutes for standard accounts. Longer recordings need to be trimmed before you can schedule them.

  • Automation rules

    X prohibits duplicate or spammy automated posting. Read X's automation rules before you automate.

Cross-post to

LinkedIn, Threads and Bluesky, with short-form copy variants.

FAQ

Does the X API support scheduling?

No. X's API has no scheduling endpoint, and even the official XMCP server can post but can't schedule. WoopSocial allows scheduling - set SCHEDULE_FOR_LATER with a UTC timestamp, or save a draft, and WoopSocial publishes the post at the designated time.

Do I need my own X developer account or API keys?

No. You connect your X account through WoopSocial's authorization link and start posting. No X developer account to create, no app to set up and no keys to bother about. WoopSocial takes care of the connection to X for you.

How much does posting to X cost?

X posts use your plan's monthly credits - 5 credits for a standard post and 20 for a post containing a URL. Free includes 30 credits, Pro 1,000, Business 5,000 and Max 42,000.

Can I post threads?

No. As of right now, each WoopSocial post can only include one content item, so each request will publish one post to X rather than a thread of connected posts. You can still schedule individual posts at different times but it won't be a linked thread.

Can I post images and videos?

Yes. Up to 4 images or 1 video can be added to each post, and these posts can be scheduled and saved as drafts. X Premium accounts have the ability to publish long posts of up to 25,000 characters, while regular accounts have a limit of 280 characters.

Does it include X analytics?

No. WoopSocial doesn't provide any post-level analytics for X, so for impressions and engagement use X's analytics.

How many X accounts can I connect?

Your plan defines account limits - 2 on Free, 20 on Pro, 100 on Business, and 2,500 on Max. Each X account connects via its own authorization and one API key can publish to any. Posts consume credits based on your plan for the month.

Can AI agents post to X?

Yes. WoopSocial's MCP server works in Claude, ChatGPT and Cursor, so you can ask an assistant to write and schedule an X post in plain language. It adds scheduling, which X's official XMCP doesn't offer. Our guide to scheduling social media posts with MCP covers the setup.

Post to more than X

Same API key. Same request format. Same across all the networks listed below. One integration for all of these networks.

Start posting to X today

“I built directly against the v1 API and it held up. Raw-bytes upload with server-side MIME detection, native scheduling that let me drop a whole polling layer, and automatic per-platform field handling so one upload lands correctly on four platforms with the right metadata on each. The automatic AI-disclosure on TikTok was a nice touch given everything I post is AI-generated. It's been live and posting across all my accounts without babysitting. If you're automating multi-platform publishing instead of clicking through a dashboard, this is the rare API that's actually pleasant to work with for an engineer. Recommend it!”

Joe

Connect an X account, grab a free API key and publish your first post in minutes. No X developer account, no keys of your own, no credit card.

Free plan · 2 accounts · No credit card · API + MCP included