Contact Directories

Contact Directories Overview #

The Contact Directories resource provides the ability to query and manage directory items on your account.

/{VERSION}/contactdirectories

Available Interfaces #

Interface Description
Get All Returns a collection of configured directories.
Get Directory Returns the details of a specific directory.
Directory Items Endpoints for interacting with directory items using a ~.Dimensions.~ item id.
Directory CRM Items Endpoints for interacting with directory items using a CRMId field.

Directory Schema #

Key Description Type
id Unique identifier for referencing this directory GUID
name User friendly name for the directory string
description Description of the directory's use/contents string
fields List of fields available within the directory string[]

Directory Item Schema #

Each entry in the billing data provides the parameters listed below.

Key Description Type
id a unique id for the contact record within ~.Dimensions.~ GUID
title Contact title (Mr, Mrs, Dr etc.) string
fullName Full name for the contact. This is used in reports and ~.UcClient.~ clients to help users identify callers. string
companyName The name of the company the contact works for. string
jobTitle The contact position with the company. string
phone1 to phone4 A contact email address for the contact. E.164
email Up to 4 different contact telephone number fields string
crmId A unique id for the contact record from an external CRM system string
field1 to field 10 10 fields for carrying any custom data for the contact record string
avatar A photo of the contact. This will be displayed on Connect clients if provided. Photos should be provided in Base64 format. string
Features may vary depending on your licence and communications platform. Please contact your provider for details.