> ## Documentation Index
> Fetch the complete documentation index at: https://moengage.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Poplar

# Introduction

[Poplar](https://heypoplar.com/) is a performance driven direct mail solution that helps customers drive growth at every stage of the customer journey.

# Use cases

The Poplar × MoEngage integration lets you send physical mailers from your MoEngage campaigns and flows.

# Integration

<Info>
  **Prerequisites**

  1. Ensure you have access to your Poplar dashboard.
  2. Ensure that you have your Poplar API keys. You can also create one for MoEngage if needed.
</Info>

To integrate with Poplar, use the [Poplar APIs](https://developers.heypoplar.com/endpoints/mailing) to send recipient data via MoEngage connectors.

## Step 1: Create connector campaign on MoEngage

To create a connector campaign on MoEngage,

1. Navigate to Create Campaign > Connectors > Custom

<img src="https://mintcdn.com/moengage/7iGV38YjgdBKSU0B/images/partner_23503517648020.png?fit=max&auto=format&n=7iGV38YjgdBKSU0B&q=85&s=911ad573bd196daf0a066846bd4d465a" alt="Screenshot_2022-02-21_at_10.48.46_PM.png" width="1104" height="1238" data-path="images/partner_23503517648020.png" />

2. On step 2 of the campaign, select -

#### a) URL details

| Key         | Value                                                                        |
| ----------- | ---------------------------------------------------------------------------- |
| Method      | POST                                                                         |
| Webhook URL | [https://api.heypoplar.com/v1/mailing](https://api.heypoplar.com/v1/mailing) |
| URL params  | --                                                                           |

#### b) Headers

Add the following two headers

| Key           | Value                     |
| ------------- | ------------------------- |
| Authorization | Bearer `<Poplar API key>` |
| Content-Type  | application/json>         |

#### c) Request Body

In the following request body, select RAW and enter the following payload-

<CodeGroup>
  ```json JSON wrap theme={null}
  {"campaign_id": "{{UserAttribute['campaign_id']}}","recipient": {"city": "{{UserAttribute['City']}}","email": "{{UserAttribute['Email']}}","state": "{{UserAttribute['State']}}","address_1": "{{UserAttribute['Address line 1']}}","address_2": "{{UserAttribute['Address line 2']}}","first_name": "{{UserAttribute['First Name']}}","last_name": "{{UserAttribute['Last Name']}}","postal_code": "{{UserAttribute['Postal code']}}"},"merge_tags": {"promo-code": ""},"creative_id": "<any sample id>"}
  ```
</CodeGroup>

## Step 3: Test your configuration

At this point, your campaign should be ready to test and send. You can also test your connector configuration using the Test functionality available on Step 2 of Create Connector Campaign

<img src="https://mintcdn.com/moengage/7iGV38YjgdBKSU0B/images/partner_23503517650964.png?fit=max&auto=format&n=7iGV38YjgdBKSU0B&q=85&s=38232c36a4c572ef1188e01beacd07ff" alt="Screen_Shot_2022-02-22_at_11.12.42_AM.png" width="2464" height="270" data-path="images/partner_23503517650964.png" />

Check the Poplar dashboard once you test the configuration or trigger the campaign.