# Outlook and Microsoft 365

> Artavolo works with Outlook through each person's own Microsoft account (work, school or personal). There are three parts:

Source: https://artavolo.com/docs/outlook

Artavolo works with Outlook through each person's own Microsoft account (work, school or personal). There are three parts:

- **A calendar, both ways.** On a calendar view, **Sync with Outlook** keeps the table's records and one of your Outlook calendars in step. A record with a date is an event: rename it, move it or clear its date, and the event follows. Move, rename or add an event in Outlook, and the record follows. A date alone is an all-day event; a date with a time is a timed one. The sync runs every few minutes, and **Save and sync now** runs it at once.
- **E-mails from a folder.** In any view, **E-mails from Outlook** turns the e-mails that arrive in one of your Outlook folders into records of the table: the subject, the text, the sender and the files go into the fields you pick. Each e-mail is taken once. A sender who is a contact of the base's client portal is linked to the record and gets its replies.
- **The Outlook add-in.** **Save to Artavolo** on an open e-mail, in Outlook on the desktop, the web or a phone, adds it to a table you pick, the same way.

Each person connects their own account, and a sync writes as them, with their permissions. Artavolo asks Microsoft for their calendars (read and write), their mail (read only) and offline access, and keeps the refresh token encrypted. **Disconnect** forgets the account and stops its syncs.

## For the administrator: the Microsoft app

Connecting uses the same Microsoft app as signing in with Microsoft (see [Single sign-on](https://artavolo.com/docs/sso.md)).

1. In the Microsoft Entra admin center, open the app registration whose client ID and secret are in Artavolo's sign-in settings (or register one: any organization's accounts and personal accounts).
2. Under **Authentication**, add the redirect URI `https://your-artavolo/microsoft/callback` (type Web).
3. Under **API permissions**, add the Microsoft Graph delegated permissions `offline_access`, `User.Read`, `Calendars.ReadWrite` and `Mail.Read`. A work tenant may need an administrator to grant consent once.

The cron (`site/cron.php`) runs the syncs; it must run every few minutes, as it already does for other jobs.

## The Outlook add-in

1. Each person creates an API token in Artavolo (their account, API tokens).
2. In Outlook, open **Get Add-ins**, then **My add-ins**, **Add a custom add-in**, **Add from URL**, and give `https://your-artavolo/outlook/manifest.xml`. A Microsoft 365 administrator can instead deploy it to everyone from the admin center (Integrated apps, upload the manifest).
3. On an open e-mail, **Save to Artavolo** asks for the token once and keeps it in Outlook for that person. Then it lists the tables they can add records to.

The add-in fills the same fields as the table's e-mail address (**Requests by e-mail** in a page's settings, see [E-mail in](https://artavolo.com/docs/mail-in.md)); without one, the subject goes into the primary field.
