Connect

Start a Microsoft 365 organization connection

Changed on

Creates an organization connection for a Microsoft 365 tenant. An administrator opens setup.adminConsentUrl and approves Zernio's application permissions once, then you add mailboxes without each user signing in.

After consent Microsoft sends the administrator to redirectUrl with orgConnectionId, status (active, pending or denied) and tenant.

Application permissions reach every mailbox in the tenant. Administrators can scope them with an Exchange Online application access policy or RBAC for Applications.

post/v1/connect/microsoft/org

Request

Request body

profileIdstring required
scopesstring[] required
allowedEmailsstring[]

Addresses or @domain entries mailboxes must match. Omit for every mailbox.

redirectUrlstring uri

Where Microsoft sends the administrator after consent.

Response

The connection, pending until an administrator consents

Changes