Initialize microsoft oauth

Creates an OAuth session and returns the Microsoft authorization URL. The user should be redirected to auth_url to complete the OAuth flow. Poll the status endpoint to check for completion.

Special rate limits (stricter than the standard API rate limit) to comply with upstream Microsoft rate limits:

• 75 requests per minute per workspace
• 150 requests per minute per IP

If Microsoft’s upstream OAuth service is temporarily unavailable, requests may return 503.

POST /api/v2/oauth/microsoft/init

Initialize microsoft oauth

cURL

curl --request POST \
  --url https://api.instantly.ai/api/v2/oauth/microsoft/init \
  --header 'Authorization: Bearer <token>'

200

{
  "session_id": "abc123def456",
  "auth_url": "https://login.microsoftonline.com/common/oauth2/v2.0/authorize?...",
  "expires_at": "2026-01-14T12:30:00.000Z"
}

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Response

200

application/json

Default Response

session_id · string

Session ID for polling status

Example:

"abc123def456"

auth_url · string

Microsoft authorization URL to redirect user to

Example:

"https://login.microsoftonline.com/common/oauth2/v2.0/authorize?..."

expires_at · string<date-time>

Session expiry time (10 minutes from creation)

Example:

"2026-01-14T12:30:00.000Z"