Contact DND Updated | Webhook Events

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

Field	Type	Description
`type`	`string`	Always `"ContactDndUpdate"`
`locationId`	`string`	Account ID where the contact’s DND settings 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
`dnd`	`boolean`	Whether Do Not Disturb is enabled globally for this contact
`dndSettings`	`object`	Per-channel DND configuration (see sub-fields below)
`dndSettings.SMS`	`object`	DND status for SMS with `status`, `message`, and `code`
`dndSettings.Email`	`object`	DND status for email with `status`, `message`, and `code`
`dndSettings.GMB`	`object`	DND status for Google My Business messaging with `status`, `message`, and `code`
`dndSettings.FB`	`object`	DND status for Facebook Messenger with `status`, `message`, and `code`
`dndSettings.WhatsApp`	`object`	DND status for WhatsApp with `status`, `message`, and `code`
`dndSettings.Call`	`object`	DND status for voice calls with `status`, `message`, and `code`
`tags`	`array`	List of tag strings applied to the contact
`assignedTo`	`string`	User ID of the team member assigned to this contact

Each channel object within dndSettings contains:

Sub-field	Type	Description
`status`	`string`	Either `"active"` (DND on, messages suppressed) or `"inactive"` (DND off, messages allowed)
`message`	`string`	Human-readable reason or note for the DND status
`code`	`string`	Internal 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"
    }
  ]
}

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

​Payload

​Example payload

​Related

Payload

Example payload

Related