Connecting your Outlook calendar
How to connect your Outlook or Microsoft 365 calendar to Magic CRM, what is sent to it and read from it, how your access is protected, and how to disconnect.
Each person connects their own Outlook or Microsoft 365 calendar, once. From then on, the meetings assigned to you in Magic CRM are events in your calendar, and they stay in step in both directions: move a meeting here and it moves in Outlook; move or delete it in Outlook and it changes here.
Connecting
- Open Settings → Calendar.
- Choose Connect Outlook calendar. Microsoft opens and asks you to sign in and agree that Magic CRM may read and write your calendar.
- Accept. You come back to Settings, which says Connected to the account you chose.
When you connect, your open meetings that have not ended yet are added to the calendar. Past meetings are not.
- If Microsoft refuses. Some organizations let only their Microsoft administrator approve an app that reaches calendars. If you did not decline the consent yourself, ask your Microsoft administrator to approve the app, then try again.
- If it took too long. The connection has to be finished in the same browser, within a few minutes. Start again from Settings.
- If you do not see Calendar under Settings, calendar sync is not available in your installation.
Connecting is personal. Nobody else in your organization, an administrator included, is shown whether you have connected a calendar.
What is sent to Outlook
Only meetings, and only to the calendar of the person they are assigned to. A plain task has a due date, not a time, and is never sent. A meeting with no assignee, or whose assignee has not connected a calendar, is in no calendar.
| In Magic CRM | In your Outlook calendar |
|---|---|
| A meeting is created, or a task becomes a meeting | An event is created |
| Its title, start, end or place changes | The event is updated, with only what changed |
| It is reassigned | It moves from one person’s calendar to the other’s |
| It is archived, turned back into a task, or unassigned | The event is deleted |
| It is marked done | Nothing: it stays where it was |
- Four things are kept in step: the title, the start, the end and the place.
- The description is sent once, when the event is created, and never again. You can paste a call link into the event in Outlook without it being overwritten.
- On the meeting’s page, everyone in the organization sees whose Outlook calendar it is in. If a meeting could not be sent, only its assignee is told why, with Try again. Anything that could not be sent is also listed under Settings → Calendar.
What is read from Outlook
Changes to the meetings Magic CRM put in your calendar.
- An event moved, renamed or given another place: the meeting here follows.
- An event deleted or cancelled: the meeting here is archived, and an administrator can restore it.
- An event made into a recurring series: the meeting stops following it and says why, because a meeting here is one occasion.
When the same detail is changed on both sides before they meet, the later change stands, and the other is kept in the meeting’s history. Changes that come from Outlook show in the history as made by Calendar sync.
The rest of your calendar, for you alone. Your other Outlook events are shown on Today beside your tasks and meetings, so you see your whole day. Only you see them: not a colleague, not an administrator, and not the AI assistant. Nothing is written back to these events.
- Private events are kept without their title or place. Today shows them as Private, to you too.
- Linking. Choose Link on an Outlook event to make it a meeting on a deal, a company or a person, assigned to you. It stays in your Outlook and is followed both ways from then on. Private, all-day and recurring events cannot be linked.
Events are read from thirty days back to two years ahead.
How your access is protected
- Your calendar is reached with your own consent. Magic CRM asks Microsoft for access to your calendar and for the name of the account, nothing more.
- The access tokens are encrypted. The tokens Microsoft gives us are encrypted by Magic CRM with a key that is not stored in the database. A copy of the database alone would hold only unreadable data. No person’s screen and no AI assistant can read them, your own included.
- The calendar sync has its own account, limited to the organizations where someone has connected a calendar.
More in Security.
Disconnecting
- Open Settings → Calendar.
- Choose Disconnect, and confirm.
The connection and its tokens are deleted at once. The events already in your calendar stay there and are no longer followed, and your other Outlook events are no longer shown on Today.
If Microsoft stops accepting your consent, Settings says the calendar stopped syncing. Choose Connect again to resume.