rtm.lists.add
Description
Creates a new list. If filter is provided, a Smart List is created with the criteria specified.
Availability
Available in versions 1 and 2.
Authentication
This method requires authentication with write permissions.
Timeline
This method requires a timeline.
Arguments
api_key(Required) 1 2- Your API application key. See here for more details.
timeline(Required) 1 2- The timeline within which to run a method. See here for more details.
name(Required) 1 2- The desired list name. Cannot be
InboxorSent. filter1 2- 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
96 Invalid signature- The passed signature was invalid.
97 Missing signature- The call required signing but no signature was sent.
98 Login failed / Invalid auth token- The login details or auth token passed were invalid.
99 User not logged in / Insufficient permissions- The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions.
100 Invalid API Key- The API key passed was not valid or has expired.
105 Service currently unavailable- The requested service is temporarily unavailable.
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.
120 Method not valid for requested version- The requested method is not compatible with the requested version.
300 Timeline invalid or not provided- No timeline provided / Timeline invalid.
3000 List name provided is invalid.- The list name provided is invalid.