# Postalytics

{% hint style="success" %}
**Audience:** Admins, Developers, <code class="expression">space.vars.automation</code> Builders, Support & Operation Teams, and Solution Architects&#x20;

**Purpose:** Explains what the Postalytics integration is, when to use it, and how it works within <code class="expression">space.vars.Kizen\_company\_name</code>.
{% endhint %}

## **Overview** <a href="#overview" id="overview"></a>

Postalytics is a direct mail <code class="expression">space.vars.automation</code> integration that allows you to send physical mail from <code class="expression">space.vars.Kizen\_company\_name</code> using <code class="expression">space.vars.contact</code> and <code class="expression">space.vars.entity</code> data. It connects digital <code class="expression">space.vars.workflows</code> with offline mail delivery, making it easy to trigger, track, and manage mail sends alongside your other outreach.

### **What is** Postalytic&#x73;**?** <a href="#what-is-postalytics" id="what-is-postalytics"></a>

Postalytics allows businesses to send physical mai&#x6C;**,** such as postcards or letters, programmatically through APIs and automated <code class="expression">space.vars.workflows</code>. When integrated with <code class="expression">space.vars.Kizen\_company\_name</code>, a <code class="expression">space.vars.contact</code> <code class="expression">space.vars.entity</code> action or <code class="expression">space.vars.automation</code> triggers the mail, which Postalytics then prints and sends.

### **When to Use Postalytics** <a href="#when-to-use-postalytics" id="when-to-use-postalytics"></a>

Postalytics is best used when you want to send physical mail as part of a <code class="expression">space.vars.workflow</code>, either manually or automatically.

#### **Common Use Cases** <a href="#common-use-cases" id="common-use-cases"></a>

* Sending a one-time Birthday card or postcard to a specific <code class="expression">space.vars.contact</code>
* Welcome or follow-up mail after an event
* Triggering mail as part of an onboarding or lifecycle <code class="expression">space.vars.workflow</code>
* Automating mail sends at scale using <code class="expression">space.vars.automations</code>

***

## How the Integration Works <a href="#how-the-integration-works" id="how-the-integration-works"></a>

Before configuring the Postalytics app, it’s important to understand how the integration behaves at a high level.

**Integration model**

* <code class="expression">space.vars.Kizen\_company\_name</code> sends <code class="expression">space.vars.contact</code> data to Postalytics when a send is triggered
* Postalytics response has a "send-date" key which is used to determine if it succeeded. However, the response is not visible to the user.

**Send behavior**

* Sends are asynchronous
* <code class="expression">space.vars.Kizen\_company\_name</code> receives an immediate success or failure response
* Printing and mailing occurs later within Postalytics

**Send status and delivery tracking**

* <code class="expression">space.vars.Kizen\_company\_name</code> does not store delivery or mailing status
* To track print, mail, or delivery progress, use the Postalytics dashboard

**Failure handling**

* If Postalytics is unavailable, sends fail immediately
* Errors surface in the UI (manual sends) or as failed <code class="expression">space.vars.automation</code> steps
* Failed sends are not queued automatically for later retry

**Retries**

* Both manual and <code class="expression">space.vars.automation</code>-based sends automatically retry certain transient failures. If a send ultimately fails, users must resolve the issue and retry the send or rerun the <code class="expression">space.vars.automation</code>.
* Other failures must be retried manually after resolving the issue

**Deduplication**

* <code class="expression">space.vars.Kizen\_company\_name</code> does not deduplicate sends
* The same <code class="expression">space.vars.contact</code> can receive the same campaign multiple times
* Deduplication must be handled through <code class="expression">space.vars.automation</code> logic or campaign rules

For setup instructions, see [Enabling Postalytics](/docs/integrations-and-plugins/integrations/postalytics/enabling-postalytics.md).

***

## **Available Postalytics Actions** <a href="#available-postalytics-actions" id="available-postalytics-actions"></a>

Once Postalytics is configured, <code class="expression">space.vars.Kizen\_company\_name</code> exposes the Send Campaign Mail action on Contact records allowing you to do the following:

* [Send Mail from a Contact Record](/docs/integrations-and-plugins/integrations/postalytics/sending-mail-from-a-contact-record-with-postalytics.md)
* [Send Mail from Agentic Workflows](/docs/integrations-and-plugins/integrations/postalytics/sending-mail-from-automations-with-postalytics.md)

***

## **Field Mapping Reference** <a href="#field-mapping-reference" id="field-mapping-reference"></a>

<code class="expression">space.vars.Kizen\_company\_name</code> maps <code class="expression">space.vars.contact</code> fields to Postalytics fields as follows:

| Kizen Contact Field | Postalytics Field |
| ------------------- | ----------------- |
| `street_address_1`  | `address_street`  |
| `street_address_2`  | `address_street2` |
| `city`              | `address_city`    |
| `state`             | `address_state`   |
| `zipcode`           | `address_zip`     |
| `first_name`        | `first_name`      |
| `last_name`         | `last_name`       |
| `email`             | `email_address`   |
| `phone_mobile`      | `mobile_phone`    |
| `phone_home`        | `phone`           |

***

## What's Next

To get started with integrating Postalytics into the <code class="expression">space.vars.Kizen\_company\_name</code> platform, see the [Enabling Postalytics](/docs/integrations-and-plugins/integrations/postalytics/enabling-postalytics.md) topic. You can also learn more about:

* [Sending mail from a Contact Record](/docs/integrations-and-plugins/integrations/postalytics/sending-mail-from-a-contact-record-with-postalytics.md)
* [Using Postalytics in Agentic Workflows](/docs/integrations-and-plugins/integrations/postalytics/sending-mail-from-automations-with-postalytics.md) for scalable mail workflows

<details>

<summary>Related Topics</summary>

* [Enabling Postalytics](/docs/integrations-and-plugins/integrations/postalytics/enabling-postalytics.md)
* [Sending Mail from a Contact Record with Postalytics](/docs/integrations-and-plugins/integrations/postalytics/sending-mail-from-a-contact-record-with-postalytics.md)
* [Sending Mail from Automations with Postalytics](/docs/integrations-and-plugins/integrations/postalytics/sending-mail-from-automations-with-postalytics.md)

</details>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://developer.kizen.com/docs/integrations-and-plugins/integrations/postalytics.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.