Skip to main content

​
Introduction

Paperplanes is a direct mail automation platform that enables you to run more customer-centric and profitable direct mail campaigns.

​
Use cases

Use the Paperplanes and MoEngage connectors to send your customers direct mail such as letters, postcards, and self-mailers. Running direct mail like a digital channel means moving away from mass mailings and leveraging the channel as part of your (digital) customer journeys. The benefits of a modern approach to direct mail are:
  • Increased conversion rates via increased relevance, additional use cases, easier A/B testing, and cross-channel effects
  • Reduced effort via automation and an end-to-end solution
  • Reduced cost via frame contracts and cost transparency

​
Integration

Prerequisites
  1. Ensure you have access to your Paperplanes dashboard.
  2. Ensure that you have your Paperplanes API and secret key. Contact Paperplanes and have them generate an API key and secret for you.
To integrate with Paperplanes, use the Paperplane APIs to send recipient data to the MoEngage connectors.

​
Step 1: Create connector campaign on MoEngage

To create a connector campaign on MoEngage,
  1. Navigate to Create Campaign >> Connectors >> Custom
Screenshot_2022-02-21_at_10.48.46_PM.png
  1. On step 2 of the campaign, select -

​
a) URL details

KeyValue
MethodPOST
Webhook URLhttps://api.paperplaneslive.com/api/submit
URL params—

​
b) Headers

Add the following two headers
KeyValue
api-key<Paperplane API key>
api-secret<Paperplane secret>

​
c) Request Body

In the following request body, you can use any personalization attributes and build a custom request template. Select Raw and enter the following- 
{
"DestinationListId": 0,
"Records": [{
"CustomerID": "...",
"first_name": "...",
"last_name": "...",
"Address1": "...",
"Address2": "...",
"Address3": "...",
"Address4": "...",
"Address5": "...",
"Postcode": "...",
"AdditionalData": {}
}]
}
You can use personalisation using @ to select specific user/event attributes.

​
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 Screen_Shot_2022-02-22_at_11.12.42_AM.png Check the Paperplanes dashboard once you test the configuration or trigger the campaign.