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 |