Create Post

POST/tw-v2/interaction/create-post

Description

Post a new tweet to Twitter/X. Supports text content up to 280 characters for non-premium users, or 25,000 characters for premium users.

Request Body

ParameterTypeRequiredDescription
authTokenstringrequiredTwitter authentication token (auth_token cookie value)
textstringrequiredThe text content of the tweet (max 280 characters for non-premium, 25,000 for premium)
proxystringrequiredProxy in format 'hostname:port@username:password' (required for better success rates)
disableLinkPreviewbooleanoptionalWhen true, disables link preview cards for tweets containing URLs (defaults to false)

Code Examples

const body = {
  authToken: 'YOUR_AUTH_TOKEN',
  text: 'Hello, world!'
};

const response = await fetch('https://api.tweetapi.com/tw-v2/interaction/create-post', {
  method: 'POST',
  headers: {
    'X-API-Key': 'YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify(body)
});

const data = await response.json();
console.log(data);

Response

Success Response (200 OK)

200
{
  "data": {
    "id": "1973678938863058994",
    "action": "create_tweet",
    "timestamp": "2025-10-02T09:18:23.079Z",
    "success": true,
    "metadata": {
      "tweet_id": "1973678938863058994",
      "author_username": "username",
      "text": "Testing V3 API interaction endpoints - 1759396702",
      "created_at": "Thu Oct 02 09:18:22 +0000 2025",
      "url": "https://twitter.com/username/status/1973678938863058994"
    }
  }
}

API Playground

POST/tw-v2/interaction/create-post

Sensitive Credentials Required

Requires your Twitter authToken. Use a test account.

Press ⌘ + Enter to execute

curl -X POST "https://api.tweetapi.com/tw-v2/interaction/create-post" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json"
Response

Click "Try It!" to see the response