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

# Lead Tagged

> Receive a webhook when a new lead is tagged by Apten.

## Lead Tagged

This event occurs when a new lead is tagged by Apten. The webhook payload contains
information about the lead that was tagged, including the lead's id, phone number, communication channel (`sms`, `email`, `call`, or `manual`), and the associated tag. The tag name will match up to the name you define in the UI.

### Payload

The following payload is sent when a lead is tagged:

```json theme={null}
{
  "event": "leadTagged",
  "data": {
    "leadId": "a7e92c5d-f301-4b89-ae16-8f35d02cx9z",
    "externalLeadId": "003XX000004DHPY",
    "phone": "+13305551234",
    "channel": "sms",
    "tag": "isQualified",
    "close_crm_leadId": "lead_xyz123"
  },
  "timestamp": "2024-02-18T09:45:22Z"
}
```

## Properties

| Property                | Type   | Description                                                                                    |
| ----------------------- | ------ | ---------------------------------------------------------------------------------------------- |
| `event`                 | string | The webhook event type (`leadTagged`).                                                         |
| `data.leadId`           | string | The unique identifier for the lead.                                                            |
| `data.externalLeadId`   | string | The CRM lead ID (Salesforce, HubSpot, or Close CRM).                                           |
| `data.phone`            | string | The phone number of the lead.                                                                  |
| `data.channel`          | string | The communication channel. Can be `sms`, `email`, `call`, or `manual`.                         |
| `data.tag`              | string | The tag applied to the lead. Matches the name defined in the UI.                               |
| `data.close_crm_leadId` | string | The Close CRM lead ID. Only included if the lead is associated with Close CRM via integration. |
| `timestamp`             | string | The ISO 8601 timestamp when the lead was tagged.                                               |

### Out-of-the-box Tags

By default, Apten sends events for a few tags out-of-the-box:

* hasReplied
* isHot
* isQualified