# X (Formerly Twitter) Integration via LowCodeAPI

**Last Updated**: February 10, 2026

## Overview
Social media platform

**Categories:**
- {'id': 'social-media', 'name': 'Social Media'}

## Base Endpoint
https://api.lowcodeapi.com/x-twitter

**Important**: Always include the provider name in the URL path after `api.lowcodeapi.com/`

## Authentication
**Type:** OAUTH2.0

**Official Documentation:** https://developer.x.com/en/docs/x-api

## URL Format (Important)

LowCodeAPI supports two URL formats. **Always try the New Format first**, then fall back to Old Format if needed.

### New Format (Priority)
- Path parameters stay in the URL path
- Do NOT include path parameters as query parameters
- Example: `https://api.lowcodeapi.com/{provider}/resource/{id}?api_token=XXX`

### Old Format (Fallback)
- Path parameters become query parameters
- Example: `https://api.lowcodeapi.com/{provider}/resource/id?id={id}&api_token=XXX`

### Decision Flow for AI Agents
1. Always use **New Format** first - keep path parameters in the URL path
2. If you get a 404 or error, try **Old Format** with sanitized path
3. Log which format worked for future requests to this provider

## API Categories

## Common Endpoints

### Returns the data associated with the given tweet id.

**Method:** GET
**LowCodeAPI Path:** /2/tweets/:id

**New Format URL:**
https://api.lowcodeapi.com/x-twitter/2/tweets/:id?api_token=YOUR_API_TOKEN

**Old Format URL:**
https://api.lowcodeapi.com/x-twitter/2/tweets/id?api_token=YOUR_API_TOKEN

**Query Parameters:**

| Parameter | Type | Description |
|-----------|------|-------------|
| expansions | array |  |
| id | string |  |
| media.fields | array |  |
| place.fields | array |  |
| poll.fields | array |  |
| tweet.fields | array |  |
| user.fields | array |  |

**Example Request (New Format):**

```bash
curl -X GET 'https://api.lowcodeapi.com/x-twitter/2/tweets/:id?api_token=YOUR_API_TOKEN'
```

**Official Documentation:** https://developer.twitter.com/en/docs/twitter-api/tweets/lookup/api-reference/get-tweets-id

### Returns a single List by ID.

**Method:** GET
**LowCodeAPI Path:** /2/lists/:id

**New Format URL:**
https://api.lowcodeapi.com/x-twitter/2/lists/:id?api_token=YOUR_API_TOKEN

**Old Format URL:**
https://api.lowcodeapi.com/x-twitter/2/lists/id?api_token=YOUR_API_TOKEN

**Query Parameters:**

| Parameter | Type | Description |
|-----------|------|-------------|
| expansions | array |  |
| list.fields | array |  |
| list_id | string |  |
| user.fields | array |  |

**Example Request (New Format):**

```bash
curl -X GET 'https://api.lowcodeapi.com/x-twitter/2/lists/:id?api_token=YOUR_API_TOKEN'
```

**Official Documentation:** https://developer.twitter.com/en/docs/twitter-api/lists/list-lookup/api-reference/get-lists-id

### Delete a List owned by the authenticated user.

**Method:** DELETE
**LowCodeAPI Path:** /2/lists/:id

**New Format URL:**
https://api.lowcodeapi.com/x-twitter/2/lists/:id?api_token=YOUR_API_TOKEN

**Old Format URL:**
https://api.lowcodeapi.com/x-twitter/2/lists/id?api_token=YOUR_API_TOKEN

**Request Body:**

| Field | Type | Description |
|-------|------|-------------|
| list_id | string |  |

**Example Request (New Format):**

```bash
curl -X DELETE 'https://api.lowcodeapi.com/x-twitter/2/lists/:id?api_token=YOUR_API_TOKEN'
```

**Official Documentation:** https://developer.twitter.com/en/docs/twitter-api/lists/manage-lists/api-reference/delete-lists-id

### Update a List owned by the authenticated user.

**Method:** PUT
**LowCodeAPI Path:** /2/lists/:id

**New Format URL:**
https://api.lowcodeapi.com/x-twitter/2/lists/:id?api_token=YOUR_API_TOKEN

**Old Format URL:**
https://api.lowcodeapi.com/x-twitter/2/lists/id?api_token=YOUR_API_TOKEN

**Request Body:**

| Field | Type | Description |
|-------|------|-------------|
| description | string |  |
| list_id | string |  |
| name | string |  |
| private | boolean |  |

**Example Request (New Format):**

```bash
curl -X PUT 'https://api.lowcodeapi.com/x-twitter/2/lists/:id?api_token=YOUR_API_TOKEN'
```

**Official Documentation:** https://developer.twitter.com/en/docs/twitter-api/lists/manage-lists/api-reference/put-lists-id

### Returns the members of a List.

**Method:** GET
**LowCodeAPI Path:** /2/lists/:id/members

**New Format URL:**
https://api.lowcodeapi.com/x-twitter/2/lists/:id/members?api_token=YOUR_API_TOKEN

**Old Format URL:**
https://api.lowcodeapi.com/x-twitter/2/lists/id/members?api_token=YOUR_API_TOKEN

**Query Parameters:**

| Parameter | Type | Description |
|-----------|------|-------------|
| expansions | array |  |
| list_id | string |  |
| max_results | number |  |
| pagination_token | string |  |
| tweet.fields | array |  |
| user.fields | array |  |

**Example Request (New Format):**

```bash
curl -X GET 'https://api.lowcodeapi.com/x-twitter/2/lists/:id/members?api_token=YOUR_API_TOKEN'
```

**Official Documentation:** https://developer.twitter.com/en/docs/twitter-api/lists/list-members/api-reference/get-lists-id-members

### Add a member to a List.

**Method:** POST
**LowCodeAPI Path:** /2/lists/:id/members

**New Format URL:**
https://api.lowcodeapi.com/x-twitter/2/lists/:id/members?api_token=YOUR_API_TOKEN

**Old Format URL:**
https://api.lowcodeapi.com/x-twitter/2/lists/id/members?api_token=YOUR_API_TOKEN

**Request Body:**

| Field | Type | Description |
|-------|------|-------------|
| list_id | string |  |
| user_id | string |  |

**Example Request (New Format):**

```bash
curl -X POST 'https://api.lowcodeapi.com/x-twitter/2/lists/:id/members?api_token=YOUR_API_TOKEN'
```

**Official Documentation:** https://developer.twitter.com/en/docs/twitter-api/lists/list-members/api-reference/post-lists-id-members

### Returns Tweets from the specified List.

**Method:** GET
**LowCodeAPI Path:** /2/lists/:id/tweets

**New Format URL:**
https://api.lowcodeapi.com/x-twitter/2/lists/:id/tweets?api_token=YOUR_API_TOKEN

**Old Format URL:**
https://api.lowcodeapi.com/x-twitter/2/lists/id/tweets?api_token=YOUR_API_TOKEN

**Query Parameters:**

| Parameter | Type | Description |
|-----------|------|-------------|
| expansions | array |  |
| list_id | string |  |
| max_results | number |  |
| pagination_token | string |  |
| tweet.fields | array |  |
| user.fields | array |  |

**Example Request (New Format):**

```bash
curl -X GET 'https://api.lowcodeapi.com/x-twitter/2/lists/:id/tweets?api_token=YOUR_API_TOKEN'
```

**Official Documentation:** https://developer.twitter.com/en/docs/twitter-api/lists/list-tweets/api-reference/get-lists-id-tweets

### Returns users who are following the specified List.

**Method:** GET
**LowCodeAPI Path:** /2/lists/:id/followers

**New Format URL:**
https://api.lowcodeapi.com/x-twitter/2/lists/:id/followers?api_token=YOUR_API_TOKEN

**Old Format URL:**
https://api.lowcodeapi.com/x-twitter/2/lists/id/followers?api_token=YOUR_API_TOKEN

**Query Parameters:**

| Parameter | Type | Description |
|-----------|------|-------------|
| expansions | string |  |
| list_id | string |  |
| max_results | number |  |
| pagination_token | string |  |
| tweet.fields | array |  |
| user.fields | array |  |

**Example Request (New Format):**

```bash
curl -X GET 'https://api.lowcodeapi.com/x-twitter/2/lists/:id/followers?api_token=YOUR_API_TOKEN'
```

**Official Documentation:** https://developer.twitter.com/en/docs/twitter-api/lists/list-follows/api-reference/get-lists-id-followers

### Create a new List.

**Method:** POST
**LowCodeAPI Path:** /2/lists

**New Format URL:**
https://api.lowcodeapi.com/x-twitter/2/lists?api_token=YOUR_API_TOKEN

**Old Format URL:**
https://api.lowcodeapi.com/x-twitter/2/lists?api_token=YOUR_API_TOKEN

**Request Body:**

| Field | Type | Description |
|-------|------|-------------|
| description | string |  |
| name | string |  |
| private | boolean |  |

**Example Request (New Format):**

```bash
curl -X POST 'https://api.lowcodeapi.com/x-twitter/2/lists?api_token=YOUR_API_TOKEN'
```

**Official Documentation:** https://developer.twitter.com/en/docs/twitter-api/lists/manage-lists/api-reference/post-lists

### Remove a member from a List.

**Method:** DELETE
**LowCodeAPI Path:** /2/lists/:id/members/:user_id

**New Format URL:**
https://api.lowcodeapi.com/x-twitter/2/lists/:id/members/:user_id?api_token=YOUR_API_TOKEN

**Old Format URL:**
https://api.lowcodeapi.com/x-twitter/2/lists/id/members/user_id?api_token=YOUR_API_TOKEN

**Request Body:**

| Field | Type | Description |
|-------|------|-------------|
| list_id | string |  |
| user_id | string |  |

**Example Request (New Format):**

```bash
curl -X DELETE 'https://api.lowcodeapi.com/x-twitter/2/lists/:id/members/:user_id?api_token=YOUR_API_TOKEN'
```

**Official Documentation:** https://developer.twitter.com/en/docs/twitter-api/lists/list-members/api-reference/delete-lists-id-members-user_id


## Usage Examples

### Example 1: Get User Profile

```bash
# Get current user information
curl -X GET "https://api.lowcodeapi.com/xtwitter/user?api_token=YOUR_API_TOKEN"
```

### Example 2: List Messages or Posts

```bash
# Get list of messages/posts
curl -X GET "https://api.lowcodeapi.com/xtwitter/messages?api_token=YOUR_API_TOKEN"
```

### Example 3: Send Message or Create Post

```bash
# Send a message
curl -X POST "https://api.lowcodeapi.com/xtwitter/chat.postMessage?api_token=YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "channel": "CHANNEL_ID",
    "text": "Hello from X (Formerly Twitter)!"
  }'
```

## Error Handling

LowCodeAPI returns standard HTTP status codes. Common errors:

| Status Code | Description |
|-------------|-------------|
| 200 | Success - Request completed successfully |
| 400 | Bad Request - Invalid parameters or request body |
| 401 | Unauthorized - Invalid or missing API token |
| 403 | Forbidden - Insufficient permissions |
| 404 | Not Found - Endpoint or resource doesn't exist |
| 429 | Too Many Requests - Rate limit exceeded |
| 500 | Server Error - Provider API error |

All error responses include error details:

```json
{
  "data": {
    "error": {
      "message": "Error description",
      "code": "ERROR_CODE"
    }
  }
}
```

## Complete Endpoint Reference

| Endpoint | Method | Category |
|----------|--------|----------|
| Returns the data associated with the given tweet i... | GET | Tweets |
| Returns a single List by ID. | GET | Lists |
| Delete a List owned by the authenticated user. | DELETE | Lists |
| Update a List owned by the authenticated user. | PUT | Lists |
| Returns the members of a List. | GET | Lists |
| Add a member to a List. | POST | Lists |
| Returns Tweets from the specified List. | GET | Lists |
| Returns users who are following the specified List... | GET | Lists |
| Create a new List. | POST | Lists |
| Remove a member from a List. | DELETE | Lists |
| Delete a Tweet by ID. | DELETE | Tweets |
| Returns the data associated with the given list of... | GET | Tweets |
| Tweet on behalf of the authenticated user. | POST | Tweets |
| Returns users who have retweeted the specified Twe... | GET | Tweets |
| Search and retrieve Tweets from the last 7 days. | GET | Tweets |
| Returns the users who liked the the given tweet. | GET | Tweets |
| Hide or unhide replies to a Tweet. | PUT | Tweets |
| Retweet on behalf of the authenticated user, requi... | POST | Users |
| Unretweet a Tweet on behalf of the authenticated u... | DELETE | Users |
| Returns the tweets by a give `userid`. By default ... | GET | Users |
| Returns Tweets mentioning the specified user. | GET | Users |
| Returns Tweets from the user's home timeline in re... | GET | Users |
| Returns the list of tweet like by the user. Respon... | GET | Users |
| Returns information about an authorized user. | GET | Users |
| Returns the list of user details of specified `use... | GET | Users |
| Returns a variety of information about a single us... | GET | Users |
| Returns a variety of information about a single us... | GET | Users |
| Returns a variety of information about one or more... | GET | Users |
| Returns a list of Twitter users who are following ... | GET | Users |
| Returns users the specified user is following. | GET | Users |
| Follow a user on behalf of the authenticated user. | POST | Users |
| Returns Tweets that the specified user has bookmar... | GET | Users |
| Bookmark a Tweet on behalf of the authenticated us... | POST | Users |
| Like a Tweet on behalf of the authenticated user. | POST | Users |
| Unlike a Tweet on behalf of the authenticated user... | DELETE | Users |
| Unfollow a user on behalf of the authenticated use... | DELETE | Users |
| Mute a user on behalf of the authenticated user. | POST | Users |
| Returns users the specified user has muted. | GET | Users |
| Unmute a user on behalf of the authenticated user. | DELETE | Users |
| Block a user on behalf of the authenticated user. | POST | Users |
| Returns users the specified user has blocked. | GET | Users |
| Unblock a user on behalf of the authenticated user... | DELETE | Users |
| Remove a bookmark from a Tweet on behalf of the au... | DELETE | Users |
| Returns Lists owned by the specified user. | GET | Users |
| Returns Lists the specified user is a member of. | GET | Users |
| Pin a List on behalf of the authenticated user. | POST | Users |
| Returns Lists pinned by the specified user. | GET | Users |
| Unpin a List on behalf of the authenticated user. | DELETE | Users |
| Follow a List on behalf of the authenticated user. | POST | Users |
| Unfollow a List on behalf of the authenticated use... | DELETE | Users |
| Streams tweets in real-time based on a set of filt... | GET | Tweets |
| Retrieve the list of rules currently active on the... | GET | Tweets |
| Add or delete rules for the filtered stream. | POST | Tweets |
| Delete one or more rules from the filtered stream ... | DELETE | Tweets |
| Search all public tweets from the full archive of ... | GET | Tweets |
| Retrieve details about multiple Spaces by their ID... | GET | Spaces |
| Retrieve details about a single Space by its ID. | GET | Spaces |
| Retrieve Spaces created by the specified user IDs. | GET | Spaces |
| Search for Spaces matching your query criteria. | GET | Spaces |
| Retrieve compliance jobs. | GET | Compliance |
| Create a new compliance job for downloading Twitte... | POST | Compliance |
| Retrieve a single compliance job by its ID. | GET | Compliance |
| Returns Quote Tweets for a Tweet specified by the ... | GET | Tweets |
| Returns Lists the specified user follows. | GET | Users |

## API Definition Endpoints

You can fetch the complete API specification for this provider:

**New Format (OpenAPI spec):**
```bash
curl 'https://backend.lowcodeapi.com/x-twitter/openapi'
```

**Old Format (API definition):**
```bash
curl 'https://backend.lowcodeapi.com/x-twitter/definition'
```

## Response Format

All responses are wrapped in a `data` key:

```json
{
  "data": {
    // Actual response from provider (object or array)
  }
}
```