> ## Documentation Index
> Fetch the complete documentation index at: https://help.hoopai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Conversation Unread | Webhook Events

> Fires whenever a conversation's unread status is updated in the HoopAI platform.

The `ConversationUnread` event fires each time the unread state of a conversation changes — for example, when a new inbound message marks a conversation as unread, or when a user reads a conversation and the count returns to zero. Use it to drive notification badges, sync read/unread state to external helpdesk tools, or trigger follow-up workflows when conversations go unattended.

## Payload

| Field         | Type      | Description                                                                                     |
| ------------- | --------- | ----------------------------------------------------------------------------------------------- |
| `type`        | `string`  | Always `"ConversationUnreadWebhook"`                                                            |
| `locationId`  | `string`  | Account ID where the conversation lives                                                         |
| `id`          | `string`  | Unique identifier of the conversation                                                           |
| `contactId`   | `string`  | ID of the contact associated with the conversation                                              |
| `unreadCount` | `number`  | Current number of unread messages in the conversation; `0` means the conversation has been read |
| `inbox`       | `boolean` | Whether the conversation is currently in the inbox view                                         |
| `starred`     | `boolean` | Whether the conversation has been starred by a user                                             |
| `deleted`     | `boolean` | Whether the conversation has been deleted                                                       |

## Example payload

```json theme={null}
{
  "type": "ConversationUnreadWebhook",
  "locationId": "ve9EPM428h8vShlRW1KT",
  "id": "BqTwX8QFwXzpegMve9EQ",
  "contactId": "nmFmQEsNgz6AVpgLVUJ0",
  "unreadCount": 0,
  "inbox": false,
  "starred": true,
  "deleted": false
}
```

## Related

* [Inbound Message](/api-reference/webhooks/inbound-message) — fires when a contact sends a message, which typically increments the unread count
* [Outbound Message](/api-reference/webhooks/outbound-message) — fires when a user sends a message to a contact
* [Conversations API](/api-reference/conversations/overview) — query conversations and messages programmatically