POST lists/members/create

Updated on Wed, 2012-09-05 12:36

Add a member to a list. The authenticated user must own the list to be able to add members to it. Note that lists can't have more than 500 members.

Resource URL

https://api.twitter.com/1.1/lists/members/create.json

Parameters

Either a list_id or a slug is required. If providing a list_slug, an owner_screen_name or owner_id is also required.

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 for. 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 for. 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

POST Data

slug=team&owner_screen_name=twitter&screen_name=kurrik