Skip to main content
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

FieldTypeDescription
typestringAlways "ContactTagUpdate"
locationIdstringSub-account ID where the contact’s tags were updated
idstringUnique identifier of the contact
firstNamestringContact’s first name
lastNamestringContact’s last name
namestringContact’s full name
emailstringContact’s email address
phonestringContact’s phone number in E.164 format
address1stringStreet address line 1
citystringCity
statestringState or province
postalCodestringPostal or ZIP code
countrystringCountry code (e.g., "US", "DE")
companyNamestringName of the contact’s company
websitestringContact’s website URL
sourcestringOriginal source through which the contact was created
dateAddedstringISO 8601 timestamp of when the contact was originally created
dateOfBirthstringContact’s date of birth in ISO 8601 format
dndbooleanWhether the contact has Do Not Disturb enabled globally
tagsarrayThe full, current list of tag strings after the update
attachmentsarrayList of file attachments associated with the contact
assignedTostringUser ID of the team member assigned to this contact
customFieldsarrayArray 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"
    }
  ]
}
Last modified on March 4, 2026