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

# Contact Tag Updated | Webhook Events

> Fires whenever tags are added to or removed from a contact in your HoopAI account.

The `ContactTagUpdate` event fires each time the tag list on a contact is modified — whether a tag is added, removed, or the list is replaced entirely. Tags are used to segment and categorize contacts, so this event is useful for triggering automations, syncing segments to external tools, or gating access to content based on a contact's current tags.

## Payload

| Field          | Type      | Description                                                   |
| -------------- | --------- | ------------------------------------------------------------- |
| `type`         | `string`  | Always `"ContactTagUpdate"`                                   |
| `locationId`   | `string`  | Account ID where the contact's tags were updated              |
| `id`           | `string`  | Unique identifier of the contact                              |
| `firstName`    | `string`  | Contact's first name                                          |
| `lastName`     | `string`  | Contact's last name                                           |
| `name`         | `string`  | Contact's full name                                           |
| `email`        | `string`  | Contact's email address                                       |
| `phone`        | `string`  | Contact's phone number in E.164 format                        |
| `address1`     | `string`  | Street address line 1                                         |
| `city`         | `string`  | City                                                          |
| `state`        | `string`  | State or province                                             |
| `postalCode`   | `string`  | Postal or ZIP code                                            |
| `country`      | `string`  | Country code (e.g., `"US"`, `"DE"`)                           |
| `companyName`  | `string`  | Name of the contact's company                                 |
| `website`      | `string`  | Contact's website URL                                         |
| `source`       | `string`  | Original source through which the contact was created         |
| `dateAdded`    | `string`  | ISO 8601 timestamp of when the contact was originally created |
| `dateOfBirth`  | `string`  | Contact's date of birth in ISO 8601 format                    |
| `dnd`          | `boolean` | Whether the contact has Do Not Disturb enabled globally       |
| `tags`         | `array`   | The full, current list of tag strings after the update        |
| `attachments`  | `array`   | List of file attachments associated with the contact          |
| `assignedTo`   | `string`  | User ID of the team member assigned to this contact           |
| `customFields` | `array`   | Array of custom field values with `id` and `value` properties |

## Example payload

```json theme={null}
{
  "type": "ContactTagUpdate",
  "locationId": "ve9EPM428h8vShlRW1KT",
  "id": "nmFmQEsNgz6AVpgLVUJ0",
  "address1": "3535 1st St N",
  "city": "ruDolomitebika",
  "state": "AL",
  "companyName": "Loram ipsum",
  "country": "DE",
  "source": "xyz form",
  "dateAdded": "2021-11-26T12:41:02.193Z",
  "dateOfBirth": "2000-01-05T00:00:00.000Z",
  "dnd": true,
  "email": "JohnDeo@gmail.com",
  "name": "John Deo",
  "firstName": "John",
  "lastName": "Deo",
  "phone": "+919509597501",
  "postalCode": "452001",
  "tags": ["id magna sed Lorem", "Duis dolor commodo aliqua"],
  "website": "https://www.google.com/",
  "attachments": [],
  "assignedTo": "nmFmQEsNgz6AVpgLVUJ0",
  "customFields": [
    {
      "id": "BcdmQEsNgz6AVpgLVUJ0",
      "value": "XYZ Corp"
    }
  ]
}
```

## Related

* [Contact Updated](/api-reference/webhooks/contact-update) — fires when any other contact field changes
* [Contacts API](/api-reference/contacts/overview) — query and update contacts programmatically