Relay.app Docs
  • Getting Started
    • Introduction
    • Helpful Resources
    • FAQ
  • Triggers
    • Triggers 101
    • Webhook Trigger
    • Mailhook Trigger
    • Manual Trigger
    • Scheduled Trigger
    • Batch Triggers
    • RSS Trigger
  • Actions in Apps
    • App Actions 101
  • Creating Templated Documents
  • Creating New Spreadsheets
  • DATA
    • Step Outputs
    • Find Steps
    • Lists (Arrays)
    • Inspecting Run Data
  • AI
    • AI Steps
    • Human-in-the-Loop AI reviews
    • AI Credits
    • Agentic Tool Use
    • Knowledge
    • Prompt Templates
    • Prompt Tips
    • Audio Transcription
  • Built-in actions
    • Transform Data
    • Create Constants
    • Search Google
    • Scrape Text from Website
    • Custom HTTP Requests
    • Run Custom Code (JS)
  • Flow Control
    • Paths
    • Iterators
    • Wait steps
    • Sequences
  • Human-in-the-Loop
    • Human-in-the-Loop Steps
    • AI output reviews
    • Roles
  • Workflows
    • Folders and Organization
    • Sharing Workflows
    • Headings
    • Notes
  • TEMPLATES
    • About Workflow Templates
    • Using a Template (Importing)
    • Creating a Template (Exporting)
  • Workspace
    • Step & AI credit usage
    • Billing and Plans
    • Workspace administration
    • (Sharing) App Accounts
  • Changing your email address
  • App-Specific FAQs
    • Airtable
    • Attio
    • Cal.com
    • Coda
    • DeepSeek
    • Discord
    • Fireflies
    • Google AI Studio (Gemini)
    • Gmail
    • Google Docs
    • Google Drive
    • Google Sheets
    • Microsoft Permissions
    • Microsoft Outlook Mail
    • Notion
    • OpenAI
    • OpenPhone
    • Slack
    • X (Twitter)
    • QuickBooks Online
Powered by GitBook
On this page
  • When signing up for Relay.app using a Microsoft account, it tells me admin approval is required. Now what?
  • Approving Relay.app for admins
  • Requested & required permissions
  • Learn more

Was this helpful?

  1. App-Specific FAQs

Microsoft Permissions

Last updated 18 days ago

Was this helpful?

When signing up for Relay.app using a Microsoft account, it tells me admin approval is required. Now what?

Administrators in a Microsoft workspace can restrict signing in to apps that they haven't previously approved. As a result, non-admin users of the workspace will see a dialog like this when trying to sign in to Relay.app:

This means that an admin in your workspace will need to approve Relay.app. Luckily, this is easy:

Approving Relay.app for admins

Admins have two ways to approve Relay.app for users in their workspace:

  1. If a user requests Relay.app approval via the dialog above, admins will see the request in their admin panel, ready to approve.

  2. Admins may also sign in to Relay.app themselves and check the box to Consent on behalf of your organization.

Requested & required permissions

If you're an admin managing permissions in Entra, your permissions screen will look like this when all Microsoft apps are approved for use with Relay.app:

If your organization only wants to use Outlook with Relay.app, the required permissions are:

  • Mail.ReadWrite

  • Mail.Send

  • User.Read

  • openid

  • email

  • profile

  • offline_access

Need to correct which permissions are granted? Make corrections in Entra, or delete Relay.app from Entra and sign in to Relay.app again to grant permissions during sign-in.

Learn more

Visit this Microsoft support article for more information:

https://learn.microsoft.com/en-us/entra/identity/enterprise-apps/review-admin-consent-requests

"Unverified" error during sign in with Microsoft
Admins see "Consent on behalf of your organization"
Microsoft sign-in error dialog showing 'Need admin approval' message with Relay.app requesting permissions
Microsoft permissions consent dialog showing 'Consent on behalf of your organization' checkbox for admin approval
Microsoft Entra admin center showing Enterprise applications with Relay.app permissions and all Microsoft app permissions listed