> ## 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.

# Outbound Message | Webhook Events

> Fires whenever a user sends a message to a contact in the HoopAI platform.

The `OutboundMessage` event fires each time a user sends a message to a contact across any supported channel. Use it to log sent communications, trigger follow-up automations, update delivery tracking systems, or sync message data to external CRM tools in real time.

## Supported channels

| Channel   | Description                 |
| --------- | --------------------------- |
| Call      | Outbound phone calls        |
| Voicemail | Voicemail drops             |
| SMS       | Text messages               |
| GMB       | Google My Business messages |
| FB        | Facebook Messenger          |
| IG        | Instagram Direct            |
| Email     | Email messages              |
| Live Chat | Live chat widget            |

## Key status indicators

Messages include a `status` field reflecting delivery state. Calls report both `status` and `callStatus` to distinguish between completed calls and those that reached a voicemail system. For emails, a `provider` field indicates which sending service was used.

## Payload

| Field            | Type     | Description                                                                                                 |
| ---------------- | -------- | ----------------------------------------------------------------------------------------------------------- |
| `type`           | `string` | Always `"OutboundMessage"`                                                                                  |
| `locationId`     | `string` | Account ID from which the message was sent                                                                  |
| `messageId`      | `string` | Unique identifier for the message                                                                           |
| `contactId`      | `string` | ID of the contact who received the message                                                                  |
| `conversationId` | `string` | ID of the conversation this message belongs to                                                              |
| `userId`         | `string` | ID of the user who sent the message                                                                         |
| `messageType`    | `string` | Channel the message was sent on. One of `SMS`, `Email`, `Call`, `Voicemail`, `FB`, `IG`, `GMB`, `Live Chat` |
| `direction`      | `string` | Always `"outbound"` for this event                                                                          |
| `body`           | `string` | Text content of the message                                                                                 |
| `contentType`    | `string` | MIME type of the message body (e.g. `text/plain`)                                                           |
| `attachments`    | `array`  | List of attachment URLs; empty array if none                                                                |
| `source`         | `string` | Origin of the outbound message (e.g. `workflow`, `manual`)                                                  |
| `status`         | `string` | Delivery status of the message (e.g. `delivered`, `completed`, `voicemail`)                                 |
| `dateAdded`      | `string` | ISO 8601 timestamp when the message was sent                                                                |
| `callDuration`   | `number` | Duration of the call in seconds (Call/Voicemail only)                                                       |
| `callStatus`     | `string` | Outcome of the call, e.g. `completed` or `voicemail` (Call/Voicemail only)                                  |
| `emailMessageId` | `string` | Provider message ID for email threading (Email only)                                                        |
| `threadId`       | `string` | Thread identifier for grouping email replies (Email only)                                                   |
| `provider`       | `string` | Email sending provider used, e.g. `leadconnector` (Email only)                                              |
| `subject`        | `string` | Email subject line (Email only)                                                                             |
| `to`             | `array`  | List of recipient email addresses (Email only)                                                              |
| `cc`             | `array`  | List of CC'd email addresses (Email only)                                                                   |
| `bcc`            | `array`  | List of BCC'd email addresses (Email only)                                                                  |

## Example payload

#### SMS

```json theme={null}
{
  "type": "OutboundMessage",
  "locationId": "ve9EPM428h8vShlRW1KT",
  "messageId": "ABCDEFabcdef123456",
  "attachments": [],
  "body": "Hi, following up on your inquiry",
  "contactId": "nmFmQEsNgz6AVpgLVUJ0",
  "contentType": "text/plain",
  "conversationId": "BqTwX8QFwXzpegMve9EQ",
  "dateAdded": "2021-11-26T12:41:02.193Z",
  "direction": "outbound",
  "messageType": "SMS",
  "status": "delivered",
  "userId": "YlWd2wuCAZQzh2cH1fVZ"
}
```

#### Email

```json theme={null}
{
  "type": "OutboundMessage",
  "locationId": "ve9EPM428h8vShlRW1KT",
  "messageId": "ABCDEFabcdef123456",
  "emailMessageId": "CAHZKpXk6sXE@mail.gmail.com",
  "threadId": "CAHZKpXk6sXE",
  "provider": "leadconnector",
  "to": ["contact@example.com"],
  "cc": [],
  "bcc": [],
  "subject": "Following up on your inquiry",
  "contactId": "nmFmQEsNgz6AVpgLVUJ0",
  "conversationId": "BqTwX8QFwXzpegMve9EQ",
  "dateAdded": "2021-11-26T12:41:02.193Z",
  "direction": "outbound",
  "messageType": "Email",
  "status": "delivered",
  "userId": "YlWd2wuCAZQzh2cH1fVZ"
}
```

## Related

* [Inbound Message](/api-reference/webhooks/inbound-message) — fires when a contact sends a message to a user
* [Conversations API](/api-reference/conversations/overview) — query conversations and messages programmatically