v7
latestOpenAPI 3.1.02026-08-0776170186.5 KBtasks
Create Todo Task
Create a standalone to-do task.
Requires the tasks:write scope on the API key.
post/v1/tasks
Request body
titlestring required
Task title.
notesstring nullable
Optional notes.
contact_idstring uuid nullable
Contact to link the task to.
due_datestring date required
Due date.
assignee_user_idstring uuid nullable
User to assign the task to. Defaults to the API key owner.
Response
Successful Response
idstring uuid required
Unique identifier.
organization_idstring uuid required
Workspace this task belongs to.
type'EMAIL_REPLY' | 'LINKEDIN_REPLY' | 'NEW_LEAD_REVIEW' | 'CALL' | 'PLAYBOOK_APPROVAL' | 'TODO' required
priority'HOT' | 'TODAY' | 'EXTRA' required
status'PENDING' | 'IN_PROGRESS' | 'COMPLETED' | 'SKIPPED' required
titlestring nullable
Task title for standalone tasks.
due_datestring date nullable
Due date for standalone tasks.
sequence_idstring uuid nullable required
Sequence run this task was projected from, if any.
assignee_user_idstring uuid nullable required
User the task is assigned to, if any.
disposition'ANSWERED' | 'VOICEMAIL_LEFT' | 'NO_ANSWER' | 'INTERESTED' | 'NOT_INTERESTED' required
reopened_atstring date-time nullable required
When the task was last reopened, if ever.
reopen_reason'REMINDER_RULE' required
skipped_atstring date-time nullable required
When the task was skipped, if applicable.
completed_atstring date-time nullable required
When the task was completed, if applicable.
created_atstring date-time required
When the task was created.
updated_atstring date-time required
When the task last changed.