Salesforce #1: Authentication, Connecting AF with SF

Before Award Force and Salesforce can start to share data, a connection between the two systems needs to be established and authorised, we achieve this by creating an integration. An integration is a vehicle used to allow Award Force and Salesforce to talk to each other.

The following steps take you through the process of establishing an integration in Award Force to share data with Salesforce. This article does not show you how to pair data between Award Force and Salesforce.

How to create an initial integration with Salesforce
  1. Go to Settings > Integrations
  2. Click on the "New integration" button
  3. From the initial configuration screen, give the integration a name and select the Salesforce app from the App drop-down field
  4. Save
    • Saving the integration will refresh the screen and show additional options
  5. Authenticate your connection between Award Force and Salesforce. See below for continued steps.
Authenticating your connection with Salesforce

Authenticating the connection between the two systems is where you are giving permission for Award Force and Salesforce to share data.

  1. Using the same browser, in a different tab, log in to your Salesforce account if you haven't already

    Note: You need to have admin access to your Salesforce account

  2. From Award Force, in the new Salesforce integration you created earlier, click the "Authenticate" button
  3. Save
    • Saving queries your Salesforce account to establish a partnership between the two programs
    • If successful, you will see a message on screen saying "Integration successfully authorised" and your configuration view will update with more options
    • These additional options allow you to pair data between Award Force and Salesforce based on certain automated actions in Award Force
Creating additional integrations with a dependency

A dependent integration is an integration relying on the authenticated relationship of another integration.

  1. Ensure you have one integration already created and authenticated with your Salesforce account
  2. Create a new integration
  3. From the initial configuration screen, give the integration a name and select the Salesforce app from the App drop-down field
  4. Save - this saves your new integration and refreshes the screen with additional options
  5. After the integration is saved and the screen refreshes, select the previous integration you created earlier of which is already authenticated.
  6. Save
    • Saving will establish a partnership between the two programs, however, the partnership is reliant (dependent) on the first integration being authenticated.
    • If successful, your configuration view will update with more options
    • These additional options allow you to pair data between Award Force and Salesforce based on certain automated actions in Award Force

Important tips

You will only ever need to authenticate one integration, even if you need more integration stages. You are limited to how many authenticated integrations you can have (currently 5), but you are not limited to how many dependency integrations you can have. A dependent integration simply means it's relying on another integration that is already authenticated, mitigating the need to authenticate consecutive times. It's important to keep in mind that dependent integration stages can only execute if the first authenticated stage has already been successfully executed by one of the automated actions.