Services / API / Methods / rtm.lists.add

Description

Creates a new list. If filter is provided, a Smart List is created with the criteria specified.

Authentication

This method requires authentication with write permissions.

Timeline

This method requires a timeline.

Arguments

api_key (Required)

Your API application key. See here for more details.

timeline (Required)

The timeline within which to run a method. See here for more details.

name (Required)

The desired list name. Cannot be Inbox or Sent.

filter (Optional)

If specified, a Smart List is created with the desired criteria. See here for more details.

Example Response

<list id="987654321" name="New List"
      deleted="0" locked="0" archived="0" position="0" smart="0"/>

Error Codes

98: Login failed / Invalid auth token

The login details or auth token passed were invalid.

100: Invalid API Key

The API key passed was not valid or has expired.

105: Service currently unavailable

The requested service is temporarily unavailable.

111: Format "xxx" not found

The requested response format was not found.

112: Method "xxx" not found

The requested method was not found.

114: Invalid SOAP envelope

The SOAP envelope sent in the request could not be parsed.

115: Invalid XML-RPC Method Call

The XML-RPC request document could not be parsed.

300: Timeline invalid or not provided

No timeline provided / Timeline invalid.

3000: List name provided is invalid.

The list name provided is invalid.