Link your Microsoft 365 account to ClickUp so you can send and receive emails within tasks.

What you'll need

• You need to be a Workspace owner or admin to enable the Email ClickApp.
• Guests can't use the Email ClickApp.
• Usage limits are determined by your plan:
  • Free Forever Workspaces get one free email account with 100 uses.
  • Unlimited Workspaces get one free email account with unlimited use.
  • Business Workspaces and above get two free email accounts, including signatures and email templates.
  • Business Plus and Enterprise Workspaces can use custom email permissions for admins and members.
• Each email account you add can automatically transfer up to 100 contacts into ClickUp.
• Microsoft 365 accounts can only send emails using the default name on your email account.

Required scopes

The following scopes must be approved by a Microsoft admin to send and receive emails from ClickUp tasks:

• Mail.Read
• Mail.ReadWrite
• Mail.Send
• Mail.Read.Shared
• Mail.ReadWrite.Shared
• Contacts.Read
• People.Read

If your team uses on-premises Microsoft Exchange, two additional scopes must be approved:

• ews.messages
• ews.contacts

Admin consent

When a user links their Microsoft 365 account, your organization's admin must approve the permissions ClickUp requests. The ClickUp app registration for the Email ClickApp uses this client ID: 5a2bb58c-ab39-4735-8a66-b98304f7489b.

This is separate from other ClickUp integrations registered in your Azure tenant:

• Outlook add-in: aaedd6ae-575a-4582-ba2b-7c114a26e870
• Planner and Calendar sync: dbaf1972-fb78-4b27-b943-be6f58e058d0

If your organization has disabled the admin consent workflow in Entra ID, consent requests won't queue for approval. An admin must grant permissions directly from Enterprise applications in the Azure portal.

Link your Microsoft 365 account

You can link your Microsoft 365 account from a task or your Workspace settings.

Link your Microsoft 365 account from a task

Members and above can link their Microsoft 365 account from a task:

1. In the lower-right corner of a task, click the comment field.
2. Click the Email tab.
3. In the From field, select Link an email. If there's already an email account linked, click Add new.
4. Click Sign in with Microsoft 365 and enter your credentials.
   • During the authorization process, you'll see a popup that lists the permissions ClickUp is requesting access to. This is a standard warning that Microsoft shows for any third-party integration with their accounts. Granting access to these permissions makes it possible for ClickUp users to view, send, and receive emails with Microsoft 365 inside ClickUp.
   • When adding your Microsoft 365 account to ClickUp, the permissions requested by ClickUp are tailored to the specific organization you are in.
   • Entra gov accounts cannot be authorized at this time.
5. Choose who can send emails from this account, create signatures, and create email templates.
6. Click Done.

Link your Microsoft 365 account from your Workspace settings

Admins can link their Microsoft 365 account from their Workspace settings:

1. In the upper-left corner, click your Workspace avatar.
2. Select Settings.
3. In the All settings sidebar, click Email Integration.
   
4. Click Sign in with Microsoft 365 and enter your credentials.
   • If an email has already been added, you must click Add new first.
   • During the authorization process, you'll see a popup that lists the permissions ClickUp is requesting access to. This is a standard warning that Microsoft shows for any third-party integration with their accounts. Granting access to these permissions makes it possible for ClickUp users to view, send, and receive emails with Microsoft 365 inside ClickUp.
   • When adding your Microsoft 365 account to ClickUp, the permissions requested by ClickUp are tailored to your specific organization.
   • Entra gov accounts cannot be authorized at this time.
5. Choose who can send emails from this account, create signatures, and create email templates.
6. Click Done.