Documentation Index
Fetch the complete documentation index at: https://docs.zeotap.com/llms.txt
Use this file to discover all available pages before exploring further.
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 pick one of two actions on the mapping screen — Create a list and upload recipients (Zeotap creates a new list for you) or Upload Recipients to a list (you select an existing Inxmail list from a dropdown).
- 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. If you chose the create-a-list action, you also fill in the mailing list parameters (list name, sender address, etc.) at this point.
- Depending on the action you chose, Zeotap either creates a new mailing list and imports recipients into it, or imports recipients into the list you selected — no manual CSV upload or list creation required on your end.
Available Actions
The Inxmail Audience destination supports two actions. Pick the one that matches your situation on the mapping screen.| Action | When to use | Inputs |
|---|---|---|
| Create a list and upload recipients | You don’t have a list yet. Zeotap creates a new mailing list in Inxmail and imports recipients into it. | Mailing list parameters (list name, sender address, etc.) + recipient attribute mapping. |
| Upload Recipients to a list | The list already exists in Inxmail. Zeotap imports recipients into the list you select. | Existing list (picked from a dropdown that Zeotap populates from your Inxmail account) + recipient attribute mapping. |
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.
Choose Your Action
On the mapping screen, pick one of two actions and configure the corresponding inputs.Action 1 — Create a list and upload recipients
Use this when no list exists yet. Zeotap creates a new mailing list in Inxmail and imports your audience as recipients into it. Select Create a list and upload recipients as the action and set up the recipient attribute mapping.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.
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., marketing@yourcompany.com). 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.
Action 2 — Upload Recipients to a list
Use this when the target list already exists in Inxmail. You select it from a dropdown that Zeotap populates from your Inxmail account, then map recipient attributes the same way as Action 1.From the List dropdown, pick the existing Inxmail list. Zeotap fetches the available lists using the credentials you entered when creating the destination.
The dropdown only shows lists that already exist in your Inxmail account. If it is empty, create the list in Inxmail first or use Create a list and upload recipients instead.
Map recipient attributes — same fields as Action 1:
- Email ID (required)
- First Name, Last Name, Tracking Permission, and any pre-defined custom attributes (optional)
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.
Field Mapping
Below is a reference for how recipient data from Zeotap maps to Inxmail fields.Recipient Attribute Mapping
Applies to both actions.| 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. |
Upload Recipients to a list — Inputs
Applies only to the Upload Recipients to a list action.| Parameter | Required / Optional | Notes |
|---|---|---|
| List | Required | Picked from a dropdown of existing Inxmail lists. Zeotap calls Inxmail to populate the dropdown using the credentials configured on the destination. |
| Recipient attributes | See Recipient Attribute Mapping above | Email ID is required; other attributes optional. |
Mailing List Parameters
Applies only to the Create a list and upload recipients action.| 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.