You are here:
Get Users from Email Addresses Action
This action gets user records with email addresses that match those addresses in the To, From, or CC address field of a sent email captured by Einstein Activity Capture. To be used in the Activities: Match Email to Records flow. Requires that Sync Email as Salesforce Activity is enabled in Einstein Activity Capture.
Required Editions
| Available in: Lightning Experience |
| Available with Einstein Activity Capture Standard in Sales Cloud in Starter, Professional, and Enterprise Editions |
| Available with Unlimited Edition and Einstein 1 Sales Edition |
| Available with Einstein for Sales, which is included in Einstein 1 Sales Edition, and available for an extra cost in Enterprise and Unlimited Editions. |
| Available with Sales Engagement in Sales Cloud, which is included in Performance and Unlimited Editions, and available for an extra cost in Professional and Enterprise Editions. |
| Available with Revenue Intelligence, which is available for an extra cost in Enterprise and Unlimited Editions. |
In Flow Builder, add an Action element to your flow. In the New Action window, search for Activities Match, and then select Get Users from Email Addresses.
Set Input Values
Use values from earlier in the flow to set the inputs for the action.
| Field | Description |
|---|---|
| Activity ID | Optional. The ID of the email message to associate with the specified user records. |
| CC Address List | Optional. The comma-delimited list of email addresses of recipients who were sent a carbon copy of the email message. |
| From Address | Required. The email address that the email message was sent from. |
| To Address List | Required. The comma-delimited list of email addresses of recipients who were sent the email message. |
Store Output Values
| Field | Description |
|---|---|
| Matched Users | The collection of active user records that have an email address in the From, To, or CC address list. |
| Unmatched Email Addresses | The collection of email addresses that don’t have a matching active user record. |
Error Conditions
| Error Condition | Description |
|---|---|
| A To, From, or CC email address is invalid | The value isn’t a valid email. Check the email address format and try again. Error Code: INVALID_EMAIL_ADDRESS |
| The number of To or CC email addresses exceeds the limit | Specify a comma-delimited list that contains no more than 250 email addresses. Error Code: LIMIT_EXCEEDED |
Usage
To use this action, you must enable Sync Email as Salesforce Activity. The action is designed mainly to be used within the Activities: Match Email to Records flow.
How It Works
This action uses as input a list of email addresses from a sent email captured automatically by Einstein Activity Capture or Inbox. The action queries the Email field in User records that have these criteria.
- Active user
- Not an API-only user
- Standard user type
- User logged in within the last 365 days
If an email address doesn’t have a corresponding user record and has an internal domain, then the action ignores the email address and doesn’t include it in output. Internal domains are configured in Einstein Activity Capture settings.
You can choose to use the addresses in Unmatched Email Addresses in other actions for further processing, such as matching them to contacts or leads.
Tiebreakers
If an email address matched more than one user record, then all matching user records are stored in Matched Users in output. To add tiebreaker logic, consider using custom Apex code.
Limitations
This action is limited to usage within a flow. It can't be invoked through other methods such as Apex, REST API, Copilot, Prompt Studio, or Einstein Bots. While actions can typically be invoked through various frameworks like InvocableActionService, this specific action is restricted solely to Flow.
If the activityId field is empty when debugging this action, use the Developer Console to query StagedEmail for a value.
