Connect Microsoft (BYO Entra app)
Registers a Nylas credential for a customer-supplied (bring-your-own) Entra
app, so the org connects via its own app instead of Stuut’s shared one.
Default-app orgs do not need this — they go straight to the consent
flow (/consent-url → /consent-callback), which uses the shared
credential. After connecting, the admin completes consent as usual.
Both azure_tenant_id and credentials are required (enforced by the
request schema) — this endpoint is for BYO only.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Body
Connect the org via a bring-your-own (BYO) Entra app.
Default-app orgs don't use this — they go straight to the admin-consent flow against Stuut's shared app. This endpoint registers a Nylas credential for the customer's own Entra app, so all fields are required.
Response
Successful Response
How mail is transported — 'nylas' (OAuth sync/send) or 'sendgrid' (domain send).
nylas, sendgrid The org's Microsoft mailbox connection: consent state and Entra details.
The org's Google mailbox connection state.
Routing / auto-assignment config for the centralized inbox.
SendGrid transport configuration.
