Microsoft Graph · Schema
microsoft.graph.contact
Azure ADCollaborationContactsDocumentsEmailGraphIdentityMicrosoftOffice 365PresentationsProductivitySpreadsheetsT1Task
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.
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"
Discovery needs no key. Ratings and market analysis are Pro.
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.
A second provider on the same verified email joins the account you already have.