Contact Tag Updated | Webhook Events

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

{
  "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"
    }
  ]
}

Contact Updated — fires when any other contact field changes
Contacts API — query and update contacts programmatically

​Payload

​Example payload

​Related

Payload

Example payload

Related