Create and manage lists
API Reference contents
GET lists/list
GET lists/members
GET lists/members/show
GET lists/memberships
GET lists/ownerships
GET lists/show
GET lists/statuses
GET lists/subscribers
GET lists/subscribers/show
GET lists/subscriptions
POST lists/create
POST lists/destroy
POST lists/members/create
POST lists/members/create_all
POST lists/members/destroy
POST lists/members/destroy_all
POST lists/subscribers/create
POST lists/subscribers/destroy
POST lists/update
POST lists/members/create¶
Add a member to a list. The authenticated user must own the list to be able to add members to it. Note that lists cannot have more than 5,000 members.
Resource URL¶
https://api.twitter.com/1.1/lists/members/create.json
Resource Information¶
Response formats | JSON |
Requires authentication? | Yes |
Rate limited? | Yes |
Parameters¶
Name | Required | Description | Default Value | Example |
list_id | required | The numerical id of the list. | ||
slug | required | You can identify a list by its slug instead of its numerical id. If you decide to do so, note that you’ll also have to specify the list owner using the owner_id or owner_screen_name parameters. | ||
user_id | required | The ID of the user for whom to return results. Helpful for disambiguating when a valid user ID is also a valid screen name. | ||
screen_name | required | The screen name of the user for whom to return results. Helpful for disambiguating when a valid screen name is also a user ID. | ||
owner_screen_name | optional | The screen name of the user who owns the list being requested by a slug. | ||
owner_id | optional | The user ID of the user who owns the list being requested by a slug. |
Example Request¶
POST https://api.twitter.com/1.1/lists/members/create.json?slug=team&owner_screen_name=twitter&screen_name=kurrik