Minotaur Γ Microsoft Outlook β Integration Guide
App: Minotaur Microsoft Outlook Integration
Published by: Minotaur Sales
Supported on: app.minotaursales.io
Overviewβ
The Minotaur Microsoft Outlook integration connects your Microsoft 365 or Outlook mailbox to the Minotaur CRM, allowing you to:
- Send emails to contacts directly from a contact's record, with attachment support.
- Reply and forward existing email threads without leaving the app.
- Read a contact's email history β messages between you and that contact are surfaced in the contact's profile.
- Automatically capture inbound mail β when a contact emails you, the message is logged as a CRM activity and you receive an in-app notification, powered by Microsoft Graph webhooks.
Scope of this integration: Outlook email only. Microsoft Calendar, Microsoft Contacts, and Microsoft/Entra ID sign-in/SSO are not part of this integration.
Prerequisitesβ
| Requirement | Details |
|---|---|
| Microsoft 365 / Outlook account | A personal Microsoft account (Outlook.com/Hotmail) or a Microsoft 365 work/school account. |
| Microsoft 365 admin consent (work accounts) | The permission User.Read.All may require admin consent in your organization's Azure AD tenant. Ask your IT admin to pre-approve the Minotaur app, or grant admin consent during the OAuth flow if prompted. |
| Minotaur account | You must be logged in to app.minotaursales.io and have access to Settings. |
Adding the Integration (Install & Connect)β
- Log in to app.minotaursales.io.
- Navigate to Settings β Connections β Emails.
- Click Connect Microsoft / Outlook.
- A new browser tab opens with Microsoft's authorization page. Select or log in to your Microsoft account and review the requested permissions:
- Read your profile (
User.Read,User.Read.All) - Read and send Outlook mail (
Mail.ReadWrite,Mail.Send,Mail.ReadBasic) - Maintain access when you're not using the app (
offline_access)
- Read your profile (
- Click Accept.
- The tab closes and Minotaur completes the connection. Your Outlook address now appears as a connected account in the Emails table under Settings β Connections β Emails.
Using the Integrationβ
Sending Email to a Contactβ
- Open any contact record.
- Click Send Email (or the email icon in the contact's actions).
- Your connected Outlook account is available as the sender.
- Compose your message (subject, body, attachments) and click Send.
- The sent email is logged as an email activity on the contact's timeline.
Replying and Forwardingβ
- Open an email thread in a contact's record.
- Use the Reply or Forward action to send directly from your Outlook account.
Reading a Contact's Email Historyβ
- Open a contact record and navigate to the Emails tab (or the activity timeline).
- Minotaur fetches messages from your Outlook inbox where the contact's email address appears, displaying them in the contact's profile.
Automatic Inbound Email Captureβ
Minotaur subscribes to your Outlook inbox via a Microsoft Graph change-notification webhook. When a contact emails you, the message is automatically logged as a CRM activity on the contact's record and triggers an in-app notification.
Inbound capture applies to messages from known contacts only (the sender's email must match a contact in Minotaur).
Removing the Integrationβ
- Go to Settings β Connections β Emails.
- Find your Outlook account in the table.
- Click the delete (trash) icon on that row and confirm.
- Minotaur removes the stored OAuth tokens for that account. Future emails and inbound capture for that address are disabled.
Note: Removing the connection in Minotaur does not immediately revoke the Microsoft Graph webhook subscription. To fully revoke access at Microsoft's end, visit Microsoft My Apps or your Azure AD Enterprise Applications list and remove Minotaur.
Troubleshooting / FAQβ
"This Outlook account is already connected" (error code 0067)β
Each Outlook address can only be connected once per user. Check your existing connections in Settings β Connections β Emails. To switch accounts, delete the current connection first.
My connection shows "Expired" or "Disconnected"β
Go to Settings β Connections β Emails, delete the expired connection, then click Connect Microsoft / Outlook again.
I'm prompted for admin consent during the OAuth flowβ
Your organization's Azure AD administrator has restricted third-party app access. Either:
- Ask your IT admin to pre-approve Minotaur in Azure Portal β Azure Active Directory β Enterprise Applications.
- During the OAuth flow, click Request approval and wait for your admin to grant consent.
Inbound emails are not being captured automaticallyβ
- The sender must be a contact already in Minotaur (their email must match a contact record).
- Microsoft Graph webhook notifications can have a delay of a few minutes.
- If you recently reconnected, allow a few minutes for the subscription to reactivate.
The Emails tab shows no messages for a contactβ
- Verify the contact has an email address that matches what is stored in Minotaur.
- Minotaur searches your inbox only. Messages in other folders (e.g., Junk, Archived) are not shown.
Data & Privacyβ
| Data type | How it is used |
|---|---|
| Microsoft OAuth tokens | Stored securely in Minotaur's database, scoped to your user. Used only to access Outlook on your behalf. |
| Microsoft profile (name, email address) | Displayed in the connected accounts table. Not shared externally. |
| Outlook messages | Fetched live from Outlook when you view a contact's emails. Sent/received messages are logged as CRM activities. Message content is not bulk-stored in Minotaur's database. |
| Microsoft Graph webhook subscription | Created in your Microsoft account to receive real-time inbox notifications. |
| Attachments | Transmitted via Outlook. Not stored in Minotaur. |
Supportβ
For help with this integration, contact Minotaur support:
- Email: support@minotaursales.io
- In-app: click the help icon in the bottom-left corner of app.minotaursales.io.