---
title: "Task Event Webhook"
method: POST
path: "task_event"
---

# Task Event Webhook

`POST task_event` (webhook)

Whenever a task is created or closed (resolved), we will post it back to your registered webhook.

Webhooks can be registered at the organization level or the property level.
Please reach out to the EliseAI support team to register your webhooks.

Creation events will include: 
* task_id (str): Elise identifier for the task
* type (str): one of "TaskCreated", "TaskClosed"
* task_type (str): describes the type of task that needs to be done such as "ReplyNeeded"
* event_date (datetime): date and time of the event
* elise_prospect_id (str): Elise identifier for the prospect
* elise_conversation_id (str): Elise identifier for the conversation
* elise_property_id (str): Elise identifier for the property
* task_data (dict): additional data about the task (if applicable)

Resolutions will _additionally_ include:
* resolution_type (str): describes how the task was resolved
* resolution_user_id (str): Elise identifier for the user who resolved the task
* resolution_user_email (str): email of the user who resolved the task
* resolution_user_name (str): name of the user who resolved the task

## Payload

- TaskWebhookEvent
  - `task_id` string, required
  - `type` 'TaskCreated' | 'TaskClosed', required — An enumeration.
  - `task_type` string, required
  - `event_date` string, date-time, required
  - `elise_prospect_id` string
  - `elise_conversation_id` string
  - `elise_property_id` string, required
  - `elise_resident_id` string
  - `external_prospect_id` string
  - `external_property_id` string
  - `external_resident_id` string
  - `external_lease_id` string
  - `partner_application_id` string
  - `conversation_link` string
  - `resolution_type` string
  - `resolution_user_id` string
  - `resolution_user_email` string
  - `resolution_user_name` string
  - `domain` string
  - `task_data` TaskEventData

## Acknowledgement `200`

Successful Response

- unknown

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/eliseai/apis/elise-api.md) · [All operations](https://skmtc.net/eliseai/apis/elise-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/eliseai/elise-api/versions/c3e8edfc04a2/schema)