POST collections/create

POST collections/create

Create a Collection owned by the currently authenticated user.

The API endpoint may refuse to complete the request if the authenticated user has exceeded the total number of allowed collections for their account.

Resource URL

Resource Information

Response formats JSON
Requires authentication? Yes (user context only)
Rate limited? Yes


Name Required Description Default Value Example
name required The title of the collection being created, in 25 characters or less. Sweet%20Tweets
description optional A brief description of this collection in 160 characters or fewer. My%20favorite%20tweets%20ever
url optional A fully-qualified URL to associate with this collection.
timeline_order optional Order Tweets chronologically or in the order they are added to a Collection. curation_reverse_chron - order added (default) tweet_chron - oldest first tweet_reverse_chron - most recent first tweet_reverse_chron

Example Request


Example Response

  "response": {
    "timeline_id": "custom-390882285743898624"
  "objects": {
    "users": {
      "119476949": {
        "profile_sidebar_fill_color": "DDEEF6",
        "profile_sidebar_border_color": "C0DEED",
        "profile_background_tile": true,
        "name": "OAuth Dancer",
        "profile_image_url": "",
        "created_at": "Wed Mar 03 19:37:35 +0000 2010",
        "location": "San Francisco, CA",
        "follow_request_sent": null,
        "profile_link_color": "0084B4",
        "is_translator": false,
        "id_str": "119476949",
        "default_profile": false,
        "contributors_enabled": false,
        "favourites_count": 0,
        "url": "",
        "profile_image_url_https": "",
        "utc_offset": null,
        "id": 119476949,
        "profile_use_background_image": true,
        "listed_count": 0,
        "profile_text_color": "333333",
        "lang": "en",
        "followers_count": 0,
        "protected": false,
        "notifications": null,
        "profile_background_image_url_https": "",
        "profile_background_color": "C0DEED",
        "verified": false,
        "geo_enabled": true,
        "time_zone": null,
        "description": "",
        "default_profile_image": false,
        "profile_background_image_url": "",
        "statuses_count": 0,
        "friends_count": 0,
        "following": null,
        "screen_name": "oauth_dancer",
        "counts": {
          "lists": {
            "owned": null,
            "subscribed": null
          "saved_searches": 0
    "timelines": {
      "custom-390882285743898624": {
        "name": "Tweets to reply to",
        "user_id": "119476949"