Getting Started with Almo – Completing the Entra Setup

Thank you for your interest in Almo! We are so excited to have you onboard 🤩

When you sign in to Almo for the first time, Microsoft may show an “Approval required” screen.

This is a standard Microsoft security requirement that applies to any add-in requesting organisation-level permissions in Microsoft Entra (formerly Azure Active Directory).

Your IT administrator needs to grant consent once – after that, everyone in your organisation can use Almo without any further steps.

The process has two parts: what we need you to do, and what your IT administrator does.

---

What We Need You to Do

When you see the screen below after clicking Sign in with Microsoft, type a brief reason in the text box and click Request approval.

Something like “I want to use Almo to manage Azure DevOps work items from Outlook” is enough. Microsoft will notify your IT administrator automatically.

You will then see this confirmation:

At this point, please forward this page to your IT administrator and ask them to follow the instructions below. The setup takes about five minutes on their end. Once they complete it, you can sign in and start using Almo straight away – your 30-day free trial begins from first sign-in.

---

Hi there IT Boss! 👋🏼

Thank you for your help in making Almo available to your organisation. We genuinely appreciate this 🙏🏻

Please note that Step 2 is separate from Step 1 and must be completed even after Step 1 succeeds.

‼️ Skipping Step 2 is the most common reason users cannot proceed after admin approval.

Step 1 – Approve the Pending Request

1. Sign in to the Azure Portal
2. Navigate to Enterprise Applications – search at the top, select it from the home screen, or find it via More services

3. In the left sidebar, go to Activity > Admin consent requests
4. Under the My Pending tab, find Almo and click it

If Almo does not appear in the My Pending list, skip directly to Step 2.

5. Click Review permissions and consent

6. Sign in with your admin account when the Microsoft login prompt appears
7. Review the permissions and click Accept

A confirmation banner will appear in the top-right corner once consent is approved.

---

Step 2 – Grant Admin Consent from All Applications (Required)

This step grants organisation-wide consent. It is separate from the request approval above and must be completed regardless of whether Step 1 succeeded.

1. In Enterprise Applications, use the sidebar to go to Manage > All applications
2. Search for Almo and click the application name

3. In the sidebar, go to Security > Permissions
4. Click Grant admin consent for [your organisation name]

5. Sign in with your admin account when prompted
6. Review the full permissions list and click Accept

The permission setup is now complete. Users in your organisation can sign in to Almo and connect to their Azure DevOps projects.

---

Questions or Issues?

If users still cannot sign in after both steps are completed, check first that Step 2 was not skipped – it is the step most commonly missed. If the issue persists, raise a support ticket with us at [email protected] and we will get back to you promptly.