Skip to main content

Overview

Enrich people and organization objects in Ortto and keep them up-to date with changes from your data warehouse. This destination also empowers you to customize your audiences by subscribing or unsubscribing people from them based on custom criteria.

Supported syncing

Connect to Ortto

Connecting Ortto to Hightouch requires an Ortto API Key. You can retrieve it by following these steps:
  1. Navigate to Data sources under More in the Ortto UI.
  2. Create a new data source by selecting Custom API (advanced).
  3. Enter an API name, for example “Hightouch.”
  4. Copy your Private API key into Hightouch.
  5. Select the region of your Ortto instance from the dropdown menu.
If you need further details on creating an Ortto API key, check out the Ortto documentation.

Syncing data

Hightouch supports syncing to the following to Ortto people, organizations, and audiences. You need to setup a separate sync for each object type you want to sync to.

People

You can upsert, update, or insert people in Ortto based on records in your query results.

Record matching

You can match rows in your model with people on the following fields:
  • Email
  • External ID

Field mapping

You can sync columns from your query results to people’s default and custom fields.

Delete behavior

You have the following options for how Hightouch should handle rows leaving your query results:

Organization

You can perform upsert or insert organizations in Ortto based on records in your query results.

Record matching

You can match rows in your model with organization on the following fields:
  • Name
  • Website

Field mapping

You can sync columns from your query results to an organization’s default and custom fields.

Audiences

Subscribe people to audiences in Ortto when records for them appear in your query results.

Record matching

You can match rows in your model with people in Audience on email only.

Delete behavior

Records that no longer appear in your query results are unsubscribed from Ortto audiences.

Tips and troubleshooting

To see the exact API requests and responses from each sync run, use the live debugger. To get notified by Slack, PagerDuty, SMS, or email when a sync fails, set up sync alerts. If you run into an issue this page doesn’t cover, .
Last modified on November 16, 2023