Share via

Microsoft 365 for mobile OAuth2 sign-in URL parameters

  • Article

The HTTPS request to load the OAuth2 Authorization page (RFC 6749#section-3.1) includes standard OAuth2 parameters such as client_id, redirect_uri, etc. but may also include Office-specific parameters, documented here.

Important

Early releases of Microsoft 365 for mobile might not include some or all of these URL parameters, so callers should fall back to reasonable defaults.

Culture

The request includes the Accept-Language header. The iOS language settings determine value of this header. In addition, the following URL parameter is appended to the request URL:

rs=Culture

Culture contains the UI culture of the Microsoft 365 interface, e.g. en-US.

Build

The following URL parameter is appended to the request URL:

build=#

“#” will be a string showing the build of the Office application making the request.

Platform

The platform URL parameter communicates on which platform the app is running.

platform=iOS

Example

Here’s a request to the sign-in endpoint showing all parameters in use:

https://contoso.com/api/oauth2/authorize?&rs=en-US&build=1.21.417&platform=iOS&client_id=abcdefg&redirect_uri=https%3A%2F%2Flocalhost&response_type=code