---
title: "Create an Office 365 instance by tenant ID"
method: POST
path: "/office365s"
tags: ["Office 365"]
---

# Create an Office 365 instance by tenant ID

`POST /office365s`

## Request

- Base URL: `https://console.jumpcloud.com/api/v2`
- URL: `https://console.jumpcloud.com/api/v2/office365s`
- Auth: API key in header `x-api-key`
- TypeScript: <https://skmtc.dev/jumpcloud/apis/jumpcloud-api-2/docs/office365s/post.ts> (a function with typed inputs; its response is checked against the schema)

Create a Microsoft 365 / Entra integration instance scoped to a tenant ID, without exchanging OAuth credentials.

## Request body

- O365ResourcesInsertByTenantIDRequest
  - `groupExportType` 'NOTSET' | 'NONE' | 'M365' | 'SECURITY'
  - `name` string
  - `objectId` string, byte
  - `tenantId` string: Microsoft Entra tenant ID.
  - `userLockoutAction` 'UNSET' | 'MAINTAIN' | 'SUSPEND'
  - `userPasswordExpirationAction` 'UNSET' | 'MAINTAIN' | 'SUSPEND'

## Response `200`

A successful response.

- O365ResourceResponse
  - `resource` O365Resource
    - `defaultDomain` O365Domain, nullable
      - `default` boolean
      - `domain` string
      - `objectId` string, byte
      - `resourceObjectId` string, byte: ObjectID of the Office 365 suite.
    - `groupExportType` 'NOTSET' | 'NONE' | 'M365' | 'SECURITY'
    - `groupsEnabled` boolean
    - `id` string, byte: Identifier of the Office 365 instance.
    - `name` string: Name of the Office 365 instance.
    - `tenantId` string: TenantID of the Office 365 instance.
    - `userLockoutAction` 'UNSET' | 'MAINTAIN' | 'SUSPEND'
    - `userPasswordExpirationAction` 'UNSET' | 'MAINTAIN' | 'SUSPEND'

## Other responses

- `201`: Created
- `400`: Bad Request
- `401`: Unauthenticated
- `403`: Unauthorized
- `409`: Conflict
- `500`: Internal Server Error
- `default`: An unexpected error response.

---

[API](https://skmtc.dev/jumpcloud/apis/jumpcloud-api-2.md) - [All operations](https://skmtc.dev/jumpcloud/apis/jumpcloud-api-2/llms.txt) - [OpenAPI document](https://skmtc.dev/jumpcloud/apis/jumpcloud-api-2/revisions/3f09fe63caaa?raw)