POST /2/lists

Enables the authenticated user to create a List.

Endpoint URL

Authentication and rate limits

Authentication methods
supported by this endpoint

OAuth 1.0a User context

Rate limit

User rate limit: 300 requests per 15-minute window

JSON body parameters

stringThe name of the List you wish to create.
stringDescription of the List.
booleanDetermine whether the List should be private.

Example requests

      curl -X POST "" -H "Authorization: OAuth $OAUTH_SIGNATURE" -H "Content-type: application/json" -d '{"name": "test v2 create list"}'

Example responses

  "data": {
    "id": "1441162269824405510",
    "name": "test v2 create list"

Response fields

idnumberThe id of the newly created List.
namestringThe name of the newly created List.
Was this document helpful?
Thank you

Thank you for the feedback. We’re really glad we could help!

Thank you for the feedback. How could we improve this document?
Thank you for the feedback. Your comments will help us improve our documents in the future.