Twitter / X API · Tweets · Threads · Image Posts · Video Posts

The Twitter / X publishing API for developers

Post tweets and threads to X (Twitter) via REST API with full scheduling. PostPulse owns the platform access, so you ship on day one — no audit, no token plumbing.

Get started free →Read the API docs

No platform audit on your side No tokens to babysit No credit card to test

Numbers from the last 12 months · see live stats →

Twitter / X posts shipped

Total posts published

across all 9 platforms

Platforms — one API

Native Twitter / X API · the actual cost

What you'd build and maintain yourself

Every item below is real friction the native Twitter / X API hands you. PostPulse handles all of them.

Capped free tier

X/Twitter API v2 Free tier has a limited post volume (1,500 posts/month) that may not scale

PostPulse manages X API access behind one endpoint.

$100/mo Basic tier

Basic tier ($100/month) is required for any meaningful posting volume

PostPulse abstracts the X API tiers for you.

OAuth 1.0a vs 2.0

OAuth 1.0a and OAuth 2.0 both exist; choosing the wrong one for your use case breaks posting

PostPulse selects and manages the right auth flow.

Manual thread chaining

Thread creation requires sequential post chaining with reply IDs — complex to implement

Post threads without wiring reply-ID chains.

Split media endpoints

Media upload is a separate v1.1 endpoint that was not migrated to v2

One media flow — no v1.1/v2 juggling.

Minutes to your first post

Schedule a Twitter / X post in two API calls

Import your media, then schedule the post with your Twitter / X settings. PostPulse does the rest.

# Step 1: Import media from a public URL
curl -X POST https://api.post-pulse.com/v1/media/upload/import \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "url": "https://your-cdn.com/media/video.mp4" }'

# Response: { "path": "uuid/video.mp4" }

# Step 2: Schedule a post using the publications array
curl -X POST https://api.post-pulse.com/v1/posts \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "scheduledTime": "2026-06-01T10:00:00Z",
    "isDraft": false,
    "publications": [
      {
        "socialMediaAccountId": 123,
        "platformSettings": { "type": "TWITTER" },
        "posts": [
          {
            "content": "Check out our latest content! #developer #api",
            "attachmentPaths": ["uuid/video.mp4"]
          }
        ]
      }
    ]
  }'

What you ship on day one

What you can build with the Twitter / X API

Every capability maps to a real field in the API. Click through for the exact request shape.

Twitter / X Video Scheduling

Schedule video posts to publish at a specific future date and time across multiple platforms.

Twitter / X Image Posting

Post single images or photo collections to social media platforms via REST API.

Twitter / X Scheduling

Schedule any post type — text, image, video, or carousel — to publish at a precise future timestamp.

Twitter / X Auto-Publish

Trigger immediate publication to social media platforms from your backend or automation workflow.

Twitter / X Media Upload

Upload images and videos via direct binary upload, presigned URL, or remote URL import — then reference the media path in attachmentPaths.

Twitter / X Threads

Publish multi-part thread sequences to Twitter/X and Threads with a single API call.

Twitter / X Webhooks

Receive real-time webhook events for post completion, failure, and media import status across all platforms.

Twitter / X White-Label

Let your users connect their own social accounts via a seamless OAuth flow that never exposes PostPulse branding.

DIY vs PostPulse

The same Twitter / X integration, two timelines

Both columns assume you know your stack. Only one has you doing undifferentiated platform plumbing.

DIY · native Twitter / X API

Register a developer app and configure OAuth redirect URLs
Implement the OAuth flow plus token refresh and rotation
Build the media-upload and publish flow around Twitter / X's quirks
Clear access requirements — review, quota, or partner approval where required
Build scheduling, retries, and failure alerting yourself
Keep up with API version changes — forever

PostPulse

Minute 0 · Sign up free
Minute 3 · Connect a Twitter / X account via OAuth
Minute 6 · POST /v1/posts — first post live
Minute 7 · A webhook calls your URL the second it lands
Day 2+ · Build your product, not platform plumbing

Twitter / X-specific API settings

Control Twitter / X publishing options via the platformSettings object in your publication entry.

Field	Description	Accepted Values
`type`	Publication type	`POST`

Twitter / X media requirements

PostPulse validates your media before publishing to Twitter / X to prevent platform rejections.

Image Formats

JPG
PNG
WEBP

Max size: 5 MB

Video Formats

Max size: 512 MB

Video Duration

140 seconds

Aspect Ratio

1:3 to 3:1

Max Attachments

4 files per post

Pricing

Start free. Scale when it makes sense.

The same simple pricing across every platform — no per-network surcharge.

Free

$0on signup

10 publications, free
No credit card required
Every feature unlocked
Connect unlimited accounts

most picked by devs

Pay-as-you-go

$0.20/ publication

One credit = one published post
No subscription, no expiry
All features included
Top up anytime

Top up credits

Subscription

$5/ account / mo

Unlimited publishing per account
Or $48 / year per account
Add or remove accounts anytime
REST API · n8n · Make · MCP

Start subscription

Building Twitter / X into a product your users connect their own accounts to? See the white-label / Connect tier →

PostPulse vs. the native Twitter / X API

What PostPulse handles vs. what you'd build yourself.

Capability	PostPulse	Native Twitter / X API
Platform audit / App Review	✓ Not required	✗ Required (weeks to months)
Auth token management	✓ Handled by PostPulse	Implement OAuth + token refresh
Media upload workflow	✓ Single endpoint	Multi-step async upload
Post scheduling	✓ Built-in scheduledTime	Build your own cron queue
Failure notifications	✓ 14 webhook events	Poll for status manually
Multi-platform publishing	✓ 9 platforms, same request	Separate API per platform
White-label OAuth for your users	✓ Included	Build your own OAuth bridge
AI agent integration (MCP)	✓ Claude, Cursor	✗ Not available

James Mccarthy

I use PostPulse with an AI agent via their MCP server. My agent literally posts to social media on its own now. Didn’t expect that to work as smoothly as it did.

Antonio Widera

$5/month for what would otherwise require a full backend engineer to maintain? Easy yes. The REST API is clean and well-documented too, which is rare.

Shawn Padilla

Tried to get TikTok API access myself. Three weeks, two rejections. Switched to PostPulse and was posting to TikTok the same day. Wish I hadn’t wasted that time.

Karen Rivers

I’m a Make.com power user and needed to post to 5 platforms from one scenario. The native PostPulse app for Make connected everything in one afternoon. Would’ve taken me weeks to do manually.

Douglas Finch

I built an n8n automation for a client and needed to add social publishing. The official PostPulse n8n node was literally drag and drop. No headache.

Andrea Scott

Saved me months of dev work. I was about to start integrating Instagram and TikTok APIs separately — then I found out Meta’s app review alone can take months. PostPulse just handled all of that. Shipped social posting in under a week.

William Dirks

The most flexible pricing model on the market!

I'm building an AI content factory as a side hustle. I'm still in the experimentation phase, so I don't have the budget for expensive tools — but I also needed to get everything up and running quickly, so I integrated with a ready-to-go API instead. PostPulse offers a flexible pay-as-you-go model that let me experiment first without commitment — and now that we have stable traffic, I’ve switched to their $5/month subscription.

Best support on the market — the founder personally emailed me when I hit a client error and walked me through the fix.

solo serg

We optimized the posting to 20 twitter accounts. It was a problem to manage such a number, but through the platform everything works out perfectly. Very convenient dashboard for tracking errors. Great product.