# Configure an OAuth app for Outlook and Microsoft 365

## Registration of the application

To register an application in the Microsoft Entra Admin Center, you need to:

1. Go to Microsoft Entra Admin Center and sign in with your Microsoft account
2. Open the **Identity** section in the left menu, select **Applications → App registrations**, and click **New registration.**

<figure><img src="/files/O3yJHtFrSDL4ic3DYZDz" alt=""><figcaption></figcaption></figure>

3. On the registration page, fill in the application settings: name and account type.

{% hint style="success" %}
It is recommended to select Accounts in any organisational directory, as integration with NovaTalks works only with corporate mail.
{% endhint %}

4. Click **Register** and the application will be created.

<figure><img src="/files/8UnP8Ea0zxXugQ32miKE" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
Save the Application (Client) ID - you will need to specify it when creating an Inbox in NovaTalks (see more details in [Email](/en/get-started/settings/inboxes/email.md)).
{% endhint %}

***

## Configure application

### Configure permissions

In the API permissions menu (in the Manage section), add the following permissions from Microsoft Graph API → Delegated permissions:

`email` -  access to the user's email address

`profile`  - view name, avatar, etc.

`offline_access` - access to mail without active login

`SMTP.Send, Mail.Send` - send emails on behalf of the user

`IMAP.AccessAsUser.All, Mail.ReadWrite`  - full access to the mailbox via IMAP

`openid`  - user authentication

<figure><img src="/files/mv35SS3bGGUax1P7ztbC" alt=""><figcaption></figcaption></figure>

***

## Creating Client Secret

In the Certificates & Secrets section:

1. Click **New client secret**
2. Enter the description and validity period.
3. Click Add - the client secret will be generated.

{% hint style="warning" %}
Save the Secret ID value right away - you won't be able to see it after the page refreshes.\
You will need to specify this parameter when creating an Inbox in NovaTalks (see more details in [Email](/en/get-started/settings/inboxes/email.md)).
{% endhint %}

<figure><img src="/files/U5NiTR2gi6lQSsCfDLgb" alt=""><figcaption></figcaption></figure>

After receiving the Client ID and Client Secret, create an Inbox to connect your Microsoft account to NovaTalks (see more - [Email](/en/get-started/settings/inboxes/email.md)).

To complete the registration, add the Redirect URI, received after creating the Email channel. This address will be used to redirect the user back to NovaTalks after authentication.

<figure><img src="/files/nFFaaJA64JnkDVfZTXts" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.novatalks.com.ua/en/get-started/settings/inboxes/email/configure-an-oauth-app-for-outlook-and-microsoft-365.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
