Skip to navigation

Create a task

View as Markdown

Create a task. Set _type to lead for a task on a lead, or to outgoing_call for a task to call one of the lead’s contacts. Other types of tasks can’t be created. _type defaults to lead.

Close emails the assignee about a new incomplete task, unless they’re also its creator. Set disable_notification or date_created to skip the email. Returns 400 once the lead has more than 300 incomplete tasks.

Returns 403 if the lead is one you can’t see.

Authentication

AuthorizationBasic
Use your API key as the username and leave the password empty.
OR
AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Query parameters

_fieldsstringOptional

Comma-separated list of fields to include in the response.

Request

This endpoint expects an object.
leadobjectRequired
OR
outgoing_callobjectRequired

Response

Successful response

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
429
Too Many Requests Error