Microsoft 365 People Integration

Field	Description	Required	Format
Client ID	Microsoft Azure AD OAuth App Client ID	Yes	`xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx`
Client Secret	Microsoft Azure AD OAuth App Client Secret	Yes	`xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx`

create_contact — Create a new contact in Microsoft 365 People

Parameters

string

required

Email address of the contact

string

required

First name of the contact

string

Last name of the contact

string

ID of the contact folder to create the contact in (defaults to the root contacts folder)

string

Mobile phone number of the contact

array

List of home phone numbers for the contact (each element is a string)

string

Street address of the contact

string

City of the contact

string

State of the contact

string

Postal code of the contact

string

Country or region of the contact

Response

{
  "$defs": {
    "ContactOutput": {
      "additionalProperties": false,
      "description": "A Microsoft 365 contact resource.",
      "properties": {
        "id": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Id"
        },
        "display_name": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Display Name"
        },
        "given_name": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Given Name"
        },
        "surname": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Surname"
        },
        "email_addresses": {
          "items": {
            "$ref": "#/$defs/EmailAddress"
          },
          "title": "Email Addresses",
          "type": "array"
        },
        "mobile_phone": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Mobile Phone"
        },
        "home_phones": {
          "items": {
            "type": "string"
          },
          "title": "Home Phones",
          "type": "array"
        },
        "home_address": {
          "anyOf": [
            {
              "$ref": "#/$defs/HomeAddress"
            },
            {
              "type": "null"
            }
          ],
          "default": null
        },
        "created_date_time": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Created Date Time"
        },
        "last_modified_date_time": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Last Modified Date Time"
        }
      },
      "title": "ContactOutput",
      "type": "object"
    },
    "EmailAddress": {
      "additionalProperties": false,
      "description": "An email address entry on a contact.",
      "properties": {
        "name": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Name"
        },
        "address": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Address"
        }
      },
      "title": "EmailAddress",
      "type": "object"
    },
    "HomeAddress": {
      "additionalProperties": false,
      "description": "A physical address on a contact.",
      "properties": {
        "street": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Street"
        },
        "city": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "City"
        },
        "state": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "State"
        },
        "postal_code": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Postal Code"
        },
        "country_or_region": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Country Or Region"
        }
      },
      "title": "HomeAddress",
      "type": "object"
    }
  },
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "contact": {
      "anyOf": [
        {
          "$ref": "#/$defs/ContactOutput"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    }
  },
  "required": [
    "success"
  ],
  "title": "CreateContactOutput",
  "type": "object"
}

create_contact_folder — Create a new contact folder in Microsoft 365 People

Parameters

string

required

The display name of the new contact folder

Response

{
  "$defs": {
    "ContactFolderOutput": {
      "additionalProperties": false,
      "description": "A Microsoft 365 contact folder resource.",
      "properties": {
        "id": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Id"
        },
        "display_name": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Display Name"
        },
        "parent_folder_id": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Parent Folder Id"
        }
      },
      "title": "ContactFolderOutput",
      "type": "object"
    }
  },
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "folder": {
      "anyOf": [
        {
          "$ref": "#/$defs/ContactFolderOutput"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    }
  },
  "required": [
    "success"
  ],
  "title": "CreateContactFolderOutput",
  "type": "object"
}

update_contact — Update an existing contact in Microsoft 365 People

Parameters

string

required

ID of the contact to update

string

ID of the contact folder containing the contact (defaults to the root contacts folder)

string

New email address for the contact

string

New first name for the contact

string

New last name for the contact

string

New mobile phone number for the contact

array

New list of home phone numbers for the contact (each element is a string)

string

New street address for the contact

string

New city for the contact

string

New state for the contact

string

New postal code for the contact

string

New country or region for the contact

Response

{
  "$defs": {
    "ContactOutput": {
      "additionalProperties": false,
      "description": "A Microsoft 365 contact resource.",
      "properties": {
        "id": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Id"
        },
        "display_name": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Display Name"
        },
        "given_name": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Given Name"
        },
        "surname": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Surname"
        },
        "email_addresses": {
          "items": {
            "$ref": "#/$defs/EmailAddress"
          },
          "title": "Email Addresses",
          "type": "array"
        },
        "mobile_phone": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Mobile Phone"
        },
        "home_phones": {
          "items": {
            "type": "string"
          },
          "title": "Home Phones",
          "type": "array"
        },
        "home_address": {
          "anyOf": [
            {
              "$ref": "#/$defs/HomeAddress"
            },
            {
              "type": "null"
            }
          ],
          "default": null
        },
        "created_date_time": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Created Date Time"
        },
        "last_modified_date_time": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Last Modified Date Time"
        }
      },
      "title": "ContactOutput",
      "type": "object"
    },
    "EmailAddress": {
      "additionalProperties": false,
      "description": "An email address entry on a contact.",
      "properties": {
        "name": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Name"
        },
        "address": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Address"
        }
      },
      "title": "EmailAddress",
      "type": "object"
    },
    "HomeAddress": {
      "additionalProperties": false,
      "description": "A physical address on a contact.",
      "properties": {
        "street": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Street"
        },
        "city": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "City"
        },
        "state": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "State"
        },
        "postal_code": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Postal Code"
        },
        "country_or_region": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Country Or Region"
        }
      },
      "title": "HomeAddress",
      "type": "object"
    }
  },
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "contact": {
      "anyOf": [
        {
          "$ref": "#/$defs/ContactOutput"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    }
  },
  "required": [
    "success"
  ],
  "title": "UpdateContactOutput",
  "type": "object"
}

Using

Providers

Building

Tools

Microsoft 365 People Integration for AI Agents & Workflows

Overview

Authentication

OAuth2 Authentication

Required Credentials

OAuth Configuration

Available Actions

Parameters

Response

Parameters

Response

Parameters

Response

Limits & Quotas

Cal.com

Canva

ConvertAPI

Links

​Overview

​Authentication

​OAuth2 Authentication

​Required Credentials

​OAuth Configuration

​Available Actions

​Parameters

​Response

​Parameters

​Response

​Parameters

​Response

​Limits & Quotas

​Related integrations

Cal.com

Canva

ConvertAPI

​Links

Overview

Authentication

OAuth2 Authentication

Required Credentials

OAuth Configuration

Available Actions

Parameters

Response

Parameters

Response

Parameters

Response

Limits & Quotas

Related integrations

Links