Tasks

Create Task

Create a task on a contact.

post/contacts/{contact_id}/tasks

Request

  • Base URL: https://be.graph8.com/api/v1
  • URL: https://be.graph8.com/api/v1/contacts/{contact_id}/tasks
  • Auth: HTTP bearer

Path parameters

contact_idinteger required

Contact ID

Headers

Authorizationstring nullable
X-Target-Org-Idstring nullable

Request body

tagsstring[] nullable
task_typestring nullable

Activity type, such as call or meeting

entity_typestring nullable
entity_idstring nullable
recordsobject[] nullable

Optional related records: contact, company, deal, lead, application, team_member, or campaign (Studio). An empty list leaves the task standalone.

source_urlstring nullable
titlestring required

Task title

descriptionstring nullable

Task description

due_datestring nullable

Due date (ISO 8601)

assignee_idstring nullable

User ID to assign the task to

priorityinteger nullable

Priority (0=none, 1=high, 2=medium, 3=low; historical 4=low is preserved)

parent_task_idstring nullable

Parent task UUID. When set, this task is inserted as a subtask of the parent. Subtasks cannot themselves have subtasks (one level deep).

subtask_sort_orderinteger nullable

Sort position within the parent's subtasks. When omitted on a subtask create, the handler appends to the end.

Response

Successful Response

Changes

No recorded changes to this operation across all 2 revisions of this API.