---
title: ActiveCampaign | PostGrid
description: Send letters, postcards, and self-mailers to your ActiveCampaign contacts with PostGrid's native integration.
---

PostGrid’s native ActiveCampaign Integration allows you to send **letters**, **postcards**, and **self-mailers** to your customer list through workflow automation. You can use pre-designed PDF or Personalized templates for creating your campaigns. In this guide, we will walk you through how to perform each step.

---

## Setup the automation

Regardless of what type of mail you want to send, the first step of setting up the automation is the same.

Navigate to the Automation Module and click on the “Create an automation” button to create a new automation or edit your existing automation.

![ActiveCampaign Automation module](/_astro/01-automation.BRJw4rOJ_Z2gSViX.webp)

---

## Create a Trigger

You can set up your new trigger event. It can be any of the following trigger events within ActiveCampaign:

- Subscribes to a list.
- Unsubscribe from a list.
- Submit a form.
- Web page is visited.
- Tag is added.
- And more.

![ActiveCampaign trigger setup](/_astro/02-trigger.DSy90vmx_Z1yxPpy.webp)

---

## Create an Action

After you have selected your triggers, add an Action Step by clicking the ’+’ button shown in your Automation Diagram. Navigate to the “CX Apps” and locate the PostGrid Apps.

![PostGrid action in ActiveCampaign](/_astro/03-action-pg.BASePxER_Z1sYYw.webp)

Here, you have multiple choices regarding the type of mail, including letter, postcard, and self-mailer, you want to send and whether you want to use a template within your PostGrid Dashboard account or upload a pre-designed PDF file. The list of Apps is as follows.

| Apps                                                                                 | Purpose                                                                     |
| ------------------------------------------------------------------------------------ | --------------------------------------------------------------------------- |
| ![Letter template app](/_astro/04-app-letter-template.D9JLudhU_1iSLRb.webp)          | **Sending Letters with personalized template in PostGrid Dashboard**        |
| ![Letter PDF app](/_astro/05-app-letter-pdf.CRpBuDpe_Z23N8VO.webp)                   | **Sending Letters by uploading a pre-designed PDF file as a template**      |
| ![Postcard template app](/_astro/06-app-postcard-template.ClLe7lpQ_Z2kE7gi.webp)     | **Sending Postcards with personalized template in PostGrid Dashboard**      |
| ![Postcard PDF app](/_astro/07-app-postcard-pdf.tPOuPLpb_11cFhm.webp)                | **Sending Postcards by uploading a pre-designed PDF file as a template**    |
| ![Self-Mailer template app](/_astro/08-app-selfmailer-template.Bkh04Hcq_1mF8n5.webp) | **Sending Self-Mailers with personalized template in PostGrid Dashboard**   |
| ![Self-Mailer PDF app](/_astro/09-app-selfmailer-pdf.CYkUaAi1_1EkDGy.webp)           | **Sending Self-Mailers by uploading a pre-designed PDF file as a template** |

### Selecting an account

Once you select the appropriate PostGrid App, you can choose your PostGrid account through the pop-up window or click on the “Add New Account” button.

![Select PostGrid account](/_astro/10-select-account.D0vjVMpw_Z1RAlsK.webp)

To create a new account, you need to add the API key. You can simply find your API key in your [PostGrid dashboard settings page](https://dashboard.postgrid.com/dashboard/settings).

For further information on the API key, read [here](/print-and-mail/getting-started/index.md).

![Enter PostGrid API key](/_astro/11-api-key.CUhqOKJh_VnQEB.webp)

Click on the “Connect” Button, and proceed as follows.

---

## Filling in the Recipient requirements

Now, you need to define and map the variables one by one.

Use the merge variable as %VARIABLENAME%. Ensure you use the built-in ActiveCampaign contact variable to recognize the merge variable. Follow this and fill in all the merge variables.

ActiveCampaign merge variable examples:

| Variable Name          | Variable Format      |
| :--------------------- | :------------------- |
| Recipient First Name   | %FIRSTNAME%          |
| Recipient Last Name    | %LASTNAME%           |
| Recipient Company Name | %COMPANY\_NAME%      |
| Recipient Address      | %ADDRESS\_FULL%      |
| Recipient Country Code | e.g. US, CA, GB, etc |

You can also use the Thunder Light icon to search through the ActiveCampaign variable and choose the variable as per the campaign requirements.

![ActiveCampaign merge variable selection](/_astro/12-merge-variable.wMtSSRBa_Z23GCRF.webp)

---

## Filling in the Sender requirements

You need to define Sender information for sending mail; however, the sender Address and Country code are only mandatory for sending letters and self-mailers and can be kept empty for postcards. These fields can be filled with fixed data.

- Sender First Name
- Sender Last Name
- Sender Company Name
- Sender Address
- Sender Country Code (e.g. US, CA, GB, etc)

---

## Filling in the mailing requirements

As you follow through setting up the Automation, you need to define the value for the following criteria for your mails.

- Mailing Class
- Future Send Date (YYYY/MM/DD)
- Description
- Address Placement *(Just for Letters)*
- Double Sided *(Just for Letters)*
- Black and White or Color *(Just for Letters)*
- Perforation *(Just for Letters)*
- Size *(Just for Postcards and Self-Mailers)*

You can learn more about sending mails through PostGrid, by reading guides for [Letter](/print-and-mail/getting-started/index.md), [Postcard](/print-and-mail/getting-started/index.md), and [Self-Mailers](/print-and-mail/getting-started/index.md)

---

## Filling in the template requirements

And at last, you need to define your template for your letter, postcard, or self-mailer.

- If you opted to use a pre-designed **PDF file** as your template, you can simply add its URL to the automation, in the “PDF URL (Publicly accessible link)” field. To ensure your PDF file is publicly accessible, it must be hosted on a platform that does not require viewers to have an account or specific permission to view the document.

![PDF URL field](/_astro/13-pdf-url.DB4-3kMv_21yCFq.webp)

- If you opted to use an existing **personalized template in your PostGrid dashboard**, you need to copy the template ID to your Automation designated field.

  - **For Letters**

    ![Template ID field for letters](/_astro/14-template-id-letter.BqTXjqRc_Zad0KS.webp)

  - **For Postcards**

    ![Template ID field for postcards](/_astro/15-template-id-postcard.DMfVms2y_2kKrPt.webp)

  - **For Self-Mailers**

    ![Template ID field for self-mailers](/_astro/16-template-id-selfmailer.CBVyIIm5_1qyk8R.webp)

To copy the template ID, go to your PostGrid Dashboard Template page and copy the desired template ID from the template’s detail page.

![Copy template ID from PostGrid dashboard](/_astro/17-copy-template-id.DzZ8gHVQ_V95c3.webp)

You can learn more here about how to [create a template with html](/print-and-mail/getting-started/index.md) and how to use [PostGrid template editor](/print-and-mail/getting-started/index.md)

PostGrid offers a highly personalized template editor that allows you to add customized variables to your templates. So here, you can map the variables you’ve defined in your template to specific fields. There are ten fields available for merging variable names and values.

![Merge variable name and value fields](/_astro/18-merge-fields.BFiEPrMT_Z21EimT.webp)

For instance, if your template contains the merge variables `{{to.firstName}}`, `{{dealStage}}`, and `{{coupon}}`, which for the First Name and Deal Stage should be filled out by the ActiveCampaign contact variables, and for the Coupon pass a fixed data of 123, you need to map as follows.

- `{{to.firstName}}` This variable populates automatically based on Contacts information provided in the Recipients section and doesn’t need to be mapped again
- `{{dealStage}}` Merge Variable Name (1): dealStage Merge Variable Value (1): %DEAL\_STAGE%
- `{{coupon}}` Merge Variable Name (2): coupon Merge Variable Value (2): 123

For more complex templates that require additional variables, you can use the “Extra Merge Variables” field. This allows for the integration of more intricate data sets into your template, making your automated communications even more tailored.

![Extra merge variables JSON field](/_astro/19-extra-merge-variables.DkMhF49i_Z1zOU8v.webp)

For the above example, the JSON code would be:

Extra Merge Variables (JSON):

```
{
  "dealStage": "%DEAL_STAGE%",
  "coupon": "123"
}
```

---

## Activating the automation

after completely filling all the mandatory fields in the automation, you can click on the “Finish” button, and activate your automation.

![Finish and activate automation](/_astro/20-finish.4sa3Q0Bj_1Xphzq.webp)

Once your automation is triggered, you can monitor the orders reflected in your PostGrid dashboard and track your orders through the process.

You can see the [Tracking your mailings section](/print-and-mail/getting-started/index.md) for more information.

You can check for the logs of the PostGrid Applications in the ActiveCampaign profile and PostGrid dashboard.

To check the logs in the ActiveCampaign, you need to check the Application page for PostGrid, as follows:

![PostGrid logs in ActiveCampaign](/_astro/21-logs-app.DPSMSDXK_Z24irCH.webp) ![PostGrid log details](/_astro/22-logs-detail.Czh7zby6_8SRvW.webp)

and to check the API logs in the PostGrid account, navigate to the [API log](https://dashboard.postgrid.com/dashboard/api_logs) page.

Moreover, by utilizing webhook integration, you can simply receive event notifications.

You can see the [Tracking](/print-and-mail/getting-started/index.md), [Tracking Orders using the API](/print-and-mail/getting-started/index.md), and [Carrier Tracking](/print-and-mail/getting-started/index.md) for more information.

Now, you can access your desired PostGrid Print & Mail service through ActiveCampaign!