List Members

The List Members endpoints let you view List members, add members to your Lists, and remove. Reference for the X API v2 standard tier covering list members.

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