Skip to main content
The ContactDndUpdate event fires when a contact’s Do Not Disturb (DND) preferences are changed. DND controls which communication channels — such as SMS, email, calls, or social messaging — are suppressed for a contact. The payload includes both the global dnd flag and per-channel dndSettings, so you can react to granular opt-out changes across all channels.

​
Payload

FieldTypeDescription
typestringAlways "ContactDndUpdate"
locationIdstringSub-account ID where the contact’s DND settings 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
dndbooleanWhether Do Not Disturb is enabled globally for this contact
dndSettingsobjectPer-channel DND configuration (see sub-fields below)
dndSettings.SMSobjectDND status for SMS with status, message, and code
dndSettings.EmailobjectDND status for email with status, message, and code
dndSettings.GMBobjectDND status for Google My Business messaging with status, message, and code
dndSettings.FBobjectDND status for Facebook Messenger with status, message, and code
dndSettings.WhatsAppobjectDND status for WhatsApp with status, message, and code
dndSettings.CallobjectDND status for voice calls with status, message, and code
tagsarrayList of tag strings applied to the contact
assignedTostringUser ID of the team member assigned to this contact
Each channel object within dndSettings contains:
Sub-fieldTypeDescription
statusstringEither "active" (DND on, messages suppressed) or "inactive" (DND off, messages allowed)
messagestringHuman-readable reason or note for the DND status
codestringInternal code associated with the DND status change

​
Example payload

{
  "type": "ContactDndUpdate",
  "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,
  "dndSettings": {
    "SMS": { "status": "inactive", "message": "Some message", "code": "101" },
    "Call": { "status": "inactive", "message": "Some message", "code": "101" },
    "Email": { "status": "active", "message": "Some message", "code": "101" },
    "GMB": { "status": "active", "message": "Some message", "code": "101" },
    "FB": { "status": "active", "message": "Some message", "code": "101" },
    "WhatsApp": { "status": "active", "message": "Some message", "code": "101" }
  },
  "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