Manage Lists

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

Method	Endpoint	Description
POST	`/2/lists`	Create a new List
PUT	`/2/lists/:id`	Update a List
DELETE	`/2/lists/:id`	Delete 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

An approved developer account
A Project and App in the Developer Console
User Access Tokens via OAuth 2.0 PKCE

Quickstart

Create your first List

Integration guide

Key concepts and best practices

List members

Add and remove members

API Reference

Full endpoint documentation

​Overview