Skip to main content
Tasks in HoopAI are action items attached to a contact record. When a new task is created — whether manually by a team member or triggered by an automation — HoopAI sends a TaskCreate event to all configured webhook endpoints. Use this event to mirror tasks in external project management tools, assign follow-ups in a help desk, or trigger reminder workflows.

Payload

FieldTypeDescription
typestringAlways "TaskCreate"
locationIdstringSub-account ID the task belongs to
idstringUnique ID of the newly created task
titlestringShort display name of the task
bodystringFull description or details of the task
contactIdstringID of the contact this task is associated with
assignedTostringID of the user responsible for completing the task
dateAddedstringISO 8601 timestamp when the task was created
dueDatestringISO 8601 timestamp by which the task should be completed

Example payload

{
  "type": "TaskCreate",
  "locationId": "ve9EPM428h8vShlRW1KT",
  "id": "UlRWGLSXh0ji5qbiGu4i",
  "assignedTo": "63e4qiWDsFJjOYAC8phG",
  "body": "Loram ipsum",
  "contactId": "CWBf1PR9LvvBkcYqiXlc",
  "title": "Loram ipsum",
  "dateAdded": "2021-11-26T12:41:02.193Z",
  "dueDate": "2021-11-26T12:41:02.193Z"
}
Last modified on March 4, 2026