Skip to main content


Salesforce provides customer relationship management (CRM) software and offers a complementary suite of enterprise applications. Their offerings are generally focused on customer service, marketing automation, analytics, as well as application development, business intelligence, and many others.

Authenticate with Salesforce

To use Salesforce in Tonkean, you must first connect it as a data source:

  1. Select the main nav icon, grid.png, in the upper left and select Enterprise Components. The Enterprise Components screen displays.

  2. Select + New Data Source in the upper right.

  3. Select Cloud Application. The Add New Data Source window displays.

  4. Enter "Salesforce" in the search field, then select Salesforce. The New Salesforce Connection window displays.

  5. Select Create a new connection. The Set Up Data Source window displays.

  6. Select Authenticate with Salesforce. A new window opens where, depending on whether you're currently logged in to your Salesforce account, you are asked to log in using oauth or asked to allow Tonkean access for your account. Select Allow.

  7. Once authentication is complete, the Set Up Data Source window displays the Salesforce webhooks field. If you don't want to configure a connection to Saleforce using a webook now, select OK.

Your Salesforce account is connected to Tonkean. Be sure to provide the relevant solutions access to this data source.

Connect Salesforce using a Webhook

For workflows in Tonkean that run as close to real-time as possible, we recommend connecting Salesforce using a webhook. A webhook connection allows Salesforce to send updates to Tonkean as they happen, so Tonkean doesn't need to send an API call at a fixed interval. This configuration generally makes solutions more responsive and less likely to encounter any API rate limits you may have.

To connect Salesforce using a webhook, follow the steps below:

  1. Copy the webhook URL in the Set Up Data Source window.

  2. Navigate and log in to your Salesforce account. Then, select the Setup icon in the upper right. The Setup screen displays.

  3. In the sidenav, scroll down to the Platform Tools section. Select Process Automation > Workflow Rules. The Workflow Rules screen displays.

  4. Select New Rule. The New Workflow Rule screen displays.

  5. Select the Object dropdown and select the object (usually called an "entity" in Tonkean) the workflow applies to. Then, select Next.

  6. Enter a Rule Name for the field, and, if desired, a Description of the rule.

  7. In the Evaluation Criteria section, for the Evaluate the rule when the record is field, select created, and every time it's edited.

  8. In the Rule Criteria section, make the following selections:

    • Field - Opportunity: Opportunity Name

    • Operator - not equal to


    When finished, select Save & Next.

  9. Select Add Workflow Action and New Outbound Message. The New Outbound Message screen displays.

  10. Enter a Name and Unique Name for the outbound message.

  11. Paste the copied webhook URL generated in Tonkean into the Endpoint URL field. When finished, select Save. The Edit Rule Name displays, and you should see the workflow action you created.

  12. Select the Description of your new rule. The Outbound Message screen displays.

  13. In the Workflow Rules Using This Outbound Message section, select Activate. The All Workflow Rules screen displays.

  14. If you selected any additional objects (entities), repeat steps #4-13 for each object.

Your Salesforce account is connected to Tonkean using a webhook. The addition of or updates to the specified objects in Salesforce now update Tonkean.

Salesforce Permissions

When you connect a Salesforce account to Tonkean, it's important to note that all of the permissions in Salesforce (that is, create, edit, read-only) are mirrored in Tonkean. A user is able to create or update in Tonkean anything they are able to create or update in Salesforce.

Considering these equivalent permissions, make sure that the account you connect has the authority to perform all the actions your process requires in Tonkean while also being careful not to give Tonkean more access to Salesforce than is necessary.

You can manage user permissions in Salesforce using Profiles and Permission Sets.

Currently, you can only use a webhook to connect to Salesforce instances that are Enterprise Edition and higher. You may connect using a webhook to the Professional Edition, but only if you've required API access from your Salesforce account manager.

Monitor Salesforce as an Intake Source

Like most data sources, you can use Salesforce as the module intake source:

  1. After creating a new module, select the item tile. The Item Details panel displays.

  2. In the Select Intake Source section, select External Data Source. The Select Data Source section displays.

  3. Select the Salesforce data source you want to connect as the intake source. The connection configuration screen displays.

  4. Select the entity you want to collect, where relevant.

    Salesforce entities include all available objects in Salesforce (for example, Accounts, Cases, and Opportunities).

  5. By default, Tonkean collects all entities of the selected type. If you want to filter the entities the module monitors, configure the conditions for the conditions group.

    When setting up a new intake source, we recommend always adding a custom filter instead of monitoring all entities of the selected type. This ensures there's a smaller amount of data to monitor and respond to. For example, you might configure the module to monitor only Opportunities in the Needs Analysis stage.

  6. Select who to set as the creator of the items synced from the data source:

    • The default actor of this module - The module actor, configured in the module settings. For more information about configuring the module actor, see Configure Module Settings.

    • Specific person - Select a specific user from your board.

    • Custom email - Enter a custom email. Enter the email address manually or dynamically create the address by selecting the insert field button, insert_field.png, and using existing fields from your module.

  7. When finished, select Save in the upper right.

Your module is monitoring Salesforce as an intake source and displays in the Item Details panel.


Use Salesforce as an Action

In addition to monitoring a Salesforce instance, you can use actions to update and create new records in Salesforce based on triggers you create. To add a Salesforce action block, perform the following steps:

  1. On the module builder screen, add an action by selecting the plus icon, add_block.png, to the right of the Do arrow in your work flow. A new action block is created and the Action Block panel displays.

  2. Scroll down to the Data Actions section and select the Salesforce action. The Salesforce action panel displays.

  3. Configure the fields to perform any action relevant to your workflow, including creating or updating specified entities, updating the status of a case, or even using a custom data source action.


You're leveraging Salesforce as an integrated part of your module workflow.