Microsoft Graph · Schema

microsoft.graph.contact

Microsoft GraphAzure ADCollaborationContactsDocumentsEmailGraphIdentityMicrosoftOffice 365PresentationsProductivitySpreadsheetsT1Task

Properties

Name	Type	Description
assistantName	string	The name of the contact's assistant.
birthday	string	The 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
businessAddress	object	The contact's business address.
businessHomePage	string	The business home page of the contact.
businessPhones	array	The contact's business phone numbers.
children	array	The names of the contact's children.
companyName	string	The name of the contact's company.
department	string	The contact's department.
displayName	string	The contact's display name. You can specify the display name in a create or update operation. Note that later updates to other properties may cause an automatically generated value to overwrite the di
emailAddresses	array	The contact's email addresses.
fileAs	string	The name the contact is filed under.
generation	string	The contact's suffix.
givenName	string	The contact's given name.
homeAddress	object	The contact's home address.
homePhones	array	The contact's home phone numbers.
imAddresses	array	The contact's instant messaging (IM) addresses.
initials	string	The contact's initials.
jobTitle	string	The contact’s job title.
manager	string	The name of the contact's manager.
middleName	string	The contact's middle name.
mobilePhone	string	The contact's mobile phone number.
nickName	string	The contact's nickname.
officeLocation	string	The location of the contact's office.
otherAddress	object	Other addresses for the contact.
parentFolderId	string	The ID of the contact's parent folder.
personalNotes	string	The user's notes about the contact.
profession	string	The contact's profession.
spouseName	string	The name of the contact's spouse/partner.
surname	string	The contact's surname.
title	string	The contact's title.
yomiCompanyName	string	The phonetic Japanese company name of the contact.
yomiGivenName	string	The phonetic Japanese given name (first name) of the contact.
yomiSurname	string	The phonetic Japanese surname (last name) of the contact.
extensions	array	The collection of open extensions defined for the contact. Read-only. Nullable.
multiValueExtendedProperties	array	The collection of multi-value extended properties defined for the contact. Read-only. Nullable.
photo	object	Optional contact picture. You can get or set a photo for a contact.
singleValueExtendedProperties	array	The collection of single-value extended properties defined for the contact. Read-only. Nullable.
@odata.type	string

View JSON Schema on GitHub

JSON Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "#/components/schemas/microsoft.graph.contact",
  "title": "microsoft.graph.contact",
  "allOf": [
    {
      "$ref": "#/components/schemas/microsoft.graph.outlookItem"
    },
    {
      "title": "contact",
      "required": [
        "@odata.type"
      ],
      "type": "object",
      "properties": {
        "assistantName": {
          "type": "string",
          "description": "The name of the contact's assistant.",
          "nullable": true
        },
        "birthday": {
          "pattern": "^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$",
          "type": "string",
          "description": "The 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",
          "format": "date-time",
          "nullable": true
        },
        "businessAddress": {
          "anyOf": [
            {
              "$ref": "#/components/schemas/microsoft.graph.physicalAddress"
            },
            {
              "type": "object",
              "nullable": true
            }
          ],
          "description": "The contact's business address."
        },
        "businessHomePage": {
          "type": "string",
          "description": "The business home page of the contact.",
          "nullable": true
        },
        "businessPhones": {
          "type": "array",
          "items": {
            "type": "string",
            "nullable": true
          },
          "description": "The contact's business phone numbers."
        },
        "children": {
          "type": "array",
          "items": {
            "type": "string",
            "nullable": true
          },
          "description": "The names of the contact's children."
        },
        "companyName": {
          "type": "string",
          "description": "The name of the contact's company.",
          "nullable": true
        },
        "department": {
          "type": "string",
          "description": "The contact's department.",
          "nullable": true
        },
        "displayName": {
          "type": "string",
          "description": "The contact's display name. You can specify the display name in a create or update operation. Note that later updates to other properties may cause an automatically generated value to overwrite the displayName value you have specified. To preserve a pre-existing value, always include it as displayName in an update operation.",
          "nullable": true
        },
        "emailAddresses": {
          "type": "array",
          "items": {
            "$ref": "#/components/schemas/microsoft.graph.emailAddress"
          },
          "description": "The contact's email addresses."
        },
        "fileAs": {
          "type": "string",
          "description": "The name the contact is filed under.",
          "nullable": true
        },
        "generation": {
          "type": "string",
          "description": "The contact's suffix.",
          "nullable": true
        },
        "givenName": {
          "type": "string",
          "description": "The contact's given name.",
          "nullable": true
        },
        "homeAddress": {
          "anyOf": [
            {
              "$ref": "#/components/schemas/microsoft.graph.physicalAddress"
            },
            {
              "type": "object",
              "nullable": true
            }
          ],
          "description": "The contact's home address."
        },
        "homePhones": {
          "type": "array",
          "items": {
            "type": "string",
            "nullable": true
          },
          "description": "The contact's home phone numbers."
        },
        "imAddresses": {
          "type": "array",
          "items": {
            "type": "string",
            "nullable": true
          },
          "description": "The contact's instant messaging (IM) addresses."
        },
        "initials": {
          "type": "string",
          "description": "The contact's initials.",
          "nullable": true
        },
        "jobTitle": {
          "type": "string",
          "description": "The contact\u2019s job title.",
          "nullable": true
        },
        "manager": {
          "type": "string",
          "description": "The name of the contact's manager.",
          "nullable": true
        },
        "middleName": {
          "type": "string",
          "description": "The contact's middle name.",
          "nullable": true
        },
        "mobilePhone": {
          "type": "string",
          "description": "The contact's mobile phone number.",
          "nullable": true
        },
        "nickName": {
          "type": "string",
          "description": "The contact's nickname.",
          "nullable": true
        },
        "officeLocation": {
          "type": "string",
          "description": "The location of the contact's office.",
          "nullable": true
        },
        "otherAddress": {
          "anyOf": [
            {
              "$ref": "#/components/schemas/microsoft.graph.physicalAddress"
            },
            {
              "type": "object",
              "nullable": true
            }
          ],
          "description": "Other addresses for the contact."
        },
        "parentFolderId": {
          "type": "string",
          "description": "The ID of the contact's parent folder.",
          "nullable": true
        },
        "personalNotes": {
          "type": "string",
          "description": "The user's notes about the contact.",
          "nullable": true
        },
        "profession": {
          "type": "string",
          "description": "The contact's profession.",
          "nullable": true
        },
        "spouseName": {
          "type": "string",
          "description": "The name of the contact's spouse/partner.",
          "nullable": true
        },
        "surname": {
          "type": "string",
          "description": "The contact's surname.",
          "nullable": true
        },
        "title": {
          "type": "string",
          "description": "The contact's title.",
          "nullable": true
        },
        "yomiCompanyName": {
          "type": "string",
          "description": "The phonetic Japanese company name of the contact.",
          "nullable": true
        },
        "yomiGivenName": {
          "type": "string",
          "description": "The phonetic Japanese given name (first name) of the contact.",
          "nullable": true
        },
        "yomiSurname": {
          "type": "string",
          "description": "The phonetic Japanese surname (last name)  of the contact.",
          "nullable": true
        },
        "extensions": {
          "type": "array",
          "items": {
            "$ref": "#/components/schemas/microsoft.graph.extension"
          },
          "description": "The collection of open extensions defined for the contact. Read-only. Nullable.",
          "x-ms-navigationProperty": true
        },
        "multiValueExtendedProperties": {
          "type": "array",
          "items": {
            "$ref": "#/components/schemas/microsoft.graph.multiValueLegacyExtendedProperty"
          },
          "description": "The collection of multi-value extended properties defined for the contact. Read-only. Nullable.",
          "x-ms-navigationProperty": true
        },
        "photo": {
          "anyOf": [
            {
              "$ref": "#/components/schemas/microsoft.graph.profilePhoto"
            },
            {
              "type": "object",
              "nullable": true
            }
          ],
          "description": "Optional contact picture. You can get or set a photo for a contact.",
          "x-ms-navigationProperty": true
        },
        "singleValueExtendedProperties": {
          "type": "array",
          "items": {
            "$ref": "#/components/schemas/microsoft.graph.singleValueLegacyExtendedProperty"
          },
          "description": "The collection of single-value extended properties defined for the contact. Read-only. Nullable.",
          "x-ms-navigationProperty": true
        },
        "@odata.type": {
          "type": "string",
          "default": "#microsoft.graph.contact"
        }
      }
    }
  ],
  "x-ms-discriminator-value": "#microsoft.graph.contact"
}

Work with this as data

Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for schemas

4 MCP tools reach this

find_json_schemasBrowse and filter every JSON Schema in the catalog.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This JSON Schema

curl "https://apis.io/api/v1/json-schemas/microsoft-graph-microsoftgraphcontact"

All schemas

curl "https://apis.io/api/v1/json-schemas?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.