Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.x.com/llms.txt

Use this file to discover all available pages before exploring further.

The Manage Lists endpoints let you create, update, and delete Lists on behalf of authenticated users.

​
Overview

Create

Create a new List

Update

Update List name and description

Delete

Delete a List

​
Endpoints

MethodEndpointDescription
POST/2/listsCreate a new List
PUT/2/lists/:idUpdate a List
DELETE/2/lists/:idDelete a List

​
Example: Create a List

curl -X POST "https://api.x.com/2/lists" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Tech News",
    "description": "My favorite tech journalists",
    "private": false
  }'

​
Example response

{
  "data": {
    "id": "1234567890",
    "name": "Tech News"
  }
}

​
Getting started

Prerequisites

Quickstart

Create your first List

Integration guide

Key concepts and best practices

List members

Add and remove members

API Reference

Full endpoint documentation