Installation Guide

Get Started with FlowRunner

Follow these steps to set up FlowRunner for your organization. The entire process takes about 10-15 minutes.

Installation Overview

1

Salesforce Package

Install the managed package in your Salesforce org

2

FlowRunner Admin

Create your account and connect your Salesforce org

3

Outlook Add-in

Install FlowRunner from Microsoft AppSource

Step 1 Salesforce Admin Required

Install the Salesforce Managed Package

The FlowRunner package creates the necessary components and enables secure communication between your Salesforce org and the Outlook add-in. This must be installed by a System Administrator.

Installation Link

Click below to install in a production Salesforce org (replace "login" with "test" in the URL for Sandbox):

Install Salesforce Package

FlowRunner will become available on the Salesforce AppExchange in the future.

Installation Steps:

  1. 1 Log in to Salesforce as a System Administrator
  2. 2 Open the installation URL in your browser
  3. 3 Select "Install for All Users"
  4. 4 Click Install and wait for the confirmation message
Step 2

Configure FlowRunner Admin

Create your FlowRunner admin account, connect to Salesforce, and select which flows should be available to your users.

A Create an Admin Account

Sign up for FlowRunner using your Microsoft work account. The first user from your organization automatically becomes the administrator.

Create Admin Account

B Connect Your Salesforce Org

From the FlowRunner admin dashboard, click "Connect Salesforce Org" and authenticate with the Salesforce org where you installed the package.

You'll need to log in with a Salesforce account that has appropriate permissions to authorize connected apps.

C Approve Domain Whitelisting

FlowRunner needs permission to set the IframeWhiteListUrlSettings session variables. This allows the domains flow-runner.com and outlook.office.com to securely render your Salesforce Flows.

Important: This is a one-time approval that enables Lightning Out 2.0 to work within Outlook.

D Select Available Flows

After connecting, FlowRunner will retrieve all Screen Flows from your org. Select which flows should be available to your Outlook users.

Best Practice: Contact Record Collection Variable

To get the most out of FlowRunner, your Screen Flows should include a Contact record collection variable named:

contactsFlowRunner

FlowRunner automatically passes the email recipients as Contact records into this variable, allowing your Flow to immediately work with the right context.

Step 3

Install the Outlook Add-in

The final step is to install the FlowRunner add-in from Microsoft AppSource. This can be done by individual users or deployed organization-wide by your Microsoft 365 administrator.

Microsoft AppSource

Install FlowRunner directly from the Microsoft AppSource marketplace:

Open in AppSource

For Individual Users

  1. 1 Open Outlook (web, desktop, or mobile)
  2. 2 Go to Get Add-ins from the ribbon or settings
  3. 3 Search for "FlowRunner" and click Add

For Organization-Wide Deployment

  1. 1 Open the Microsoft 365 Admin Center
  2. 2 Navigate to Integrated Apps
  3. 3 Click Deploy Add-in and search for FlowRunner

Optional Configuration

Demo Flow Template

Get started quickly with our best-practice Flow template. Import it into your org and customize it to your needs.

The template demonstrates how to use the contactsFlowRunner variable and includes common sales use cases.

Pre-approve User Access

For a seamless user experience, configure the External Client App (ECA) in Salesforce:

  • Set the ECA policy to "Admin Pre-approved"
  • Assign the "FlowRunner User" permission set to the ECA
  • Assign the permission set to your end users

Need Help?

Our team is here to help you get FlowRunner up and running. Don't hesitate to reach out if you have any questions.