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

# Inxmail

### Overview

The **Inxmail Commerce API** provides developers with a powerful and flexible way to integrate their applications with the Inxmail email marketing platform. Send transactional journey-based emails triggered by **events** (e.g., new order).
The **Inxmail Professional API** acts as a database to store customer level information. You can send recipient Subscriptions to a list via this API.

### Prerequisites

* **Customer Name / Space ID**: Retrieved from the Console (used in requests).
* **Username & Password (Authentication keys)**: Required for authentication (keyid:secret).
* **Event Creation**: Event must be created beforehand before passing in the request body.

### Authentication

The Inxmail API utilizes **HTTP Basic Authentication** to secure its endpoints. All requests must be authenticated by providing your API credentials. The Key ID should be used as the username, and the Secret should be used as the password. The credentials must be included in the Authorization header of every API request.

The Inxmail Professional REST API requires clients to authenticate themselves with credentials using [http://en.wikipedia.org/wiki/Basic\_access\_authentication](http://en.wikipedia.org/wiki/Basic_access_authentication). The credentials consist of a client id and a secret, which can be supplied to the client software as username and password : “clientid:secret“
For Inxmail Professional REST API, make sure you enter customer name as space name. If you are unable to see the changes in the dashboard please reach out to your Inxmail POC for the right space name and credentials to be used here.

<Note>
  **Please Note:**

  **[Preemptive Authentication](https://hc.apache.org/httpclient-3.x/authentication.html#Preemptive_Authentication) is required to use the Inxmail Commerce Administration API.**
</Note>

*Inxmail Commerce API* requires REST clients to authenticate themselves with an API key using [HTTP Basic Authentication](https://en.wikipedia.org/wiki/Basic_access_authentication). The key consists of a `keyid` and a `secret`, which can be supplied to the client software as username and password.

## Create a Destination for Inxmail

Perform the following steps to create a Destination for Inxmail:

<Steps>
  <Step>
    Log into the Zeotap CDP App and go to the DESTINATIONS application.
  </Step>

  <Step>
    Click + Create Destination.

    <Frame>
      <img src="https://mintcdn.com/zeotap/yn2o-zYGriWZb6QH/articles/integrate-customer/Storage/integrate-customer/image-93.png?fit=max&auto=format&n=yn2o-zYGriWZb6QH&q=85&s=ece26a0844099d61f405027a8a2d6067" width="1600" height="444" data-path="articles/integrate-customer/Storage/integrate-customer/image-93.png" />
    </Frame>
  </Step>

  <Step>
    Under the All Destinations section, search for **Inxmail**.

    <Frame>
      <img src="https://mintcdn.com/zeotap/yn2o-zYGriWZb6QH/articles/integrate-customer/Storage/integrate-customer/image-94.png?fit=max&auto=format&n=yn2o-zYGriWZb6QH&q=85&s=008e27b872dd09faf615c4ec251634ec" width="1600" height="495" data-path="articles/integrate-customer/Storage/integrate-customer/image-94.png" />
    </Frame>

    <Frame>
      <img src="https://mintcdn.com/zeotap/yn2o-zYGriWZb6QH/articles/integrate-customer/Storage/integrate-customer/image-95.png?fit=max&auto=format&n=yn2o-zYGriWZb6QH&q=85&s=090879eb3d792dc3eb080eeedff5faae" width="1006" height="540" data-path="articles/integrate-customer/Storage/integrate-customer/image-95.png" />
    </Frame>
  </Step>

  <Step>
    Click **Inxmail**. A screen appears displaying details about the particular destination towards the left. On the right-hand side of the screen find a list of fields that are required for the integration to be established. Enter the required details as mentioned in the following steps:

    a. Enter a name for the Destination.

    <Frame>
      <img src="https://mintcdn.com/zeotap/yn2o-zYGriWZb6QH/articles/integrate-customer/Storage/integrate-customer/image-96.png?fit=max&auto=format&n=yn2o-zYGriWZb6QH&q=85&s=a600c865d4e005624044b5df2c887127" width="604" height="352" data-path="articles/integrate-customer/Storage/integrate-customer/image-96.png" />
    </Frame>

    b. Enter **Key ID, Client Secret and Customer Name / Space ID** of your Inxmail instance.

    c. Review all the values entered above and then click Next to proceed.
  </Step>

  <Step>
    In the new screen that appears, choose the appropriate[action](/articles/integrate-customer/destinations#actionsanchor) and mapping as explained below. Under Choose your Action, choose **Events Trigger, or Send Recipients to a list, Unsubscribe recipients from a list and update recipient attributes** as the action.

    You can map the following fields for **events trigger**:

    <Frame>
      <img src="https://mintcdn.com/zeotap/yn2o-zYGriWZb6QH/articles/integrate-customer/Storage/integrate-customer/image-97.png?fit=max&auto=format&n=yn2o-zYGriWZb6QH&q=85&s=635ad66c6f96524c024022c468e7a639" width="1936" height="978" data-path="articles/integrate-customer/Storage/integrate-customer/image-97.png" />
    </Frame>

    <Frame>
      <img src="https://mintcdn.com/zeotap/yn2o-zYGriWZb6QH/articles/integrate-customer/Storage/integrate-customer/image-98.png?fit=max&auto=format&n=yn2o-zYGriWZb6QH&q=85&s=353a93a1f37ef440be7b21a2fb5925cf" width="1882" height="926" data-path="articles/integrate-customer/Storage/integrate-customer/image-98.png" />
    </Frame>

    i. **Transaction ID, Customer ID, Customer Email, Order ID, Order Date**

    ii. Items: **Sku, Name, Price, Currency**

    You can map the following fields for**Sending Recipients to a list:**

    <Frame>
      <img src="https://mintcdn.com/zeotap/49y1_9uVgJhUhPeD/articles/integrate-customer/Storage/integrate-customer/integrate-customer/inxmail/inxmail-2025-11-20.png?fit=max&auto=format&n=49y1_9uVgJhUhPeD&q=85&s=107d343fb0440458c30d8c53d7711d67" width="2088" height="984" data-path="articles/integrate-customer/Storage/integrate-customer/integrate-customer/inxmail/inxmail-2025-11-20.png" />
    </Frame>

    iii. Email, Tracking permission, Supplied remote address

    You can map the following fields for**Unsubscribing Recipients from a list:**

    <Frame>
      <img src="https://mintcdn.com/zeotap/49y1_9uVgJhUhPeD/articles/integrate-customer/Storage/integrate-customer/integrate-customer/inxmail/inxmail-2025-11-20-1.png?fit=max&auto=format&n=49y1_9uVgJhUhPeD&q=85&s=f450299fcfdc3ceaccefa39c87472067" width="1910" height="1052" data-path="articles/integrate-customer/Storage/integrate-customer/integrate-customer/inxmail/inxmail-2025-11-20-1.png" />
    </Frame>

    iv. Email, Supplied Remote Address

    You can map the following fields for**Updating Recipient Attributes:**

    <Frame>
      <img src="https://mintcdn.com/zeotap/49y1_9uVgJhUhPeD/articles/integrate-customer/Storage/integrate-customer/integrate-customer/inxmail/inxmail-2025-11-20-2.png?fit=max&auto=format&n=49y1_9uVgJhUhPeD&q=85&s=643bc11d9588362b512a2c9f635edd82" width="1854" height="868" data-path="articles/integrate-customer/Storage/integrate-customer/integrate-customer/inxmail/inxmail-2025-11-20-2.png" />
    </Frame>

    v. Current Recipient Email, new Recipient Email and other Recipient Attributes
  </Step>

  <Step>
    Click Create Destination. The created Destination gets listed in the Journeys application, which can be linked to any particular journey.
  </Step>
</Steps>

## Activate the Destination on Journeys

After creating a destination, next, you need to link it in the Send to Destination node within the workflow, as explained below.

<Steps>
  <Step>
    In the workflow, click + and choose Send to Destinations.

    <Frame>
      <img src="https://mintcdn.com/zeotap/yn2o-zYGriWZb6QH/articles/integrate-customer/Storage/integrate-customer/image-99.png?fit=max&auto=format&n=yn2o-zYGriWZb6QH&q=85&s=2bb8dc4a9e4bddd579ee26beb6b18985" width="1032" height="542" data-path="articles/integrate-customer/Storage/integrate-customer/image-99.png" />
    </Frame>
  </Step>

  <Step>
    Choose the destination from the list of available destinations by using the search feature.

    <Frame>
      <img src="https://mintcdn.com/zeotap/CSAMM_Rlvn0jps6x/articles/integrate-customer/Storage/integrate-customer/image-100.png?fit=max&auto=format&n=CSAMM_Rlvn0jps6x&q=85&s=708fb3c42c3671e957c4a58485d32ee7" width="1600" height="891" data-path="articles/integrate-customer/Storage/integrate-customer/image-100.png" />
    </Frame>
  </Step>

  <Step>
    Under the Destination Details tab, the **Key ID, Client Secret** and **Customer Name / Space ID** fields are automatically populated based on the value that you have entered while creating the destination.
    Some Journey Level Inputs will not be used for all actions. For example: while sending an event to Inxmail commerce 'list ID' will not be used.

    Vice-versa is true for Inxmail Professional action.

    <Frame>
      <img src="https://mintcdn.com/zeotap/CSAMM_Rlvn0jps6x/articles/integrate-customer/Storage/integrate-customer/image-101.png?fit=max&auto=format&n=CSAMM_Rlvn0jps6x&q=85&s=4a7046a8819fbce2f9086f82f565dbe6" width="546" height="558" data-path="articles/integrate-customer/Storage/integrate-customer/image-101.png" />
    </Frame>
  </Step>

  <Step>
    Under the Destination Settings tab, choose the **Event name(String), List ID(Integer)** and **New User(Boolean)** as per your requirement.​
  </Step>

  <Step>
    Upon clicking Save Destination. The destination is attached as shown in the image below.

    <Frame>
      <img src="https://mintcdn.com/zeotap/49y1_9uVgJhUhPeD/articles/integrate-customer/Storage/integrate-customer/inxmail/inxmail-2025-11-20.png?fit=max&auto=format&n=49y1_9uVgJhUhPeD&q=85&s=e22c726bef5ef3eec38f6e0c7076512d" width="1006" height="540" data-path="articles/integrate-customer/Storage/integrate-customer/inxmail/inxmail-2025-11-20.png" />
    </Frame>
  </Step>
</Steps>
