OAuth2 Authentication

For OAuth2 authentication POPBeamer needs four values: client_id, client_secret, refresh_token and a token exchange URL.

Below you find a description how to get the values.

Microsoft Graph (O365 / Outlook.com / Hotmail.com)

Goto https://portal.azure.com

select Azure Active Directory

select App Registration

select New Registration

Name: POPBeamer

check: Accounts in any organizational directory and personal Microsoft accounts

check: Client Application (Web, iOS, Android, Desktop+Devices)

select Register

check (if available): Allow direct integration with the Microsoft account service

not-check (if available): Treat application as a public client.


select Authentication

select Add a platform

select Web (single Web app)

Redirect URIs: https://grant.outofindex.com/connect/microsoft/callback

check: Access tokens

check: ID tokens

select Configure


select Overwiew

Application (client) ID: xxxxx-xxxx-xxxx-xxxx-xxxxxxx (this is the client_id)


select Certificates and secrets

select New Client secret

Description: Private Key

check: Never

select Add

Value: xxxxxxxxxx (this is the client_secret)


select Api permissions

select Add permission

select Microsoft Graph

select Delegate permissions

Select: offline_access, Mail.ReadWrite

select Add permissions


Goto https://grant.outofindex.com/

select Provider: Microsoft

check: app

Scope: offline_access Mail.ReadWrite

Key: your client_id

Secret: your client_secret

Redirect_uri: https://grant.outofindex.com/connect/microsoft/callback

select Login


Microsoft dialog asking for permission


Redirected back to https://grant.outofindex.com/microsoft

refresh_token: xxxxxxxxxx (this is the refresh_token)


Exchange URL: https://login.microsoftonline.com/common/oauth2/v2.0/token


Google GMail

Goto https://console.developers.google.com/dcredirect/

select Create Project

Project Name: POPBeamer

select Create


select Click "Google API" in the upper left corner

select Select "POPBeamer"


select OAuth Consent screen

select Create

check: External

Application Name: POPBeamer

select Save


select Credentials

select Create Credentials

select OAuth client ID

Application type: Web application

Name: POPBeamer

Authorized redirect URIs: https://developers.google.com/oauthplayground

select Create


Popup of dialog "OAuth client created"

Your Client ID: xxxx-xxxxxxxxxx.apps.googleusercontent.com (this is the client_id)

Your Client Secret: xxxxxxxxxx (this is the client_secret)

select OK


Goto https://developers.google.com/oauthplayground

select gear button on the upper right corner

Access type: offline

Check: Use your own OAuth credentials

OAuth Client ID: your client_id

OAuth Client secret: your client_secret

select Close


select Step 1: Select & authorize APIs

Input your own scope: https://mail.google.com

select Authorize APIs


Google dialog asking for permission


select Exchange authorization code for tokens

refresh_token: xxxxxxxxxx (this is the refresh_token)


Exchange URL: https://oauth2.googleapis.com/token


©1991-2023 DataEnter GmbH
Wagramerstrasse 93/5/10 A-1220 Vienna, Austria
2022-08-05 / Phone
2022-08-05 / Tablet
Changed: 2022-08-05
Copyright ©1991-2023 DataEnter GmbH
Wagramerstrasse 93/5/10 A-1220 Vienna, Austria
Fax: +43 (1) 4120051