Skip to main content

Overview

Cleverpush is a web-based platform that enables website owners and developers to send to users who have subscribed to receive them. Integrated with Zeotap CDP, it enables marketers to engage with their customers in real-time and at scale. This integration lets you send notifications through mobile applications, websites and emails.

Supported Identifiers

This integration supports Subscription ID and standard attributes such as First Name, Last Name, Gender and Email Address (Raw). You can also send Custom Identifiers and Attributes.
Note:Ensure to create the standard and custom attributes in the Cleverpush account before mapping them in Zeotap CDP. Learn more

Components of Cleverpush

Ensure that you have the details about the below components of the Cleverpush account available before creating a Destination.

Private API Key

A Private API Key is a unique identifier associated with your Cleverpush account. This is used to authenticate and authorise access to certain features or APIs of Cleverpush. Perform the following steps to obtain the Private API Key from Cleverpush:
1
Log into the Cleverpush console and navigate to Settings.
2
In the left panel, click API and copy the Private API Key displayed on the screen.
3
If you wish to add an additional API key, click Add Additional API key and select the channel where you intend to use this key.

Channel ID

A Channel ID is a unique identifier assigned to the push notification channel that you create within Cleverpush. Perform the following steps to obtain the Channel ID in Cleverpush:
1
Log into Cleverpush console and navigate to Channels on the top navigation bar.
2
Under Channels, click the channel that you wish to use for sending push notifications. If the desired channel is not available, then you can create one by clicking Add Channel from the drop-down menu. For more information on how to create a channel in Cleverpush, refer .
3
Once the channel is created, you need to setup the platforms on which you want to send notifications. The following are the platforms that Zeotap CDP supports:
  • Web Push
  • App Push
  • Email Push
Note:For more information about how to set up these platforms, refer .
4
Click the desired platform and navigate to General > Advance Settings > Channel ID.

Prerequisites

Ensure that you add the identifiers in the Cleverpush account before mapping them in the Actions and Mapping screen as explained below. Otherwise, data will not be sent correctly.

Add Identifiers and Attributes in Cleverpush

To add the identifiers and attributes in Cleverpush, perform the following steps:
1
Log into Cleverpush console and navigate to Channels on the top navigation bar.
2
Under Channels, click the channel that you wish to use for sending push notifications. For more information about Channels, refer here.
3
Navigate to your desired platform and go to Attributes as shown in the image below. Under ID, a standard list of commonly used attributes are displayed. You can add any or all of these attributes by selecting them and providing a name for each attribute selected.
  • For example, if you want to add firstname from the standard list, choose firstname from the standard list and provide the display name for the attribute. Here, the display name is First Name. Note that the standard field firstname acts as a connection between the attributes in Cleverpush and Zeotap CDP.
4
Click Add attribute. Similarly, you can also add any custom identifier or attribute on Cleverpush. Once the attribute is added, you can map the particular field in the Actions and Mapping screen, in Zeotap CDP, as shown below. To learn more about the mappings, read ahead.

Destination Setup

After you have applied filters or added conditions for your users in Journeys, you can activate them in Cleverpush under Send to Destinations. A new window appears, where you can set up your destination. You can use an already existing destination from the list of available Destinations or create a new one by clicking + Add New Destination.

Add New Destination

Perform the following steps to add a new destination:
1
Click Add New Destination.
2
Search for Cleverpush.
3
Click Cleverpush and enter a name for the Destination.
4
Choose the API Type from the drop-down menu. You can either choose POST or PATCH as per your Enter the Private API Key associated with your Cleverpush account. For information about how to obtain this from Cleverpush, refer to the Components of Cleverpush section.
5
Enter the Channel ID associated with your push notification channel. For information about how to obtain this from Emarsys, refer to the Components of Cleverpush section.
6
In the mapping screen that appears, under Choose your Action, you can either choose Send identifiers and attributes to Cleverpush in Realtime or Send identifiers to Cleverpush in Realtime as the action for sending data from the workflow created in Journeys.a. If you choose Send identifiers and attributes to Cleverpush in Realtime as your action, then along with the Subscription ID, you can send the standard attributes such as First Name, Last Name, Email Address (raw) and Gender. However, to use them, first, you need to add them in the Cleverpush console. Note that you can also send custom identifiers and attributes to Cleverpush by using + Add Mapping Field shown in the image below. Ensure that even these attributes are added in Cleverpush console before adding it in the Mapping (Zeotap CDP) screen. Otherwise, the data will not be sent correctly. Learn more
b. If you choose Send identifiers to Cleverpush in Realtime as your action, then you can only send Subscription ID to Cleverpush.
7
Once the mapping is complete, click Create Destination. The destination is created and made available for activation on Journeys.

Activate the Destination on Journeys

After creating a destination, next, you have to add workflow-level inputs as mentioned below.
1
Choose the destination from the list of available destinations by using the search feature.
2
The Private API Key and Channel ID fields are automatically populated based on the value that you had entered while creating the destination.
3
Under Audience, choose from the drop-down to categorise your users based on specific characteristics related to your workflow. You can either choose from the list of existing tags or create a new one by clicking + Create New Tag option.
In CleverPush, tags are labels or identifiers that you can assign to users to categorise them based on specific characteristics, interests, behaviours or demographics. Tags help you segment your users and target them with relevant and personalised messages.
4
Under Destination Settings, choose the Action and Mapping as per your requirement.
5
Upon clicking Save Destination. The destination is attached as shown in the image below.
Last modified on February 26, 2026