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

# CleverTap

> Build better campaigns on CleverTap with up-to-date customer data from your data warehouse

## Setup

Navigate to Setting > Project in CleverTap to view credentials.

![](https://mintcdn.com/hightouch-3c037897/L_vQfA0JQEpeGUUo/images/destinations/destination-clevertap-navigate-settings.png?fit=max\&auto=format\&n=L_vQfA0JQEpeGUUo\&q=85\&s=c84b6d2faaffd381087afe53617625c1)

From the Project tab, copy `Project Id` as `Account Id` and `Passcode` into Hightouch. Use `CleverTap Region` for `Localization`.

![](https://mintcdn.com/hightouch-3c037897/L_vQfA0JQEpeGUUo/images/destinations/destination-clevertap-credentials.png?fit=max\&auto=format\&n=L_vQfA0JQEpeGUUo\&q=85\&s=6cc74d74f8a6e9c409bb4515b9adb17e)

## Supported types

Hightouch supports syncing to the following CleverTap types:

* **Objects**
* **Events**
* **Segments**

## Syncing objects

Hightouch supports syncing to the following CleverTap objects:

* **Profile** Hightouch allows you to sync user profiles from a source into CleverTap.

### Sync modes

* **Upsert** - In upsert mode, Hightouchs adds new rows and keeps existing rows up to date.

### Record matching

For each user profile, a user identifier is required. This is the key that CleverTap uses to find the user whose profile needs to be updated. You have to set a value for one of these parameters to identify the user: Identity, CleverTap Global Object ID, Meta ID or Google Plus ID. If this identity is not found a new user profile will be created.

![](https://mintcdn.com/hightouch-3c037897/L_vQfA0JQEpeGUUo/images/destinations/destination-clevertap-idmappings.png?fit=max\&auto=format\&n=L_vQfA0JQEpeGUUo\&q=85\&s=ec4ec2f2785801ca8320e781b98da481)

> [!NOTE]
>
> You may also provide additional identifiers through Field Mapping. Profiles
> are automatically unified by CleverTap.

### Field mapping

You can sync columns from your source to CleverTap.

CleverTap **highly recommends** you provide common fields like `Name, Email, Phone, etc.`. You can see additional details in the [CleverTap docs](https://developer.clevertap.com/docs/concepts-user-profiles#manually-updating-predefined-user-profile-properties).

> [!WARNING]
>
> Phone numbers must use E164 formatting. CleverTap will reject rows that aren't in this format.

Additional fields that fits your unique use case can be mapped through custom mappings.

![](https://mintcdn.com/hightouch-3c037897/L_vQfA0JQEpeGUUo/images/destinations/destination-clevertap-custom-fields.png?fit=max\&auto=format\&n=L_vQfA0JQEpeGUUo\&q=85\&s=e577e8713cb69a9948a3b7b64c43944a)

> [!NOTE]
>
> CleverTap automatically generates schema for custom fields you provide. You
> can see existing schemas by navigating to Setting > Schema > User
> Properties in CleverTap.

## Syncing events

When syncing events, Hightouch treats any records added to [your source](https://docs.hightouch.com/getting-started/concepts.md) as new events and sends them to CleverTap when your sync runs.

> [!WARNING]
>
> To ensure syncs send each event, your event model must use a truly unique [primary key](https://docs.hightouch.com/getting-started/concepts.md#unique-primary-key-requirement). See the [events syncs](https://docs.hightouch.com/syncs/types-and-modes.md#event-syncs) documentation for more information.

### Event name

You can provide a fixed event name or use a value from your source as event name by toggling the switch button.

![](https://mintcdn.com/hightouch-3c037897/L_vQfA0JQEpeGUUo/images/destinations/destination-clevertap-event-name.png?fit=max\&auto=format\&n=L_vQfA0JQEpeGUUo\&q=85\&s=eb7fdc029bc416f55e6dd751650f0ee6)

> [!NOTE]
>
> New event names are automatically added to CleverTap schema.

### Record matching

For each event, a user identifier is required. This is the key that CleverTap uses to find the user whose profile needs to be updated. You have to set a value for one of these parameters to identify the user: Identity, CleverTap Global Object ID, Meta ID or Google Plus ID. If this identity is not found a new user profile will be created.

### Field mapping

You can sync any column from your source to into any event field in CleverTap.

## Syncing segments

When syncing segments or custom lists, CleverTap requires the users in the segment to have already been synced to CleverTap. You can use [sequences](https://docs.hightouch.com/syncs/schedule-sync-with-sequences.md) to ensure that users are synced before syncing segments.

To start syncing, choose a field to identify users (Identity, CleverTap Global Object ID, Meta ID, or Google Plus ID), name the segment, and assign an admin's email for ownership.

> [!NOTE]
>
> CleverTap automatically generates schema for custom fields you provide. You
> can see generated and existing schemas by navigating to Setting > Schema
> \> Events in CleverTap.

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