How to Set Up Einstein Activity Capture with Gmail

Connect Gmail to Salesforce so customer email files itself on the Lead or Contact. Every setting in order, plus the Google admin step that blocks sign-in.

By Published

Einstein Activity Capture connects a Google Workspace mailbox to Salesforce and files each customer email on the matching Lead or Contact, so nobody has to log it by hand. The setup takes three people: a Google Workspace admin, a Salesforce admin, and the person who owns the mailbox.

This guide uses Gmail and one user, with contacts and calendar sync left off. Add users to the same configuration when the first mailbox checks out. If your reps' replies are landing in spam, fix that first with the SPF, DKIM and DMARC setup guide.

What you need before you start

  • A Salesforce edition and license that include Einstein Activity Capture. Salesforce lists the limits in its setup considerations.
  • A Salesforce admin who can assign permission sets and edit sharing settings.
  • A Google Workspace admin who can review third-party app access.
  • The user's primary Google Workspace mailbox. Connect the primary address and never an alias, and make sure it matches the email on their Salesforce user record.

Step 1: Allow Salesforce.com in Google Workspace

Do this first. Until a Workspace admin allows the app, every user who tries to connect lands on the screen below, and nothing on that screen lets them continue.

Google sign-in screen saying Access blocked, your institution's admin needs to review Salesforce.com, Error 400 access_not_configured
What the user sees when Salesforce.com has not been allowed. The mailbox address is covered. Source: Google sign-in screen, 11 Sep 2026.

In the Google Admin console, open Security, then Access and data control, then API controls, then Manage App Access. Find Salesforce.com and choose its access level. Google explains each level in Control which apps access Google Workspace data.

Apply the change to the organizational unit or group that holds your Salesforce users. Leaving the top-level unit selected applies it to everyone in the company. Leave your other Workspace security settings as they are, because this one change is all the error needs.

Step 2: Assign the license and the permission set

In Salesforce Setup, open Users, then Users, and click the person's name. Under Permission Set License Assignments, click Edit Assignments and add Standard Einstein Activity Capture User.

Permission Set License Assignments on a Salesforce user record with Standard Einstein Activity Capture User in the list
The license shows on the user record with the date it was assigned. Source: Salesforce Setup, 11 Sep 2026.

On the same record, under Permission Set Assignments, click Edit Assignments and add Standard Einstein Activity Capture. The user needs both. The license alone gives them nothing to use.

Permission Set Assignments on a Salesforce user record with Standard Einstein Activity Capture in the list
The permission set sits in its own list, above the licenses. Source: Salesforce Setup, 11 Sep 2026.

Step 3: Create the configuration and pick the users

In Setup, type Einstein Activity Capture in Quick Find and open Settings. On the Configurations tab, click New Configuration, or open the one you already have. A configuration is a named group of users who share the same sync rules.

  1. Give it a Name and a Description, and keep Active checked.
  2. Under User and Profile Assignments, set Search to Users and move each person from Available to Selected.
Einstein Activity Capture Edit Configuration window, General Settings tab, with one user in the Selected list
Only the users in Selected are captured. Start with one. Source: Salesforce Setup, 11 Sep 2026.

Salesforce prints a reminder on this screen that matters later: sync and capture work only when the user's mailbox address matches the email in their Salesforce personal settings.

Step 4: Choose what syncs

Scroll down the same tab to Review Settings. There are three switches, and Salesforce turns all three on for a new configuration.

  • Emails: on. Email is added to the activity timeline of the related records.
  • Events: off, unless you want Google Calendar events in Salesforce too.
  • Contacts: off, unless you want Google contacts and Salesforce contacts kept in step.
Review Settings in an Einstein Activity Capture configuration with Emails enabled and Events and Contacts disabled
Emails on, Events and Contacts off. The note under Emails says the messages are stored as Salesforce activity. Source: Salesforce Setup, 11 Sep 2026.

With Emails on, Salesforce turns on Sync Email as Salesforce Activity and Enhanced Email. Each captured message is saved as an email message record with a completed task, which is what makes it show in reports and flows. Those records count toward your data storage. Salesforce covers the trade-offs in Considerations for Sync Email as Salesforce Activity.

Step 5: Set how far back and how much of each email

Open the Advanced Settings tab of the configuration.

  • Filter by Sent Date: the number of days of earlier email to bring in when a user first connects. Set it to 0 to capture new email only.
  • Entire Email Message: the header, subject and body are captured.
  • Header Only: the sender, recipients, date and time are captured, and the subject and body are left out.
Advanced Settings tab of an Einstein Activity Capture configuration with Filter by Sent Date set to 0 days and Entire Email Message selected
0 days means no earlier email comes in. The two options under it decide whether the body is stored. Source: Salesforce Setup, 11 Sep 2026.

The Events and Contacts sections on this tab apply only if you turned those switches on in step 4. Click Save when both tabs are set.

Step 6: Set who can see captured email

Do this before the first mailbox connects, because email starts arriving as soon as it does. In Setup, open Sharing Settings and find Activity under Organization-Wide Defaults. Set Default Internal Access and Default External Access to Private.

Salesforce Sharing Settings, Organization-Wide Defaults table, with the Activity row set to Private for internal and external access
Activity set to Private in both columns. Source: Salesforce Setup, 11 Sep 2026.

Private keeps ordinary users to their own activity. Admins and anyone with broad data permissions can still open it, so check who holds those permissions before you store full message bodies.

Next, go back to Einstein Activity Capture Settings and open the Excluded Addresses tab. Click Add and enter your own company domain, which Salesforce lists as an Internal Domain. Email between colleagues then stays out of Salesforce. Add any outside address or domain that should never be captured, such as your law firm or your bank.

Excluded Addresses tab in Einstein Activity Capture settings listing one company domain with the type Internal Domain
The company domain listed as an Internal Domain. Source: Salesforce Setup, 11 Sep 2026.

On the Settings tab beside it, keep Prevent Automated Email Replies from Being Shared and Prevent Sensitive Emails from Being Shared turned on.

Step 7: The user connects their mailbox

The mailbox owner does this step, signed in to Salesforce as themselves. An admin cannot do it for them.

  1. Click your profile picture and choose Settings.
  2. Type Email and Calendar Accounts in Quick Find and open it under Connected Accounts.
  3. Click New Account and choose Google.
  4. Pick your primary company mailbox.
  5. Read what Google lists, then click Continue and Allow.
Google permission screen listing what Salesforce.com will be allowed to do with Gmail, Drive, contacts and calendar
Google lists Gmail, Drive, Contacts and Calendar even when Events and Contacts are off in Salesforce. The mailbox address is covered. Source: Google sign-in screen, 11 Sep 2026.

Google sends you back to Salesforce, where Google now shows under Your Connection. Salesforce's own steps are in Connect Your Email and Calendar to Salesforce.

Salesforce personal settings, Email and Calendar Accounts, showing a Google account under Your Connection
The connected account in the user's own settings. The mailbox address is covered. Source: Salesforce Setup, 11 Sep 2026.

Step 8: Check the connection

Back in Setup, open Einstein Activity Capture and then Status & Metrics. On the Connection Status tab, read three things.

  • Licensed Users and Configured Users match. A gap means someone has the license and is in no configuration.
  • Connected Account Status shows the user under Active, with 0 under Disabled and 0 under Needs Attention.
  • Initial Sync Status, further down the page, reads Complete.
Einstein Activity Capture Status and Metrics showing one licensed user, one configured user and one Active connected account
One licensed user, one configured user, one Active account. Source: Salesforce Setup, 11 Sep 2026.

Step 9: Prove it with one test email

Active means the account is connected. It does not mean an email has been filed, so send one and look.

  1. Create a test Lead whose email is an outside mailbox you control.
  2. From the connected company mailbox, send that address an email with a subject you will recognize.
  3. Reply once from the outside mailbox.
  4. Open the Lead and check its activity timeline for both messages.

Keep four results apart when you report back:

ResultWhat it meansWhere you see it
SentGmail accepted the messageThe Sent folder
ReceivedThe other inbox got itThe outside mailbox
CapturedSalesforce stored it as an email and a taskAn activity report, or the record
MatchedThe task is linked to the right Lead or ContactThe Lead's activity timeline

Salesforce says the first capture can take up to 24 hours. After that, new email usually shows on the record within minutes.

Every setting on one page

SettingWhere it livesValue in this guide
Salesforce.com app accessGoogle Admin, Security, API controlsAllowed for your Salesforce users
Standard Einstein Activity Capture UserUser record, Permission Set License AssignmentsAssigned
Standard Einstein Activity CaptureUser record, Permission Set AssignmentsAssigned
Selected usersConfiguration, General SettingsOne user to start
EmailsConfiguration, Review SettingsEnabled
EventsConfiguration, Review SettingsDisabled
ContactsConfiguration, Review SettingsDisabled
Filter by Sent DateConfiguration, Advanced Settings0 days
Email contentConfiguration, Advanced SettingsEntire Email Message
Activity default accessSetup, Sharing SettingsPrivate, internal and external
Internal DomainEinstein Activity Capture, Excluded AddressesYour company domain
Prevent Automated Email Replies from Being SharedEinstein Activity Capture, SettingsOn
Prevent Sensitive Emails from Being SharedEinstein Activity Capture, SettingsOn
Email and Calendar AccountsThe user's own SettingsGoogle connected, primary mailbox

When an email is missing

What you seeLikely causeWhat to check
Google shows Error 400: access_not_configuredSalesforce.com is not allowed in Google WorkspaceStep 1, with a Workspace admin
Account is Active, email is not on the recordThe address on the Lead or Contact differs from the address the person sends fromThe From address on the real message
Outbound email shows, the reply does notThe reply came from another address, such as the base address behind a Gmail plus-addressPut the real sending address on the record
Nothing from one company ever showsThe address or domain is excludedExcluded Addresses
Nothing shows for anyone on day oneInitial processingWait up to 24 hours, then recheck Status & Metrics
Email is captured and linked to no recordThe matching flow is offThe standard flow Activities: Match Email to Records is active
The same email shows twiceIt was also logged by handStop manual logging for connected users

Before you add the whole team

One mailbox is a setup task. A sales team is a decision about data, and four questions are worth answering before you add everyone to the configuration.

  • How much history comes in? Every day you allow under Filter by Sent Date is multiplied by every user who connects.
  • Who can read it? Activity sharing, the role hierarchy and broad permissions decide whether a manager can open a rep's customer email.
  • What stays out? Legal, banking, recruiting and personal addresses belong on the excluded list before day one.
  • What will you report on? Captured email is stored as tasks and email messages, so decide which reports and follow-up rules should count it.

Frequently asked questions

Why does Google say Access blocked when I connect Gmail to Salesforce?

Your Google Workspace admin has not allowed Salesforce.com yet. The screen shows Error 400: access_not_configured, and the mailbox owner cannot get past it. A Workspace admin reviews Salesforce.com under Security, Access and data control, API controls in the Google Admin console.

Does Einstein Activity Capture import old email?

Only as far back as you allow. The Filter by Sent Date setting on the configuration's Advanced Settings tab sets how many days of earlier email come in when a user first connects. Set it to 0 to capture new email only.

Can I capture email without syncing contacts and calendar events?

Yes. Emails, Events and Contacts are three separate switches under Review Settings in the configuration. Turn Emails on and leave the other two off. Google's permission screen still lists Gmail, Drive, Contacts and Calendar, because that screen does not change with your Salesforce settings.

Who can see the emails Einstein Activity Capture stores?

That follows your Activity sharing settings. With the Activity organization-wide default set to Private, ordinary users see their own. Admins and anyone with broad data permissions can still open them, so review your sharing model before storing full message bodies.

Why is an email missing from the Lead or Contact?

The usual causes are an address on the record that does not match the address the person really sends from, an excluded address or domain, a message sent before the mailbox was connected, or processing time. Salesforce says initial capture can take up to 24 hours.

Why do I see the same email twice on the timeline?

Someone logged it by hand after Einstein Activity Capture had already synced it. Salesforce warns that manual logging on top of automatic sync creates duplicate activity records.

Official references

GAT Solutions is an independent Salesforce consultancy. Salesforce and Einstein are trademarks of Salesforce, Inc., and Gmail and Google Workspace are trademarks of Google LLC.

Continue the decision

View all resources →

Free one-page review

Rolling email capture out to a sales team? Tell us where it stands.

A one-page written review within one business day: what is set, what is missing, and what to fix first.

Never send us a key or password.

See Salesforce managed services