Manage List Members

Add and remove members from a List

This guide walks you through adding and removing members from a List.

Prerequisites

Before you begin, you’ll need:

• A developer account with an approved App
• User Access Token (OAuth 1.0a or OAuth 2.0 PKCE)
• A List that you own

---

Add a member to a List

1. Get the List ID and user ID

   You need the ID of your List and the user ID of the person you want to add. Find user IDs using the user lookup endpoint.

2. Add the member

   cURL

   shellscript

   curl -X POST "https://api.x.com/2/lists/1441162269824405510/members" \
     -H "Authorization: Bearer $USER_ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{"user_id": "2244994945"}'
   
3. Review the response

   {
     "data": {
       "is_member": true
     }
   }
   

---

Remove a member from a List

cURL

shellscript

curl -X DELETE "https://api.x.com/2/lists/1441162269824405510/members/2244994945" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN"

Response:

{
  "data": {
    "is_member": false
  }
}

---

Important notes

• You can only manage members of Lists you own
• Adding a user to a List does not require their permission
• Users can see which public Lists they’ve been added to

---

Next steps

List members lookup

Get List members

Manage Lists

Create and update Lists

API Reference

Full endpoint documentation