Sales CRMTasks

Create a task

Create a new CRM task with the specified name, type, due date, and optional associations to contacts, companies, or deals. A task requires a name, task type ID, and due date at minimum. You can also set a duration, notes, a reminder, and assign the task to a specific user.

Authentication

api-keystring

The API key should be passed in the request headers as api-key for authentication.

Request

Task name.
datedatetimeRequired
Task due date and time
namestringRequired
Name of task
taskTypeIdstringRequired

Id for type of task e.g Call / Email / Meeting etc.

assignToIdstringOptional
To assign a task to a user you can use either the account email or ID.
companiesIdslist of stringsOptional
Companies ids for companies a task is linked to
contactsIdslist of integersOptional
Contact ids for contacts linked to this task
dealsIdslist of stringsOptional
Deal ids for deals a task is linked to
donebooleanOptional
Task marked as done
durationlongOptional>=0

Duration of task in milliseconds [1 minute = 60000 ms]

notesstringOptional
Notes added to a task
reminderobjectOptional

Task reminder date/time for a task

Response

Created new task
idstring
Unique task id

Errors

400
Bad Request Error