---
title: "MessageHub Integrations: Supported Events by Webhooks"
slug: "messagehub-integrations-supported-events-by-webhooks"
updated: 2025-01-21T18:44:18Z
published: 2025-01-21T18:44:18Z
canonical: "support.myclickfunnels.com/messagehub-integrations-supported-events-by-webhooks"
---

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

# MessageHub Integrations: Supported Events by Webhooks

This article will review the **Supported Events** you can transfer via **Webhooks**. Webhooks are HTTP callbacks that can be defined for every account. **They are triggered by events** like message creation in MessageHub. You can connect more than one Webhook to your MessageHub account.

> [!WARNING]
> IMPORTANT
> 
> Please keep in mind that our support for Webhooks is limited. If you need additional assistance, please contact a professional developer.

---

## Requirements

- An active ClickFunnels account
- The [MessageHub](/v1/docs/getting-started-with-messagehub) App

---

## Objects

An event can contain any of the following objects as a payload. Different types of objects supported in MessageHub are as follows.

### `account`

The following payload will be returned for an account.

```plaintext
{
  "id": "integer",
  "name": "string"
}
```

### `inbox`

The following payload will be returned for an inbox.

```plaintext
{
  "id": "integer",
  "name": "string"
}
```

### `contact`

The following payload will be returned for a contact.

```plaintext
{
  "id": "integer",
  "name": "string",
  "avatar": "string",
  "type": "contact",
  "account": {
    // <...account Object Attributes>
  }
}
```

### `user`

The following payload will be returned for an agent/admin.

```plaintext
{
  "id": "integer",
  "name": "string",
  "email": "string",
  "type": "user"
}
```

### `conversation`

The following payload will be returned for a conversation.

```plaintext
{
  "additional_attributes": {
    "browser": {
      "device_name": "string",
      "browser_name": "string",
      "platform_name": "string",
      "browser_version": "string",
      "platform_version": "string"
    },
    "referer": "string",
    "initiated_at": {
      "timestamp": "iso-datetime"
    }
  },
  "can_reply": "boolean",
  "channel": "string",
  "id": "integer",
  "inbox_id": "integer",
  "contact_inbox": {
    "id": "integer",
    "contact_id": "integer",
    "inbox_id": "integer",
    "source_id": "string",
    "created_at": "datetime",
    "updated_at": "datetime",
    "hmac_verified": "boolean"
  },
  "messages": [
    // Array Of message Objects
  ],
  "meta": {
    "sender": {
      // contact Object Attributes
    },
    "assignee": {
      // user Object Attributes
    }
  },
  "status": "string",
  "unread_count": "integer",
  "agent_last_seen_at": "unix-timestamp",
  "contact_last_seen_at": "unix-timestamp",
  "timestamp": "unix-timestamp",
  "account_id": "integer"
}
```

### `message`

The following payload will be returned for a message.

```plaintext
{
  "id": "integer",
  "content": "string",
  "message_type": "integer",
  "created_at": "unix-timestamp",
  "private": "boolean",
  "source_id": "string / null",
  "content_type": "string",
  "content_attributes": "object",
  "sender": {
    "type": "string - contact/user"
    // user Or contact Object Attributes
  },
  "account": {
    // account Object Attributes
  },
  "conversation": {
    // conversation Object Attributes
  },
  "inbox": {
    // inbox Object Attributes
  }
}
```

### Example Webhook Payload

The following is an example of the final webhook payload that will be returned.

```plaintext
{
  "event": "event_name"
  // Attributes related to the event
}
```

---

## Events

MessageHub supports the following webhook events. You can subscribe to them while configuring a webhook in the dashboard or using the API.

> [!WARNING]
> IMPORTANT
> 
> Custom code is case sensitive. It is important to add it exactly as it is shown.

### `conversation_created`

This event will be triggered when a new conversation is created in the account. The payload for the event is as follows.

```plaintext
{
  "event": "conversation_created"
  // <...conversation Object Attributes>
}
```

### `conversation_updated`

This event will be triggered when there is a change in any of the attributes in the conversation.

```plaintext
{
  "event": "conversation_updated" ,
  "changed_attributes": [
    {
      "<attribute_name>": {
        "current_value": "",
        "previous_value": ""
      }
    }
  ]
  // <...conversation Object Attributes>
}
```

### `conversation_status_changed`

This event will be triggered when the status of the conversation is changed.

> [!NOTE]
> NOTE
> 
> If you are using agent bot APIs instead of webhooks, this event is not supported yet.

```plaintext
{
  "event": "conversation_status_changed"
  // <...conversation Object Attributes>
}
```

### `message_created`

This event will be triggered when a message is created in a conversation. The payload for the event is as follows.

```plaintext
{
  "event": "message_created"
  // <...message Object Attributes>
}
```

### `message_updated`

This event will be triggered when a message is updated in a conversation. The payload for the event is as follows.

```plaintext
{
  "event": "message_updated"
  // <...message Object Attributes>
}
```

### `webwidget_triggered`

This event will be triggered when the end user opens the live chat widget.

```plaintext
{
  "id": "integer",
  "contact": {
    // <...contact Object Attributes>
  },
  "inbox": {
    // <...inbox Object Attributes>
  },
  "account": {
    // <...account Object Attributes>
  },
  "current_conversation": {
    // <...conversation Object Attributes>
  },
  "source_id": "string",
  "event": "webwidget_triggered",
  "event_info": {
    "initiated_at": {
      "timestamp": "date-string"
    },
    "referer": "string",
    "widget_language": "string",
    "browser_language": "string",
    "browser": {
      "browser_name": "string",
      "browser_version": "string",
      "device_name": "string",
      "platform_name": "string",
      "platform_version": "string"
    }
  }
}
```