> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hightouch.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Ortto

> Ortto brings the customer data platform, customer journey marketing, and customer journey analytics together to grow your SaaS business.

## 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

| Sync Type | Description | Supported Sync Modes |
| - | - | - |
| **Person** | Sync records to Ortto [people](https://help.ortto.com/user/latest/people/) | Upsert, Update |
| **Organization** | Sync records to Ortto [organizations](https://help.ortto.com/user/latest/organizations/) | Upsert, Insert |
| **Audience** | Subscribe or unsubscribe people from [audiences](https://help.ortto.com/user/latest/audiences/) | Insert |

## 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](https://help.ortto.com/user/latest/data-sources/configuring-a-new-data-source/other-integrations/custom-api.html).

## Syncing data

Hightouch supports syncing to the following to Ortto [people](#people), [organizations](#organizations), and [audiences](#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](https://help.ortto.com/user/latest/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](https://help.ortto.com/user/latest/people/) default and custom fields.

#### Delete behavior

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

| Behavior | Description | Supported Sync Modes |
| - | - | - |
| **Do nothing** | Keep the person object in Ortto | Any |
| **Clear** | Clear the mapped fields but keep the person object in Ortto | Update |
| **Delete** | Delete the person object from Ortto completely | Upsert |

### Organization

You can perform upsert or insert [organizations](https://help.ortto.com/user/latest/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](https://help.ortto.com/user/latest/organizations/) default and custom fields.

### Audiences

Subscribe people to [audiences](https://help.ortto.com/user/latest/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](https://docs.hightouch.com/syncs/debugger.md). To get notified by Slack, PagerDuty, SMS, or email when a sync fails, set up [sync alerts](https://docs.hightouch.com/syncs/alerting.md). If you run into an issue this page doesn't cover, [contact support](#pylon-chat).