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

# Responsys

> Oracle Responsys is a cross-channel campaign management platform that delivers advanced intelligence at scale so you can create personalized messages based on customers' and prospects' individual interests and preferences.

> [!NOTE]
>
> Oracle Responsys is a [premium destination](https://docs.hightouch.com/pricing/ss-pricing.md#premium-destinations) and is only available on [Business tier plans](https://hightouch.com/pricing).

## Supported syncing

| Event Type | Description | Supported Sync Modes |
| - | - | - |
| **Profile Lists** | Create base profiles with Email, phone number, or custom IDs | Upsert, Update |
| **Profile Extension Tables** | Add custom attributes and properties to the base profiles | Upsert, Update |
| **Custom / REI Events** | Add items to Events | Insert, Update |

## Connect to Responsys

To use the Responsys destination in Hightouch, you need to know your Responsys credentials and which Oracle system hosts your
Responsys account. To find your host URL refer to the [Oracle Responsys documentation](https://docs.oracle.com/en/cloud/saas/marketing/responsys-rest-api/SendRequests.html).

## Syncing data

### Profile lists

Syncing to Responsys profile lists lets you create base profiles. Base profiles primarily contain user IDs to associate
the user to records in profile extension tables.

#### Record matching

You can match rows in your model with users in Responsys on the following fields:

* Email
* Mobile number
* Customer ID
* Responsys ID (RIID)
* MD5 Hashed Email
* SHA256 Hashed Email

> [!WARNING]
>
> Hashed emails can't be used for upsert operations.

#### Field mapping

You can map additional user information such as other identifiers, country, address, or other user-created fields.

### Profile Extension Tables

Syncing to profile extension tables lets you attach additional information to base user profiles.
Profile extension tables (PETs) give you a way to store additional attributes that define behavioral, demographic or
profile preference characteristics of your contacts. Using PETs helps you organize information about your contacts
in a way that is most efficient for your queries and data imports.

Refer to the [Responsys Profile Extension Table docs](https://docs.oracle.com/en/cloud/saas/marketing/responsys-user/List_CreatePET.htm) to learn more.

#### Record matching

You can match rows in your model with users in Responsys on the following fields:

* Email
* Mobile number
* Customer ID
* Responsys ID (RIID)
* MD5 Hashed Email
* SHA256 Hashed Email

> [!WARNING]
>
> Hashed emails can't be used for upsert operations.

#### Field mapping

You can sync columns from your source to any user-created field in your Responsys PET.

### Custom / REI Events

Syncing to Responsys Custom Events (part of Responsys Event Infrastructure or REI) allows you to track and store behavioral data about your contacts.
These events capture specific actions or interactions that contacts have with your brand, such as purchases, website visits, app usage, or any custom activities you want to monitor.

API Documentation on Responsys events is available [here](https://docs.oracle.com/en/cloud/saas/marketing/responsys-rest-api/api-events.html).

#### Record matching

You can match rows in your model with users in Responsys on the following fields:

* Event Name
* Profile List

#### Field mapping

You can sync rows to Responsys events on the following fields:

* Recipient ID
* Customer ID
* Email Address
* Mobile Number
* MD5 Hashed Email
* SHA256 Hashed Email

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