Request MS365 refresh token (update token)

To log in to Microsoft Exchange, you need what is known as an access token. This is generated automatically when you log in to Microsoft Exchange. Access Tokens are only valid for approx. 1 hour for security reasons. A new Access Token is then generated automatically. This is done with the help of the so-called refresh token. You must request this manually in the Connector for Microsoft Exchange on the "Exchange account" tab. You must do this for the user that you use when creating the data source ().

You must also do this for the additional users that you use in applications and processes ().

The refresh token is stored in the MediaGateway. It is valid for 3 months. It must then be requested again manually.

Step-by-step guide

To request an MS365 refresh token, proceed as follows:

  1. Start the "Integration" module.

  2. Navigate to "Consume data > Connector for Microsoft Exchange".

    The data source created is displayed in the right-hand area.

  3. Select the data source you have created.

  4. Press ENTER or right-click and select "Edit" from the context menu.

    The "Edit data source" dialog box opens.

  5. Switch to the "Exchange account" tab.

    When creating a new data source, the dialog appears as follows:

  6. Click on "Request MS365 Refresh Token".

    The "Request MS365 Refresh Token" dialog box is displayed.

  7. Copy the displayed code to the clipboard and paste it into the displayed Microsoft login page ().

    You can also open the Microsoft login page in your browser ().

  8. Click on "Next".

    The next dialog is displayed.

  9. Enter the e-mail address you use to log in to Microsoft Exchange.

  10. Click on "Next".

    The next dialog is displayed.

  11. Enter the password.

  12. Click on "Log in".

    The next dialog is displayed.

  13. Click on "Next".

    The next dialog is displayed.

    The refresh token is generated and stored in the MediaGateway.

    You will automatically return to the dialog

    The text "Request MS365 Refresh Token" is displayed in gray and can no longer be clicked.

    The MS365 refresh token is stored in the media gateway and is used to generate access tokens.

    The MS365 Refresh Token is valid for 90 days. It must then be regenerated in the manner described here.

Request refresh token for additional users

Step-by-step guide

To request a refresh token for additional users, proceed as follows:

  1. Switch to the "Additional users" tab.

  2. Click on the icon.

    The "Additional users" dialog box is displayed.

  3. Select an Intrexx user and assign a Microsoft Exchange user to it.

  4. Click on "Request MS365 Refresh Token".

    Now proceed as described above, starting with the step Click on "Request MS365 Refresh Token"..

More information

Connector for Microsoft Exchange - Authentication - OAuth2