Skip to main content
Sign Up

Twitter / X Messaging API

List conversations, read message history, and send Twitter/X direct messages programmatically. PostPeer gives you one unified endpoint and handles OAuth so you never touch the developer portal.

  • List DM conversations with participants and last message
  • Load full message history for any conversation
  • Send direct messages from one unified endpoint
  • OAuth handled, no Twitter developer app needed
Start Posting for FreeView Docs
No credit card required.
POST https://api.postpeer.dev/v1/posts
{ "platforms": ["twitter", "linkedin"], "content": "Hello world!" }
Published
2 platforms
TwitterLinkedIn
All posts delivered
Scheduled
queue
12
Queued
847
Sent
Next: in 15 min
Platforms
connected
XLIFBTT
One API, every platform
DF

"I was up and running on six different platforms in under 30 minutes. Strongly recommend!"

David Flor, Founder at Darklight Interactive

Divanshu KhatterMarketing Manager at Sembark

"Couldn't figure out the official Pinterest API. PostPeer was smooth. Using it daily."

Divanshu Khatter, Marketing Manager at Sembark

Het TikawalaFounder at Kalizzle AI Studio

"Great integration experience. Jonathan ships fixes within hours. Mad respect for the speed."

Het Tikawala, Founder at Kalizzle AI Studio

Add Social Media to Your Product in Three Steps

Connect once, then publish, schedule, and read data through the same API.

01

Get Your API Key

Sign up and get your API key instantly. No sales calls or complicated setup.

02

Integrate in Minutes

Connect once to PostPeer to publish, schedule, analyze, manage comments, and handle messages.

03

Support Every Major Platform

Give your users access to major social platforms without building and maintaining each integration yourself.

New to PostPeer? Read the getting started guide

One Request. Structured Response.

Clean, predictable JSON that's easy to parse and integrate.

POSTRequest
curl "https://api.postpeer.dev/v1/messages?platform=twitter&accountId=acc_tw_123&limit=20" \
  -H "x-access-key: your-api-key"
JSONResponse
{
  "success": true,
  "selfId": "44196397",
  "selfUsername": "yourbrand",
  "conversations": [
    {
      "id": "44196397-2233445566",
      "participants": [
        {
          "id": "2233445566",
          "name": "Jane Doe",
          "username": "jane_doe",
          "profilePictureUrl": "https://pbs.twimg.com/profile_images/..."
        },
        {
          "id": "44196397",
          "name": "Your Brand",
          "username": "yourbrand",
          "profilePictureUrl": "https://pbs.twimg.com/profile_images/..."
        }
      ],
      "lastMessage": {
        "id": "1560000000000000001",
        "text": "Can you help with my order?",
        "from": {
          "id": "2233445566",
          "name": "Jane Doe"
        },
        "timestamp": "2026-08-05T16:40:00Z"
      },
      "updatedTime": "2026-08-05T16:40:00Z"
    }
  ],
  "nextCursor": "QVFIUl9..."
}

Everything You Need for Twitter/X DMs

Read and send direct messages without wrestling the Twitter API. List conversations, load history, and send DMs from one endpoint.

List Conversations

Fetch DM conversations for a connected Twitter/X account with each participant name, username, and profile picture, plus the most recent message and updated time.

Read Message History

Load the messages in a DM conversation, paginated, each with the sender and a timestamp. Rebuild the full thread on your side.

Send Direct Messages

Send a DM to a recipient with one call. The response returns the sent message ID so you can track delivery and reconcile it against your inbox.

OAuth Handled

Your users connect their Twitter/X account through PostPeer's OAuth flow. No developer app, no token refreshes, and no rate-limit wrangling on your side.

Build Your Own Inbox

Everything the PostPeer dashboard inbox uses is available through the API, so you can build a branded support inbox or route DMs into your own tooling.

One Endpoint Across Platforms

The Twitter/X Messages surface uses the same `/v1/messages` request and response shape as every other PostPeer messaging endpoint. One integration covers them all.

Beyond Twitter / X: Every Supported Platform

Start with Twitter / X, then reach every other network through the same API.

Instagram API

Handle Instagram conversations.

Facebook API

Handle Facebook conversations.

You're here

Twitter / X API

Handle Twitter / X conversations.

LinkedIn API

Handle LinkedIn conversations.

TikTok API

Handle TikTok conversations.

Add More Social Capabilities

Use the same connected accounts to schedule, analyze, manage comments, and handle conversations.

Posting API

Publish to every network through one endpoint.

Explore

Scheduling API

Queue and deliver posts at the perfect time.

Explore

Analytics API

Pull engagement and reach metrics into your product.

Explore

Comments API

Read, reply to, hide, and manage comments.

Explore
Try PostPeer API for FreeView All Documentation

Frequently Asked Questions

Power Your Next Project With a Unified Social Media API

Give your users posting, scheduling, analytics, and engagement features through one API your team can maintain.

Start with 20 free credits. No credit card required.

Start Posting for FreeRead the Docs