Microsoft Exchange · Schema

Microsoft Exchange Contact

Represents an Outlook contact in a user's mailbox as exposed through the Microsoft Graph Contacts API. A contact is an item where you can organize and save information about people and organizations you communicate with. Contacts are contained in contact folders.

CalendarCollaborationContactsEmailEnterprise

Properties

Name	Type	Description
id	string	The contact's unique identifier. By default changes when moved to a different container.
displayName	string	The contact's display name
givenName	string	The contact's given name (first name)
surname	string	The contact's surname (last name)
middleName	string	The contact's middle name
nickName	string	The contact's nickname
title	string	The contact's title (e.g. Mr., Mrs., Dr.)
initials	string	The contact's initials
generation	string	The contact's suffix (e.g. Jr., Sr., III)
emailAddresses	array	The contact's email addresses
businessPhones	array	The contact's business phone numbers
homePhones	array	The contact's home phone numbers
mobilePhone	stringnull	The contact's mobile phone number
imAddresses	array	The contact's instant messaging addresses
jobTitle	string	The contact's job title
companyName	string	The name of the contact's company
department	string	The contact's department
officeLocation	string	The location of the contact's office
profession	string	The contact's profession
manager	string	The name of the contact's manager
assistantName	string	The name of the contact's assistant
businessHomePage	string	The business home page of the contact
businessAddress	object	The contact's business address
homeAddress	object	The contact's home address
otherAddress	object	Other addresses for the contact
spouseName	string	The name of the contact's spouse or partner
birthday	string	The contact's birthday in ISO 8601 format (always UTC)
children	array	The names of the contact's children
personalNotes	string	The user's notes about the contact
fileAs	string	The name the contact is filed under
categories	array	The categories associated with the contact
parentFolderId	string	The ID of the contact's parent folder
changeKey	string	Identifies the version of the contact
createdDateTime	string	The time the contact was created
lastModifiedDateTime	string	The time the contact was last modified
yomiGivenName	string	Phonetic Japanese given name
yomiSurname	string	Phonetic Japanese surname
yomiCompanyName	string	Phonetic Japanese company name

View JSON Schema on GitHub

JSON Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://github.com/api-evangelist/microsoft-exchange/json-schema/microsoft-exchange-contact-schema.json",
  "title": "Microsoft Exchange Contact",
  "description": "Represents an Outlook contact in a user's mailbox as exposed through the Microsoft Graph Contacts API. A contact is an item where you can organize and save information about people and organizations you communicate with. Contacts are contained in contact folders.",
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "The contact's unique identifier. By default changes when moved to a different container.",
      "readOnly": true
    },
    "displayName": {
      "type": "string",
      "description": "The contact's display name"
    },
    "givenName": {
      "type": "string",
      "description": "The contact's given name (first name)"
    },
    "surname": {
      "type": "string",
      "description": "The contact's surname (last name)"
    },
    "middleName": {
      "type": "string",
      "description": "The contact's middle name"
    },
    "nickName": {
      "type": "string",
      "description": "The contact's nickname"
    },
    "title": {
      "type": "string",
      "description": "The contact's title (e.g. Mr., Mrs., Dr.)"
    },
    "initials": {
      "type": "string",
      "description": "The contact's initials"
    },
    "generation": {
      "type": "string",
      "description": "The contact's suffix (e.g. Jr., Sr., III)"
    },
    "emailAddresses": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/emailAddress"
      },
      "description": "The contact's email addresses"
    },
    "businessPhones": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "The contact's business phone numbers"
    },
    "homePhones": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "The contact's home phone numbers"
    },
    "mobilePhone": {
      "type": ["string", "null"],
      "description": "The contact's mobile phone number"
    },
    "imAddresses": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "The contact's instant messaging addresses"
    },
    "jobTitle": {
      "type": "string",
      "description": "The contact's job title"
    },
    "companyName": {
      "type": "string",
      "description": "The name of the contact's company"
    },
    "department": {
      "type": "string",
      "description": "The contact's department"
    },
    "officeLocation": {
      "type": "string",
      "description": "The location of the contact's office"
    },
    "profession": {
      "type": "string",
      "description": "The contact's profession"
    },
    "manager": {
      "type": "string",
      "description": "The name of the contact's manager"
    },
    "assistantName": {
      "type": "string",
      "description": "The name of the contact's assistant"
    },
    "businessHomePage": {
      "type": "string",
      "format": "uri",
      "description": "The business home page of the contact"
    },
    "businessAddress": {
      "$ref": "#/$defs/physicalAddress",
      "description": "The contact's business address"
    },
    "homeAddress": {
      "$ref": "#/$defs/physicalAddress",
      "description": "The contact's home address"
    },
    "otherAddress": {
      "$ref": "#/$defs/physicalAddress",
      "description": "Other addresses for the contact"
    },
    "spouseName": {
      "type": "string",
      "description": "The name of the contact's spouse or partner"
    },
    "birthday": {
      "type": "string",
      "format": "date-time",
      "description": "The contact's birthday in ISO 8601 format (always UTC)"
    },
    "children": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "The names of the contact's children"
    },
    "personalNotes": {
      "type": "string",
      "description": "The user's notes about the contact"
    },
    "fileAs": {
      "type": "string",
      "description": "The name the contact is filed under"
    },
    "categories": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "The categories associated with the contact"
    },
    "parentFolderId": {
      "type": "string",
      "description": "The ID of the contact's parent folder",
      "readOnly": true
    },
    "changeKey": {
      "type": "string",
      "description": "Identifies the version of the contact",
      "readOnly": true
    },
    "createdDateTime": {
      "type": "string",
      "format": "date-time",
      "description": "The time the contact was created",
      "readOnly": true
    },
    "lastModifiedDateTime": {
      "type": "string",
      "format": "date-time",
      "description": "The time the contact was last modified",
      "readOnly": true
    },
    "yomiGivenName": {
      "type": "string",
      "description": "Phonetic Japanese given name"
    },
    "yomiSurname": {
      "type": "string",
      "description": "Phonetic Japanese surname"
    },
    "yomiCompanyName": {
      "type": "string",
      "description": "Phonetic Japanese company name"
    }
  },
  "$defs": {
    "emailAddress": {
      "type": "object",
      "description": "Email address of a person or entity",
      "properties": {
        "name": {
          "type": "string",
          "description": "The display name"
        },
        "address": {
          "type": "string",
          "format": "email",
          "description": "The email address"
        }
      }
    },
    "physicalAddress": {
      "type": "object",
      "description": "Physical street address",
      "properties": {
        "street": {
          "type": "string",
          "description": "The street address"
        },
        "city": {
          "type": "string",
          "description": "The city"
        },
        "state": {
          "type": "string",
          "description": "The state or province"
        },
        "countryOrRegion": {
          "type": "string",
          "description": "The country or region"
        },
        "postalCode": {
          "type": "string",
          "description": "The postal code"
        }
      }
    }
  }
}