Overview
This integration allows you to send audience segments from Zeotap CDP directly into Inxmail for targeted email campaigns — without any manual data transfers. Once you set up the Inxmail destination and attach it to an audience, Zeotap automatically creates a mailing list in Inxmail and imports your audience members as recipients. All you need to do is configure the connection, set up your mapping, and attach it to your audience — Zeotap handles the rest.How It Works
When you attach the Inxmail destination to an audience in Zeotap CDP, the following happens automatically behind the scenes:- You set up Inxmail as a destination in Zeotap CDP by entering your API credentials (Client ID, Client Secret, and Customer Name).
- You configure recipient attribute mapping — telling the system which fields (like email, first name, last name) should be sent to Inxmail.
- You attach the destination to an audience in Zeotap.
- You configure the mailing list parameters — such as the list name, sender address, sender name, and reply-to details.
- Once attached, Zeotap automatically creates a mailing list in Inxmail and imports your audience members as recipients into that list — no manual CSV upload or list creation required on your end.
Before You Begin
Make sure you have everything ready before starting the setup.In Inxmail
- An active Inxmail account with API access enabled
- Access to the OAuth-Clients section in your Inxmail account (this is where you generate credentials):
- Your Client ID (also called Key ID — used as the username for authentication)
- Your Client Secret (used as the password for authentication — shown only once at creation, so store it securely)
- Your Customer Name (your Inxmail account identifier, visible in your account settings)
- A valid sender email address to use for the mailing list
In Zeotap CDP
- Access to the Integrate module with permission to create new destinations
- An audience segment ready to be sent to Inxmail
- A clear understanding of which recipient attributes you want to map (e.g., email, first name, last name)
Step-by-Step Configuration Guide
Prerequisites
Before you can connect Zeotap to Inxmail, you need three pieces of information: your Client ID, Client Secret, and Customer Name.Give the client a recognizable name (e.g., “Zeotap CDP Integration”) so your team knows what it is used for.
- Client ID
- Client Secret
- Customer Name
Create a Destination
Head over to Zeotap CDP to create the destination and enter your credentials.
Fill in the required credential fields:
- Client ID — Paste the Client ID you copied from Inxmail.
- Client Secret — Paste the Client Secret.
- Customer Name — Enter your Inxmail customer name.
Configure Recipient Attribute Mapping
Next, select the Upload Recipients to a List action and set up the mapping to tell Zeotap which recipient data to send to Inxmail.Map any additional attributes you want to include, such as:
- First Name
- Last Name
- Custom attributes (these must already exist as recipient attributes in your Inxmail account)
Any custom attributes you map must be pre-defined in Inxmail. If an attribute does not exist in Inxmail, that data will not be imported.
Configure Mailing List Settings and Attach to Audience
This is where you define the mailing list details and connect everything to your audience. When you attach the destination to an audience, Zeotap will automatically create the mailing list in Inxmail and import recipients on your behalf.
Fill in the mailing list parameters:
| Field | Required? | Description |
|---|---|---|
| List Name | Yes | The name of the mailing list that will be created in Inxmail (e.g., “Q1 Campaign Audience”). Must be between 1 and 255 characters. |
| List Type | Yes | Must be set to STANDARD. This is the only list type that supports recipient imports. |
| Sender Address | Yes | The email address that will appear as the “From” address on emails sent from this list (e.g., [email protected]). Must be a valid email address. |
| Sender Name | No | The display name shown alongside the sender address (e.g., “Your Company Marketing Team”). |
| Reply-To Address | No | The email address recipients will reply to, if different from the sender address. |
| Reply-To Name | No | The display name associated with the reply-to address. |
| Description | No | A short description of the list’s purpose. Maximum 255 characters. |
Click Save to finalize.
What happens next: Once attached, Zeotap automatically creates the mailing list in Inxmail using the parameters you configured, and imports your audience members as recipients into that list. You do not need to manually create the list or upload any files — it is all handled for you.
Field Mapping
Below is a reference for how recipient data from Zeotap maps to Inxmail fields.Recipient Attribute Mapping
| Zeotap Field | Maps to (Inxmail) | Required / Optional | Notes |
|---|---|---|---|
| Email ID | email (Email Address) | Required | Must be a valid email address. This is the unique identifier for each recipient in Inxmail. |
| Tracking Permission | trackingPermission | Optional | Controls email tracking consent. Use GRANTED to enable tracking; any other value (or empty) is treated as no permission. |
| Custom Attributes | Custom Attribute Names | Optional | Any additional data fields. Must be pre-defined as recipient attributes in your Inxmail account before mapping. |
Mailing List Parameters
| Parameter | Maps to (Inxmail) | Required / Optional | Notes |
|---|---|---|---|
| List Name | name | Required | Name of the mailing list created in Inxmail. 1–255 characters. |
| List Type | type | Required | Must be STANDARD. |
| Sender Address | senderAddress | Required | Valid email address for the sender. |
| Sender Name | senderName | Optional | Display name for the sender. |
| Reply-To Address | replyToAddress | Optional | Valid email address for replies. |
| Reply-To Name | replyToName | Optional | Display name for the reply-to address. |
| Description | description | Optional | Short description of the list. Max 255 characters. |
Important Notes & Limitations
Custom attributes must be pre-defined in Inxmail. If you map attributes in Zeotap that do not exist as recipient attributes in Inxmail, that data will not be imported. Set up custom attributes in Inxmail before configuring the mapping.
Mailing list creation and recipient import are automatic. Once you attach the destination to an audience, Zeotap handles list creation and data import behind the scenes. You do not need to perform these steps manually.
Opt-in compliance. Ensure all recipients in your audience have opted in to receive communications in accordance with local regulations (GDPR, CAN-SPAM, etc.) before attaching the destination.