Skip to main content
The ContactUpdate event fires each time one or more fields on an existing contact record are changed, whether through the HoopAI UI, an API call, or an automation. Use this event to keep external systems in sync, audit trail changes, or trigger downstream workflows when key fields like email or phone are updated.

​
Payload

FieldTypeDescription
typestringAlways "ContactUpdate"
locationIdstringSub-account ID where the contact was updated
idstringUnique identifier of the updated 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
tagsarrayCurrent list of tag strings applied to the contact
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": "ContactUpdate",
  "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": false,
  "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