Manage Posts

The Manage Posts endpoints let you create and delete Posts on behalf of authenticated users. Reference for the Enterprise X API tier covering manage tweets.

The Manage Posts endpoints let you create and delete Posts on behalf of authenticated users. Build applications that post content, create threads, or manage user Posts.

Overview

Create Post

Publish a new Post

Delete Post

Delete an existing Post

Reply

Reply to another Post

Quote

Quote another Post

---

Endpoints

Method	Endpoint	Description
POST	/2/tweets	Create a new Post
DELETE	/2/tweets/:id	Delete a Post

---

Creating Posts

Basic Post

curl -X POST "https://api.x.com/2/tweets" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"text": "Hello from the API!"}'

Reply to a Post

curl -X POST "https://api.x.com/2/tweets" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "This is a reply!",
    "reply": {
      "in_reply_to_tweet_id": "1234567890"
    }
  }'

Quote a Post

curl -X POST "https://api.x.com/2/tweets" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "Check this out!",
    "quote_tweet_id": "1234567890"
  }'

Post with media

curl -X POST "https://api.x.com/2/tweets" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "Photo of the day",
    "media": {
      "media_ids": ["1234567890123456789"]
    }
  }'

Upload media first using the Media Upload endpoint, then reference the media_id in your Post.

Post with poll

curl -X POST "https://api.x.com/2/tweets" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "What is your favorite color?",
    "poll": {
      "options": ["Red", "Blue", "Green", "Yellow"],
      "duration_minutes": 1440
    }
  }'

Post with paid partnership

Use the paid_partnership field when creating a Post to indicate it is a paid partnership (i.e., the author is disclosing that the Post contains paid promotion). When set to true, the Post will be labeled as a paid promotion.

curl -X POST "https://api.x.com/2/tweets" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "Excited to partner with Acme on their latest launch!",
    "paid_partnership": true
  }'

To retrieve the value on existing Posts (including your own), request it via the tweet.fields parameter:

curl "https://api.x.com/2/tweets/1234567890?tweet.fields=paid_partnership,created_at" \
  -H "Authorization: Bearer $TOKEN"

---

Deleting Posts

curl -X DELETE "https://api.x.com/2/tweets/1234567890" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN"

You can only delete Posts authored by the authenticated user.

---

Getting started

Prerequisites

• An approved developer account
• A Project and App in the Developer Console
• User Access Tokens via OAuth 2.0 PKCE or 3-legged OAuth

Quickstart

Create your first Post

Integration guide

Key concepts and best practices

Media upload

Upload media for Posts

API Reference

Full endpoint documentation