POST lists/create

POST lists/create

Creates a new list for the authenticated user. Note that you can create up to 1000 lists per account.

Resource URL

Resource Information

Response formats JSON
Requires authentication? Yes
Rate limited? Yes


Name Required Description Default Value Example
name required The name for the list. A list's name must start with a letter and can consist only of 25 or fewer letters, numbers, "-", or "_" characters.
mode optional Whether your list is public or private. Values can be public or private . If no mode is specified the list will be public.
description optional The description to give the list.

Example Request


Example Response

   "created_at":"Fri Nov 04 21:22:36 +0000 2011",
   "description":"For life",
      "created_at":"Thu Jul 19 15:58:07 +0000 2007",
      "name":"Arne Roomann-Kurrik",
      "description":"Developer Advocate at Twitter, practitioner of dark sandwich arts. ",
      "location":"Scan Francesco",
      "time_zone":"Pacific Time (US & Canada)",