paymo.tasks.add

Add a task to an existing project.

Authentication

This method requires authentication by a user with admin privileges or by a user assigned to the project.

Note: This method requires an HTTP POST request.

Arguments

api_key (Required)
Your application key. See here for more details.
auth_token (Required)
Authentication token received upon login.
name (Required)
Name of the new task.
project_id (Required)
ID of the project the new task will be part of.
tasklist_id (Optional)
ID of the task list the new task will be part of. Use 0 to have the task assigned to the 'Default' task list. If not sent, it defaults to '0'.
description (Optional)
Description of the new task
billable (Optional)
1 if task is billable, 0 otherwise. It is used for invoicing.
price_per_hour (Optional)
Price per hour. It is used for invoicing.
due_date (Optional)
Due date for the task.
user_id (Optional)
ID of the user the new task will be assigned to.
If not sent, the task will be assigned to anyone.

Example Response

<?xml version="1.0" encoding="UTF-8"?> <response status="ok"> <task id="8301" /> </response>

Error Codes

101: Unknown API method
The requested method was not found.
102: Unknown response format
The requested response format was not found.
103: Invalid API Key
The API key passed was not valid.
104: Invalid auth token / Login failed
The login details or auth token passed were invalid.
105: Insufficient permissions
The user making the method call did not have the required permissions.
106: Service currently unavailable
The service is temporarily unavailable.
107: Too many requests for this API key
The application has reached the limit for number of API calls during a specific time period. Wait a bit and try again.
108: HTTP POST request expected
The method required that parameters are sent using an HTTP POST request.
208: Blank name
Name argument was blank.
203: Project not found
The project with given ID was not found.
222: Task list not found
The task list with given ID was not found.
227: A user assigned to the project expected
The user with given ID was not assigned to this project. You cannot assign the task to him.
228: Invalid due date
The due date was not a valid date value. Check date and time formats.