Microsoft 365 permissions and settings

Microsoft 365 permissions and settings

Open Settings → Integrations → Microsoft 365 → Settings. Owners and admins
manage this workspace’s connection; members use the sources they can access.

Connect and grant access

Choose Connect or Manage on the Microsoft 365 row, then grant the access
your workspace needs. The Calendars and Files tabs offer missing read
permissions; Grant beside a permission in Settings does the same job.
Each consent adds to the same connection. Use the same Microsoft account.

Permission Why twelfth asks for it
Outlook calendars — Calendars.Read Read events in calendars the connected account can see.
OneDrive and SharePoint files — Files.Read.All Read documents and Excel worksheets the account can open.
Optional Excel writes — Files.ReadWrite.All Add and fill a template worksheet when an admin requests it. It is asked for separately from the read connection.

The write grant is broader than one worksheet: Microsoft permits writing files
the connected account can access. twelfth uses it for the requested Excel
calendar and target templates. It does not enable outbound Outlook event sync.
See Microsoft’s permission reference.

Grant Excel template access

In Settings → Calendars, choose an Excel workbook source and
Start with a new tab. If write access is missing, choose Let twelfth add
the worksheet
and complete the separate Microsoft consent screen. Return to
finish the setup. You can also add the worksheet yourself and link it read-only.

A linked target plan uses that same write grant when creating its template. To work without it,
download a target template, add it to Excel yourself, and link the
existing worksheet.

If your tenant requires admin approval

If Microsoft refuses consent because of your organisation’s policy, twelfth
shows an admin consent link. Send it to your Microsoft 365 administrator.
Once approved, return and connect again. Tenant approval and permission to
manage the twelfth workspace are separate requirements.

Who this reads as

There is one connected account for the whole workspace, not a separate account
per buyer. twelfth reads files and events as that account.

The account’s own OneDrive files are marked Personal OneDrive in file
pickers and linked-file lists. The badge does not prevent linking them. To keep
personal files outside the connection’s reach, use an account with access only
to the team locations you intend to use.

A workspace admin can link context files anywhere; a remit owner can link
within their own remit. A linked file is then readable by people who can read
its workspace or remit scope. Check that scope before linking.

Disconnect

Use Disconnect in the Settings tab’s danger zone. This removes the stored
connection for the whole workspace. Outlook and Excel sources stop loading,
and Microsoft context snapshots are cleared. Files and events in Microsoft
365 are not deleted. Reconnect to restore access.

When something cannot be opened

Message or symptom Next step
Microsoft refused the credential Reconnect Microsoft 365 with the intended account.
The account cannot open a file Give that account access in Microsoft, then check again. Granting twelfth a scope does not give the account access to a new library.
File not found Check the link and whether the file was moved or deleted.
Missing worksheet write permission Use the calendar worksheet setup above, or create the template yourself.
Rate-limited or temporarily unavailable Try again shortly.