<< Back to Twitter API Documentation
Twitter REST API Method: POST /:user/lists
Creates a new list for the authenticated user. Accounts are limited to 20 lists.
URL:
http://api.twitter.com/1/user/lists.format
Formats:
xml, json
HTTP Method(s):
POST
Requires Authentication (about authentication):
true
API rate limited (about rate limiting):
false
Parameters:
- name. Required. The name of the list you are creating.
- mode. Optional. Whether your list is public or private. Values can be public or private. Lists are public by default if no mode is specified.
- description. Optional. The description of the list you are creating.
Usage examples:
cURL (about cURL):
curl -u user:password -d "name=doctors" http://api.twitter.com/1/twitterapidocs/lists.xml
Response (about return values):
XML example:
<?xml version="1.0" encoding="UTF-8"?>
<list>
<id>2025372</id>
<name>doctors</name>
<full_name>@twitterapidocs/doctors</full_name>
<slug>doctors</slug>
<description></description>
<subscriber_count>0</subscriber_count>
<member_count>0</member_count>
<uri>/twitterapidocs/doctors</uri>
<mode>public</mode>
<user>
<id>86621024</id>
<name>API Documentation</name>
<screen_name>twitterapidocs</screen_name>
<location></location>
<description>The @twitterapi team uses me to generate API documentation.</description>
<profile_image_url>http://s.twimg.com/a/1257288876/images/default_profile_0_normal.png</profile_image_url>
<url></url>
<protected>false</protected>
<followers_count>0</followers_count>
<profile_background_color>9ae4e8</profile_background_color>
<profile_text_color>000000</profile_text_color>
<profile_link_color>0000ff</profile_link_color>
<profile_sidebar_fill_color>e0ff92</profile_sidebar_fill_color>
<profile_sidebar_border_color>87bc44</profile_sidebar_border_color>
<friends_count>0</friends_count>
<created_at>Sat Oct 31 23:21:40 +0000 2009</created_at>
<favourites_count>0</favourites_count>
<utc_offset></utc_offset>
<time_zone></time_zone>
<profile_background_image_url>http://s.twimg.com/a/1257288876/images/themes/theme1/bg.png</profile_background_image_url>
<profile_background_tile>false</profile_background_tile>
<statuses_count>0</statuses_count>
<notifications>false</notifications>
<geo_enabled>false</geo_enabled>
<verified>false</verified>
<following>false</following>
</user>
</list>
Comments (0)
You don't have permission to comment on this page.