Write Actions

Create List

Create a List owned by your registered X session, with a name and an optional description and privacy flag. Populate it afterwards with Add List Member. Cost: $0.0016 per call.

post/list/create

Request

  • Base URL: https://api.twitterapis.com/twitter
  • URL: https://api.twitterapis.com/twitter/list/create
  • Auth: HTTP bearer

Request body

namestring required

Display name for the new List.

descriptionstring

Optional description shown on the List.

is_privateboolean

Whether the List is private. Private Lists are not readable by the public List read endpoints.

Example request

{
  "name": "Founders",
  "description": "People building in public."
}

Response

Create a new Twitter/X List owned by your session.

okboolean

True when the List was created.

listobject

The List object X returned, including its new numeric id.

Changes

No recorded changes to this operation across all 1 revision of this API.