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, '.-_!#^~.

String 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. String FALSE
Contact
Given Name Contact's given name. String TRUE
Assistant Name Name of the contact's assistant. String 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 and Time FALSE
Business Home Page Business home page of the contact. String FALSE
Business Phones Business phone numbers of contacts. List of Strings FALSE
Categories Categories associated with the contact. List of Strings FALSE
Children Names of the contact's children. List of Strings FALSE
Company Name Name of the contact's company. String FALSE
Department Department of the contact. String FALSE
Display Name Display name of the contact. String FALSE
Emails Email addresses of the contacts. List of Strings FALSE
File As Name the contact is filed under. String FALSE
Generation Generation of the contact. String FALSE
Home Phones Home phone numbers of the contact. List of Strings FALSE
IM Addresses Instant messaging (IM) addresses of the contact. List of Strings FALSE
Initials Initials of the contact. String FALSE
Job Title Job title of the contact. String FALSE
Manager Name of the contact's manager. String FALSE
Middle Name Middle name of the contact. String FALSE
Mobile Phone Mobile phone number of the contact. String FALSE
Nickname Nickname of the contact. String FALSE
Office Location Location of the contact's office. String FALSE
Personal Notes User's notes about the contact. String FALSE
Profession Profession of the contact. String FALSE
Spouse Name Name of the contact's spouse/partner. String FALSE
Surname Surname of the contact. String FALSE
Title Title of the contact. String FALSE
Yomi Company Name Phonetic Japanese company name of the contact. String FALSE
Yomi Given Name Phonetic Japanese given name (first name) of the contact. String FALSE
Yomi Surname Phonetic Japanese surname (family name) of the contact. String FALSE
Business Address
Street Street of the business address. String FALSE
City City of the business address. String FALSE
State State of the business address. String FALSE
Country or Region Country or region in which the user is located. For example, US or UK. String FALSE
Postal Code Postal code of the business address. String FALSE
Home Address
Street Street of the home address. String FALSE
City City of the home address. String FALSE
State State of the home address. String FALSE
Country or Region Country or region in which the user is located. For example, US or UK. String FALSE
Postal Code Postal code of the home address. String FALSE
Other Address
Street Street of the other business address. String FALSE
City City of the other business address. String FALSE
State State of the other business address. String FALSE
Country or Region Country or region in which the user is located. For example, US or UK. String FALSE
Postal Code Postal code of the other business address. String 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. String
Given Name Given name of the contacts. String
Assistant Name Name of the contact's assistant. String
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 and Time
Business Address
Street Street of the business address. String
City City of the business address. String
State State of the business address. String
Country or Region Country or region in which the user is located. For example, US or UK. String
Postal Code Postal code of the business address. String
Business Home Page Business home page of the contact. String
Business Phones Business phone numbers of the contact. List of Strings
Categories Categories associated with the contact. List of Strings
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 Strings
Children Names of the contact's children. String
Company Name Name of the contact's company. String
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 and Time
Department Department of the contact. String
Display Name Display name of the contact. String
Email Addresses Contact's email addresses. List of Strings
Address Address of the contact. String
Name Name of the contact. String
File As Name the contact is filed under. String
Generation Generation of the contact. String
Home Address Home address of the contact. Object
Street Street of the home address. String
City City of the home address. String
State State of the home address. String
Country or Region Country or region in which the user is located. For example, US or UK. String
Postal Code Postal code of the home address. String
Home Phones Home phone numbers of the contact. List of Strings
IM Addresses Instant messaging (IM) addresses of the contact. List of Strings
Initials Initials of the contact. String
Job Title Contact's job title. String
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 and Time
Manager Name of the contact's manager. String
Middle Name Middle name of the contact. String
Mobile Phone Mobile phone number of the contact. String
Nickname Nickname of the contact. String
Office Location Location of the contact's office. String
Other Address Other addresses for the contact. Object
Street Street of the address. String
City City of the address. String
State State of the address. String
Country or Region Country or region in which the user is located. For example, US or UK. String
Postal Code Postal code of the address. String
Parent Folder ID ID of the contact's parent folder. String
Personal Notes User's notes about the contact. String
Profession Profession of the contact. String
Spouse Name Name of the contact's spouse or partner. String
Surname Surname of the contact. String
Title Title of the contact. String
Yomi Company Name Phonetic Japanese company name of the contact. String
Yomi Given Name Phonetic Japanese given name (first name) of the contact. String
Yomi Surname Phonetic Japanese surname (family name) of the contact. String

Related topics

Azure Active Directory connector

Workflow elements

Guidance for Azure Active Directory connector

Azure Active Directory Management API overview