> For the complete documentation index, see [llms.txt](https://docs.tailent.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.tailent.com/microsoft-365-automation/creating-an-application-instance.md).

# Creating an application Instance

In order to authenticate against Microsoft 365 services, an application is required. To create applications, follow these steps:

1. Navigate to <https://portal.azure.com/> and login with your Microsoft 365 global administrator account
2. Navigate to App Registrations as shown below and click "**New registration"**\
   &#x20;![](/files/JOOdM7h0pV1p3tJuMLuF)<br>
3. Set a name for your application (it should be descriptive) and check the "Single tenant" option (this is required in order to allow end users the option to consent to this application without administrator intervention)\
   ![](/files/d5BdPiOlsNzrAFuUO95S)<br>
4. After creation, an overview of the application will be shown. Note the Application (client) ID, which we will need to use with the target TAP Actions. This should be saved for reference as future access to this resource will be done through this ID. In order to finish application setup, please click on "**Add a Redirect URI**"\ <br>

   <figure><img src="/files/4cwS4mlJ4PsJPHrviz55" alt=""><figcaption></figcaption></figure>
5. Click the "+ Add a platform" button and select "Mobile and Desktop applications"\
   ![](/files/tYWGBmkuncfJCN8HY3LB)<br>
6. Check these two options and click Configure\
   ![](/files/HOt6JTSlzsZgCmhltVVh)<br>
7. Check the "Allow public client flows" option<br>
8. Click "Add URI" option in the "Mobile and desktop applications" section and add "urn:ietf:wg:oauth:2.0:oob" (no quotes). The platform configuration screen should look like this:<br>

   <figure><img src="/files/W6Xwq4Xo0eM9x2BBGEAX" alt=""><figcaption></figcaption></figure>
9. Next, we need to assign API Permission to the application. To do so, navigate to the "API permissions" section in the left pane. Initially only "User.Read" permission will be enabled. It is important to check exactly what permissions are required - for the TAP Actions that will be used with this application - and enable them. For instance, mail automation might require "Mail.Read", "Mail.ReadBasic", "Mail.ReadWrite".<br>
10. Optionally, you can also add additional information and branding info using the "Branding & properties" section in the left pane.

You should now have a working Azure AD application that can be used by the TAP Actions for Microsoft 365 automations. Please note that these will require both user credentials and the application ID mentioned previously for authentication / authorization.

**Note**: Before the first use, you will need to use the "Application Consent" button within the TAP Microsoft 365 Authentication Action to trigger an interactive login prompt which will require the user to manually consent to the application you've created. This only needs to be done once, before first use for every account you plan on using. Once consented, all automations can then be run unattended.<br>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://docs.tailent.com/microsoft-365-automation/creating-an-application-instance.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
