Contacts

Contains user contact records, including names, email addresses, job titles, and business phone numbers synced from Office365.

Table Specific Information

Select

You can query Contacts by specifying an Id or selecting all:

SELECT * FROM Contacts WHERE Id = 'your Contact Id goes here'

Select a certain column from the entity and filter by that column:

SELECT GivenName FROM Contacts WHERE GivenName LIKE 'John%'

Insert

Specify a GivenName and a Surname as a minimum in order to create a new Contact:

INSERT INTO Contacts (GivenName, Surname) VALUES ('John', 'Smith')

Note: In case of client credentials, UserId is required in order to create a new Contact:

INSERT INTO Contacts (GivenName, Surname, UserId) VALUES ('John', 'Smith', '92dfdfc6-f1d4-4965-9f71-30e4da4fa7fe')

Columns


Name	Type	ReadOnly	References	Description
id [KEY]	String	True		Unique identifier for the contact record.
Etag	String	False		Entity tag used to determine whether the contact has changed since it was last retrieved.
categories	String	False		List of categories assigned to the contact for organization or filtering.
changeKey	String	False		Version key that updates each time the contact is modified.
createdDateTime	Datetime	False		Timestamp indicating when the contact was created in the system.
lastModifiedDateTime	Datetime	False		Timestamp indicating the last time the contact was updated.
assistantName	String	False		Full name of the contact's assistant.
birthday	Datetime	False		The contact's date of birth.
businessAddress_city	String	False		City portion of the contact's business address.
businessAddress_countryOrRegion	String	False		Country or region of the contact's business address.
businessAddress_postalCode	String	False		Postal code of the contact's business address.
businessAddress_state	String	False		State or province of the contact's business address.
businessAddress_street	String	False		Street portion of the contact's business address.
businessHomePage	String	False		URL of the contact's business home page.
businessPhones	String	False		One or more business phone numbers associated with the contact.
children	String	False		Names of the contact's children, separated by commas.
companyName	String	False		Name of the company where the contact works.
department	String	False		Department within the company to which the contact belongs.
displayName	String	False		The contact's full display name as shown in the address book.
emailAddresses	String	False		List of email addresses associated with the contact.
fileAs	String	False		Text used to file and sort the contact in address books.
generation	String	False		Suffix denoting generational titles such as Jr., Sr., III.
givenName	String	False		The contact's first name or given name.
homeAddress_city	String	False		City portion of the contact's home address.
homeAddress_countryOrRegion	String	False		Country or region of the contact's home address.
homeAddress_postalCode	String	False		Postal code of the contact's home address.
homeAddress_state	String	False		State or province of the contact's home address.
homeAddress_street	String	False		Street portion of the contact's home address.
homePhones	String	False		One or more home phone numbers associated with the contact.
imAddresses	String	False		Instant messaging (IM) addresses associated with the contact.
initials	String	False		The contact's initials, typically derived from given and family names.
jobTitle	String	False		The contact's job title or position within the organization.
manager	String	False		Name of the contact's manager or supervisor.
middleName	String	False		The contact's middle name.
mobilePhone	String	False		Primary mobile phone number for the contact.
nickName	String	False		Nickname or informal name used for the contact.
officeLocation	String	False		Location or room number of the contact's office.
otherAddress_city	String	False		City portion of an alternate address for the contact.
otherAddress_countryOrRegion	String	False		Country or region of the contact's alternate address.
otherAddress_postalCode	String	False		Postal code of the contact's alternate address.
otherAddress_state	String	False		State or province of the contact's alternate address.
otherAddress_street	String	False		Street portion of the contact's alternate address.
parentFolderId	String	False		Identifier of the folder that contains the contact.
personalNotes	String	False		Freeform notes or annotations the user has added about the contact.
profession	String	False		The contact's profession or area of expertise.
spouseName	String	False		Name of the contact's spouse or partner.
surname	String	False		The contact's family name or surname.
title	String	False		Courtesy title or salutation for the contact such as Mr., Ms., Dr.
yomiCompanyName	String	False		Phonetic spelling of the contact's company name in Japanese kana.
yomiGivenName	String	False		Phonetic spelling of the contact's first name in Japanese kana.
yomiSurname	String	False		Phonetic spelling of the contact's last name in Japanese kana.
UserId [KEY]	String	False		Identifier for the user to whom the contact belongs.

Power BI Connector for Microsoft Office 365

Contacts

Table Specific Information

Select

Insert

Columns