> For the complete documentation index, see [llms.txt](https://help.novatalks.com.ua/en/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.novatalks.com.ua/en/get-started/settings/inboxes/email/configure-an-oauth-app-for-outlook-and-microsoft-365.md).

# 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="https://2498134934-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5yF7NRiGknx3Bqj4OgYA%2Fuploads%2FxBiBYXexLWInC4kJNJFk%2Fimage.png?alt=media&amp;token=a6ff2786-7f9c-497d-805b-a4812b228c26" 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="https://2498134934-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5yF7NRiGknx3Bqj4OgYA%2Fuploads%2F3ZUcokMYbQWL1B9xm5sx%2Fimage.png?alt=media&amp;token=bab7324b-6b67-43a1-888f-a7b03d465612" 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="https://2498134934-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5yF7NRiGknx3Bqj4OgYA%2Fuploads%2FuVlNmrIUZNx2xsOwGaKT%2Fimage.png?alt=media&amp;token=def8be05-3f59-41a8-84d6-87a60e0bdc94" 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="https://2498134934-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5yF7NRiGknx3Bqj4OgYA%2Fuploads%2FdNTu77RwAjxkluHAWqUI%2Fimage.png?alt=media&amp;token=0e27edb7-1708-4274-883a-01720645a97e" 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="https://2498134934-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5yF7NRiGknx3Bqj4OgYA%2Fuploads%2FDodHbGGcilX6EDjXT1NV%2Fimage.png?alt=media&amp;token=5024d825-b3ac-4239-bd6e-fbca86660529" alt=""><figcaption></figcaption></figure>
