Skip to main content

Create a Matched Entity

In order to create a matched entity, the data source you want to link to must already exist in Tonkean. For example, if you want to create a matched entity that links a field in an incoming email to a field in Salesforce, that Salesforce instance must already be a connected data source.

  1. From any screen, select the main nav icon, grid.png, in the upper left and select Solutions Studio. The Solutions Studio screen displays.

  2. Select the module you want to create the matched entity in. The module builder screen displays.

  3. From the module builder screen, select the Fields button on the module builder toolbar. The Fields panel displays.

  4. In the Matched Entities section, select + Add Matched Entity. The Matching Field Settings screen displays.

  5. Enter a name for the matched entity.

    If you don't name the matched entity, the name defaults to the name of the selected data source.

  6. Select the data source you want to create a matched entity for. In this example, we're creating it for a Google Sheets spreadsheet.

  7. Select the data source entity type. The Match by section displays.

    For some data sources, only one entity type displays. For example, Google Sheets has only one entity type (Row), while other data sources, like Salesforce, have Accounts, Opportunities, and Leads, among others.

  8. Select Search data field to locate and select a field in the matched data source. This is the field that you're matching to a field in the intake source. In the example below, we're matching an email address from the Google Sheet, so we select the corresponding column in the table.

  9. Select the condition. The condition defines the interaction between the two selected fields. The field default is Equal to, as shown in the example below.

  10. Select the insert field button, insert_field.png, and select the field from the intake source to match with the field from the matched entity data source. In the example below, we're matching the Email column from the Google Sheet to Emails - From (Email) in the email inbox intake source.

    These fields must already exist for the intake source before they appear in this dropdown.

  11. In the case that multiple items match the specified conditions, you can configure how Tonkean will prioritize and select from the available matches:

    1. Select Order by to select a field in the matched entity data source to sort the matches by.

    2. Select the Order dropdown to select to order the multiple matches in Ascending or Descending order.

    3. Select the Order field type dropdown to select the field type to sort by.

  12. When finished, select Save in the top right. The matched entity is ready to use anywhere in the module.

Add Matched Entity Fields

Once a matched entity is added to a module, you must select the fields from the matched entity data source before you can use them in the module workflow.

  1. In the Fields panel, locate the relevant matched entity in the Matched Entity section.

  2. Select + Add Field. The field selection window displays.

  3. Select all the fields to include in the module. When finished, select Add Selected.


The fields from the matched entity data source are added and available for use in the module workflow. You can now access these fields as you would any other field in Tonkean. They're available for use in numerous actions and triggers.