Skip to main content

How to Integrate with Salesforce?

Yasin Berkay avatar
Written by Yasin Berkay
Updated yesterday

Getting Started

To enable efficient and reliable data exchange between Salesforce and Forward, the integration uses Salesforce’s Core API services and the custom Forward Salesforce App.
Before you begin, make sure the necessary permissions are in place and the app is installed correctly.

Salesforce Edition Requirement:
The Forward Salesforce App can only be installed on Salesforce Enterprise or Unlimited editions. Please verify that your organization uses one of these supported editions before proceeding.

Screenshot 2025-04-24 at 11.48.41.png

To check your Salesforce edition:

  1. Go to the Setup menu in Salesforce.

  2. Navigate to Company Settings > Company Information.

  3. Look for the Organization Edition field to see your current edition.

Note: To install and authorize the Forward integration, you must have System Administrator privileges in Salesforce.

Installation

  1. Log in to your Forward account, making sure to use the correct region for your organization.

  2. Go to the Integrations page.

  3. Switch to the Organization Integrations tab.

  4. Find Salesforce in the list and click the Connect button.

Screenshot 2025-04-24 at 11.14.15.png

When you click Connect, Forward will redirect you to Salesforce’s OAuth2 authorization flow. You’ll see a screen requesting permission for the integration.

  • If you're not already logged into Salesforce, you’ll be prompted to log in.

  • Make sure you are logged in as a System Administrator or another user with sufficient privileges to approve the connection.

After granting permission, Forward will receive access to Salesforce APIs via OAuth2.

This allows Forward to securely interact with your Salesforce data.

⚠️ Important: To complete the integration, you must also install the Forward Application Package in your Salesforce environment.

Forward Salesforce Integration Step 2.png

After completing the authorization step, return to the Integrations > Organization Integrations page in Forward.

You will now see a Settings button next to the Salesforce integration.
Click this button to view step-by-step instructions for installing the Forward Application Package in your Salesforce environment.

Forward Salesforce Integration Step 3.png

Step 1: Package Setup

For the installation of the application, you will be redirected to Salesforce to install the application by pressing the Install button.

Forward Salesforce Integration Step 4.png

After pressing the Install button, you must allow access to the Forward API addresses.

Forward Salesforce Integration Step 5.png

After pressing Continue, wait for the installation process.

Forward Salesforce Integration Step 6.png

Step 2: Region & Key Settings

Forward Salesforce Integration Step 8.png

After installing the application, you need to configure the region and security settings.

  1. Either click the link in Step 2 of the Salesforce instructions screen in Forward, or open the Forward app directly from Salesforce and navigate to the Configuration screen.

  2. On the Configuration screen, enter the Region and Key values provided in the instructions.

  3. Click Save to complete the setup.

Forward Salesforce Integration Step 9.png

Once this step is completed, all necessary settings will be in place to securely enable data exchange between Salesforce and Forward.

⚠️ Important: The integration will not work unless the Forward Application Package is installed. Without it, integration features will remain unavailable.​

Space Creation

You can create a Space directly from Salesforce without switching to Forward.
Spaces can be created based on either Lead or Opportunity objects. Once created, the Space and the related Salesforce record are mapped and synchronized.

Creating a Space via Lead

You can use Salesforce Flow to automatically create a Space on Forward for your Lead records.
The following fields are used by default when creating a Space from a Lead:

Object

Field

Is Required

Use of Forward

Lead

Id

YES

Mapping

Lead

FirstName

YES

Key Client

Lead

LastName

YES

Key Client

Lead

Email

YES

Key Client

Lead

Company

YES

Space

Lead

Website

NO

Space

LeadStatus

Status

YES

Space

LeadStatus

Id

YES

Mapping

User

Email

YES

Space

Opportunity

Id

NO

Mapping

Additionally, in the Flow action, you can dynamically set the Company Logo field using any field of your choice.

Note: When you set the Company Logo this way, the default Website field will not be used. Instead, the value you provide will be treated as the logo URL.

Make sure that the logo URL is publicly accessible — it must be a valid URL that can be reached by external services.

Creating a Space via Opportunity

You can also use Salesforce Flow to automatically create a Space on Forward based on your Opportunity records.
The following fields are used by default when creating a Space from an Opportunity:

Object

Field

Is Required

Use of Forward

Opportunity

Id

YES

Mapping

Opportunity

Name

YES

Space

Account

Name

YES

Space

Account

Website

NO

Space

User

Email

YES

Space

OpportunityStage

StageName

YES

Space

OpportunityContactRole

FirstName

NO

Key Client

OpportunityContactRole

LastName

NO

Key Client

OpportunityContactRole

Email

NO

Key Client

OpportunityStage

Id

YES

Mapping

Lead

Id

YES

Mapping

Product2 List

[Id, Name]

NO

Product

As with Lead-based Flows, you can dynamically set the Company Logo field in the Flow action using any field from the Opportunity object.

Note: When you do this, the default Website field is ignored. The value you provide will be treated as the logo URL.

Ensure that the logo URL is publicly accessible, meaning it must be a valid URL that external services can reach.

Status (Stage) Synchronization

Forward Spaces created from your Lead or Opportunity records may go through different status changes. To keep these changes in sync between Salesforce and Forward, you can use the Status Synchronization feature.


The following fields are used by default for status synchronization:

Object

Field

Is Required

Use of Forward

LeadStatus

Id

YES

Mapping

LeadStatus

MasterLabel

YES

Mapping

LeadStatus

ApiName

YES

Mapping

OpportunityStage

Id

YES

Mapping

OpportunityStage

MasterLabel

YES

Mapping

OpportunityStage

ApiName

YES

Mapping

Product Synchronization

Forward allows you to map, filter, and report your Spaces using your Salesforce Products. By syncing your products with Forward, you can deliver product-specific content within each Space.
With this synchronization:

  • Products are automatically assigned to Spaces created via Salesforce.

  • Any updates made to products in Salesforce are automatically reflected in Forward.

The following fields are used by default for product synchronization:

Object

Field

Is Required

Use of Forward

Product2

Id

YES

Mapping

Product2

Name

YES

Product

Also In Forward Space, you can use the products belonging to Space as variables in content editors.

Variable Usage

Forward provides microsite features for each Space, allowing you to personalize content using both static and dynamic variables.


You can use fields from the Lead and Opportunity objects in Salesforce as variables to dynamically populate content.
Only the fields used by Forward are accessed — no other fields or data are read or transferred unless they are specifically required.

How to Use Salesforce Variables in Space Templates

  1. In your Forward Space Template, open the Variables menu in any content editor.

  2. Select a field from the Salesforce Lead or Opportunity object.

  3. The selected field is added as a placeholder in the format { Salesforce.Object.Field }
    (e.g., { Salesforce.Lead.Address }).

  4. When you create a Space using the template, Forward reads the data from Salesforce and replaces the placeholders with actual values.

This enables you to generate a personalized Space without additional manual edits.

How It Works (Behind the Scenes)

  • When you open the Variables menu, Forward reads the object structure and available fields from Salesforce — no data is read at this stage.

  • Field selections are stored as annotations in the template.

  • Only during Space creation, Forward reads the actual field values and injects them into the content.

  • The data flow is one-way: from Salesforce to Forward. Any changes made in Forward do not affect your Salesforce data.

Custom Fields and Extended Use

You can also use custom fields from Salesforce.
If you want to use fields from custom objects that are linked to Leads or Opportunities, please contact the Forward Support Team for setup assistance.

Available Salesforce Objects for Variables

You can reference the following Salesforce objects when using variables in templates:

Object

Reference

Lead

Owner

Lead

RecordType

Opportunity

Owner

Opportunity

RecordType

Opportunity

Account

Account

RecordType

Things to Consider

  • All fields used in your Space Template must be related to the record type you're creating the Space for.
    For example: If you use Opportunity fields in a template but create a Space based on a Lead, the variable values will remain empty.

  • Using too many variables in a Space Template may affect performance and slow down Space creation.

Custom Objects & Fields

When the Forward Salesforce Application Package is installed, it automatically creates the following custom components:

  • A custom field called Forward_Space_Url__c on both the Lead and Opportunity objects.
    After a Space is created, this field is populated with the Space URL, allowing users to open the Space directly from Salesforce with a single click.

  • A custom object called ForwardSettings__c, which stores configuration and integration settings.

⚠️ Important: These custom fields and objects are essential for the integration to function properly.

Do not delete or modify them under any circumstances.

Actions

With the installation of Forward Salesforce Application, Space Creation actions are available for your use in Flow. You can create Space on Forward for Lead & Opportunity using these actions.

Create Space For Leads
For example, let's create a Flow on Salesforce to create Space when a Lead record is created.

Open the Flows page.

Forward Salesforce Integration Step 10.png

Click the New button to create a new Flow.

Forward Salesforce Integration Step 11.png

There are many different Flow types on Salesforce. Since the example we will make needs to be triggered with a record, we will continue with the “Record-Triggered Flow” option.

Forward Salesforce Integration Step 12.png

After creating your Flow, click the Edit button on the Start node. In the screen that opens, select Lead as the object and choose "A record is created" as the trigger.

Since all actions related to Forward must run asynchronously, enable the option "Include a Run Asynchronously path to access an external system after the original transaction for the triggering record is successfully committed" in the Optimize the Flow for section.

Close the settings panel by clicking the “X” button. Then, click the “+” button under the Run Asynchronously path to add the necessary Flow actions.

Forward Salesforce Integration Step 13.png

From the drop-down menu, you can quickly find Forward actions by searching for “Create Space”.
There are two separate actions available: one for creating a Space from a Lead, and another from an Opportunity.

Select the action that matches the object you are working with. Since this example is based on a Lead, choose the "Create Space For Lead" action to proceed.

Forward Salesforce Integration Step 14.png

After selecting the action, the configuration screen will open. This screen includes default fields such as Label, API Name, and Description. In addition to these, the action requires specific parameters to function properly.

You will see fields like Lead Id, Logo URL, and Template Id, each serving a distinct purpose:

Forward Salesforce Integration Step 14.png
  • Lead Id: This is a required field that identifies which Lead record the Forward Space will be created from. Without this value, the Space cannot be generated.

  • Logo URL: This optional field allows you to set the Company Logo in the created Forward Space. You can populate it using a field from the Lead or a related object. The value must be a publicly accessible URL. If left blank, Forward will attempt to find the company logo using the Website field on the Lead.

  • Template Id: This optional field lets you create the Space using a specific Forward Space Template. Simply enter the template’s ID. If you leave this blank, the Space will be created as an empty shell, without pre-filled content.

Forward Salesforce Integration Step 15.png

After completing the configuration, save and activate the Flow. Once activated, a Forward Space will be created automatically whenever a new Lead record is created.

By using Salesforce Flow, you can create Forward Spaces tailored to any use case your organization requires, offering full flexibility in how and when Spaces are generated.

Did this answer your question?