Get Microsoft Single-Account Consent URL
/v1/email-accounts/microsoft/consent-urlGet a Microsoft single-account consent link
Connect your Microsoft mailbox directly. Provide the mailbox address (email) you want to connect — the connection only completes if the Microsoft account that grants consent matches that address, confirming mailbox ownership. The returned link is single-use and expires in 30 minutes; navigate to it when ready to authorize. Once you complete the consent flow, you'll be returned to the TrulyInbox homepage, where you'll see a message confirming whether the mailbox connected successfully or, if not, why.
Authorization
X-Api-Key<token>
In: header
Query Parameters
emailstring
Your mailbox address. We only complete the connection if the Microsoft account that grants consent resolves to this address — this confirms mailbox ownership. Pre-fills Microsoft's login screen. You'll be redirected to the TrulyInbox homepage after consent, where you'll see a message confirming whether the mailbox connected successfully or, if not, why. Check GET /v1/email-accounts to confirm the connection succeeded.
Responses
{
"url": "https://login.microsoftonline.com/common/oauth2/v2.0/authorize?client_id=...&redirect_uri=...&state=...",
"expiresAt": "2026-08-13T12:30:00.000Z"
}