Start Microsoft Sign-inBeta

Get the Microsoft sign-in URL for connecting a Microsoft 365 or Outlook.com mailbox.

POSThttps://api.foxreach.io/api/v1/email-accounts/microsoft-oauth/start

Requires an API key with the write scope. Returns 503 until Microsoft sign-in is switched on.

Microsoft 365 and Outlook.com mailboxes cannot connect with a password or an app password, because Microsoft removed password login for IMAP. Open the returned URL in a browser and sign in; any 2FA prompt appears on Microsoft's own page. FoxReach then tests SMTP and IMAP, and connects the mailbox to the workspace of the API key only if both accept it. There is no API route for the callback, so the new account appears in List Email Accounts once someone has finished in the browser.

The link carries a signed state token that is valid for 10 minutes. Request a new URL if it expires.

loginHintstringquery

Beta. The mailbox address to pre-fill on Microsoft's sign-in page.

Response#

dataobject

Result.

Show data

urlstring

Beta. The Microsoft sign-in URL to open in a browser.

Request

cURL

curl -X POST "https://api.foxreach.io/api/v1/email-accounts/microsoft-oauth/start" \
  -H "X-API-Key: otr_your_key"

Python SDK (beta)

from foxreach import FoxReach

client = FoxReach(api_key="otr_your_key")
result = client.email_accounts.microsoft_oauth_start()
print(result["url"])

TypeScript SDK (beta)

import { FoxReach } from "foxreach";

const client = new FoxReach({ apiKey: "otr_your_key" });
const { url } = await client.emailAccounts.startMicrosoftOAuth();

Response

JSON

{
  "data": {
    "url": "https://login.microsoftonline.com/common/oauth2/v2.0/authorize?..."
  }
}

Was this page helpful?

View as MarkdownLast updated November 6, 2026