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.