API Provider Setup

To authenticate an Outlook Email element instance you must register an app with Microsoft. Then when you authenticate, use the Application Id, Password/PublicKey, and Redirect URL from your registered app as the API Key, API Secret, and Callback URL.

If you've already set up an app and just need to know how to find your Application Id and Password/PublicKey, see Locate Credentials for Authentication. If you need to register an app, see Create an Application.

See the latest setup instructions in the Microsoft documentation.

Locate Credentials for Authentication

If you already created an application, follow the steps below to locate the Application Id, Password/PublicKey, and Redirect URL. If you have not created an app, see Create an Application.

To find your OAuth 2.0 credentials:

1. Log in to your account at Microsoft.
2. Click the application that you want to connect.
3. Record the Application Id.
4. If you don't know the Password/PublicKey, click Generate New Password to get a new one and record it.
5. Record the Redirect URL for your app.

Create an Application

If you have not created an application, you need one to authenticate with Microsoft.

To create an application:

1. Log in to your account at Microsoft.
2. Click Add an App.
3. Enter a name, and then click Create
4. Record the Application Id.

5. Under Application Secrets, click Generate New Password, record the Password/PublicKey, and then click OK.

   Important: You cannot show the Password/Public Key again, so you will need to generate a new one if it's lost.

   

6. Under Platforms, click Add Platform, and then select Web.

7. In Redirect URLs enter the URL to redirect the user to at the end of the OAuth 2.0 authentication process. For example, the Cloud Elements 2.0 callback URL is https://auth.cloudelements.io/oauth.

8. Under Outlook Email Permissions add the permissions needed to use your app. Review the Mail Permissions in Microsoft's documentation.

9. Add any additional information, and then save your app.

Next authenticate an element instance with Microsoft.