List Members

View, add, and remove members from Lists

The List Members endpoints let you view List members, add members to your Lists, and remove them. You can also see which Lists a user is a member of.

Overview

View members

Get all members of a List

Add member

Add a user to your List

Remove member

Remove a user from your List

Memberships

See Lists a user is on

---

Endpoints

List members lookup

Method	Endpoint	Description
GET	/2/lists/:id/members	Get members of a List
GET	/2/users/:id/list_memberships	Get Lists a user is on

Manage List members

Method	Endpoint	Description
POST	/2/lists/:id/members	Add a member
DELETE	/2/lists/:id/members/:user_id	Remove a member

---

Example: Get List members

curl "https://api.x.com/2/lists/1234567890/members?\
user.fields=username,verified" \
  -H "Authorization: Bearer $BEARER_TOKEN"

Example: Add a member

curl -X POST "https://api.x.com/2/lists/1234567890/members" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"user_id": "9876543210"}'

---

Getting started

Prerequisites

• An approved developer account
• A Project and App in the Developer Console
• Your App’s keys and tokens

Lookup quickstart

Get members of a List

Manage quickstart

Add and remove members

Integration guide

Key concepts and best practices

API Reference

Full endpoint documentation