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

# Upland Waterfall

> Elevate your customer experience and drive higher levels of engagement using personalised, targeted SMS/MMS mobile messaging with Waterfall.

## Supported syncing

| Sync Type | Description | Supported Sync Modes | API documentation |
| - | - | - | - |
| **Subscribers** | Sync data from any source to an Upland Waterfall list as subscribers | Upsert | [Subscriber Lists](https://apidocs.waterfall.com/#introduction) |

For more information about sync modes, refer to the [sync modes](https://docs.hightouch.com/syncs/types-and-modes.md#sync-modes) docs.

## Connect to Upland Waterfall

Go to the [**Destinations** overview page](https://app.hightouch.com/destinations?from=docs) and click the **Add destination** button. Select **Upland Waterfall** and click **Continue**.

Enter your API key from your Upland Waterfall account.
If you do not have an Upland Waterfall API key, contact your Upland Waterfall account manager.

You can optionally provide a default list ID. This will be the default list to add subscribers to for all syncs created with this destination.

## Sync configuration

Once you've set up your Upland Waterfall destination and have a [model](https://docs.hightouch.com/getting-started/concepts.md#models) to pull data from, you can set up your sync configuration to begin syncing data. Go to the [**Syncs** overview page](https://app.hightouch.com/syncs?from=docs) and click the **Add sync** button to begin. Then, select the relevant model and the Upland Waterfall destination you want to sync to.

### Sync mode

* **Upsert**: pushes new objects to Upland Waterfall and updates mapped fields that change in your source.

### List selection

Select which list in your Upland Waterfall account you'd like to upsert subscribers to. If you configured a default list ID in your destination, selecting a list is not required in the sync configuration.

### Field mapping

Hightouch will fetch all metadata fields from Upland Waterfall as mapping options. You can map any field from your source to a metadata field with the inline mapper.

### Record matching

Upland Waterfall requires all subscribers to have a `msisdn`. You must select a column in your model to map to this field.

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