Services / API / Methods / rtm.tasks.add

Description

Adds a task, name, to the list specified by list_id.

If list_id is omitted, the task will be added to the Inbox.

If parse is 1, Smart Add will be used to process the task.

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.

list_id (Optional)

The id of the list to perform an action on.

name (Required)

The desired task name.

parse (Optional)

Specifies whether to process name using Smart Add.

Example Response

<list id="987654321">
  <taskseries id="987654321" created="2006-05-07T10:19:54Z" modified="2006-05-07T10:19:54Z"
             name="Get Bananas" source="api">
    <tags/>
    <participants/>
    <notes/>
    <task id="123456789" due="" has_due_time="0" added="2006-05-07T10:19:54Z"
         completed="" deleted="" priority="N" postponed="0" estimate=""/>
  </taskseries>
</list>

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.

320: list_id invalid or not provided

No list_id provided / list_id invalid.

4000: Task name provided is invalid.

The task name provided is invalid.