Create Contact

Creates a contact in Microsoft Outlook through Azure Active Directory.

Input

Field Definition Type Required

User

ID or Username

User ID is the unique identifier for the user. Should be treated as an opaque identifier.

Username of the Office 365 user. This is the user's User Principal Name (UPN). A UPN is formed by taking the username and domain and combining them with the @ separator.

For example, john.doe@somedomain.com. This could be the user's email address, but not always.

This property can't contain accent characters. Only the following characters are allowed A-Z, a-z, 0–9, '.-_!#^~.

Text

FALSE

Folder

Folder ID

Unique identifier of a contact folder. A contact is created in the folder with the given ID. If the Folder ID is empty, the contact is created in the Contacts folder.

Text

FALSE

Contact

Given Name

Contact's given name.

Text

TRUE

Assistant Name

Name of the contact's assistant.

Text

FALSE

Birthday

Contact's birthday. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time.

For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z

Date & Time

FALSE

Business Home Page

Business home page of the contact.

Text

FALSE

Business Phones

Business phone numbers of contacts.

List of Text

FALSE

Categories

Categories associated with the contact.

List of Text

FALSE

Children

Names of the contact's children.

List of Text

FALSE

Company Name

Name of the contact's company.

Text

FALSE

Department

Department of the contact.

Text

FALSE

Display Name

Display name of the contact.

Text

FALSE

Emails

Email addresses of the contacts.

List of Text

FALSE

File As

Name the contact is filed under.

Text

FALSE

Generation

Generation of the contact.

Text

FALSE

Home Phones

Home phone numbers of the contact.

List of Text

FALSE

IM Addresses

Instant messaging (IM) addresses of the contact.

List of Text

FALSE

Initials

Initials of the contact.

Text

FALSE

Job Title

Job title of the contact.

Text

FALSE

Manager

Name of the contact's manager.

Text

FALSE

Middle Name

Middle name of the contact.

Text

FALSE

Mobile Phone

Mobile phone number of the contact.

Text

FALSE

Nickname

Nickname of the contact.

Text

FALSE

Office Location

Location of the contact's office.

Text

FALSE

Personal Notes

User's notes about the contact.

Text

FALSE

Profession

Profession of the contact.

Text

FALSE

Spouse Name

Name of the contact's spouse/partner.

Text

FALSE

Surname

Surname of the contact.

Text

FALSE

Title

Title of the contact.

Text

FALSE

Yomi Company Name

Phonetic Japanese company name of the contact.

Text

FALSE

Yomi Given Name

Phonetic Japanese given name (first name) of the contact.

Text

FALSE

Yomi Surname

Phonetic Japanese surname (family name) of the contact.

Text

FALSE

Business Address

Street

Street of the business address.

Text

FALSE

City

City of the business address.

Text

FALSE

State

State of the business address.

Text

FALSE

Country or Region

Country or region in which the user is located. For example, US or UK.

Text

FALSE

Postal Code

Postal code of the business address.

Text

FALSE

Home Address

Street

Street of the home address.

Text

FALSE

City

City of the home address.

Text

FALSE

State

State of the home address.

Text

FALSE

Country or Region

Country or region in which the user is located. For example, US or UK.

Text

FALSE

Postal Code

Postal code of the home address.

Text

FALSE

Other Address

Street

Street of the other business address.

Text

FALSE

City

City of the other business address.

Text

FALSE

State

State of the other business address.

Text

FALSE

Country or Region

Country or region in which the user is located. For example, US or UK.

Text

FALSE

Postal Code

Postal code of the other business address.

Text

FALSE

If the string for the UPN input begins with $, remove the slash / after /users and enclose the UPN value in parentheses and single quotes. For example, /users('$AdeleVance@contoso.com'). See Known issues with Microsoft Graph.

To search for a B2B user using a UPN input value, encode the hash # character as %23. For example, /users/AdeleVance_adatum.com%23EXT%23@contoso.com.

Output

Field Definition Type

Contact

ID

Unique identifier of the contact.

Text

Given Name

Given name of the contacts.

Text

Assistant Name

Name of the contact's assistant.

Text

Birthday

Contact's birthday. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time.

For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z

Date & Time

Business Address

Street

Street of the business address.

Text

City

City of the business address.

Text

State

State of the business address.

Text

Country or Region

Country or region in which the user is located. For example, US or UK.

Text

Postal Code

Postal code of the business address.

Text

Business Home Page

Business home page of the contact.

Text

Business Phones

Business phone numbers of the contact.

List of Text

Categories

Categories associated with the contact.

List of Text

Change Key

Identifies the version of the contact. Every time the contact is changed, ChangeKey changes as well. This allows Exchange to apply changes to the correct version of the object.

List of Text

Children

Names of the contact's children.

Text

Company Name

Name of the contact's company.

Text

Created Date Time

Time the contact was created. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z

Date & Time

Department

Department of the contact.

Text

Display Name

Display name of the contact.

Text

Email Addresses

Contact's email addresses.

List of Text

Address

Address of the contact.

Text

Name

Name of the contact.

Text

File As

Name the contact is filed under.

Text

Generation

Generation of the contact.

Text

Home Address

Home address of the contact.

Object

Street

Street of the home address.

Text

City

City of the home address.

Text

State

State of the home address.

Text

Country or Region

Country or region in which the user is located. For example, US or UK.

Text

Postal Code

Postal code of the home address.

Text

Home Phones

Home phone numbers of the contact.

List of Text

IM Addresses

Instant messaging (IM) addresses of the contact.

List of Text

Initials

Initials of the contact.

Text

Job Title

Contact's job title.

Text

Last Modified Date Time

The time the contact was modified. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time.

For example: midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z

Date & Time

Manager

Name of the contact's manager.

Text

Middle Name

Middle name of the contact.

Text

Mobile Phone

Mobile phone number of the contact.

Text

Nickname

Nickname of the contact.

Text

Office Location

Location of the contact's office.

Text

Other Address

Other addresses for the contact.

Object

Street

Street of the address.

Text

City

City of the address.

Text

State

State of the address.

Text

Country or Region

Country or region in which the user is located. For example, US or UK.

Text

Postal Code

Postal code of the address.

Text

Parent Folder ID

ID of the contact's parent folder.

Text

Personal Notes

User's notes about the contact.

Text

Profession

Profession of the contact.

Text

Spouse Name

Name of the contact's spouse or partner.

Text

Surname

Surname of the contact.

Text

Title

Title of the contact.

Text

Yomi Company Name

Phonetic Japanese company name of the contact.

Text

Yomi Given Name

Phonetic Japanese given name (first name) of the contact.

Text

Yomi Surname

Phonetic Japanese surname (family name) of the contact.

Text

Related topics

Azure Active Directory connector

Workflow elements

Guidance for Azure Active Directory connector

Azure Active Directory Management API overview