Introduction
Integration
The MoEngage and Lob integration leverages MoEngage connectors and the Lob APIs to send mail like letters, postcards, and checks through the mail.
library_add_check |
Prerequisites 1. Ensure you have access to your Lob dashboard. 2. Ensure that you have your Lob API key. Your Lob API key can be found under the settings section under your name in the Lob dashboard. |
Step 1: Select Lob endpoint
The HTTP URL to request in the connector is different for each action you can make to Lob. In the following example, we use the postcards API endpoint https://api.lob.com/v1/postcards
. Visit the complete endpoint list to select the endpoint appropriate for your use case.
Step 2: Create connector campaign on MoEngage
To create a connector campaign on MoEngage,
1. Navigate to Create Campaign >> Connectors >> Custom
2. On step 2 of the campaign, select -
a) URL details
Key | Value | Notes |
---|---|---|
Method | POST | |
Webhook URL |
https://your-lob-API-endpoint | |
URL params | -- | Optional; Needed only if your URL contains personalised values |
b) Headers
Add the following two headers
Key | Value |
---|---|
Authorization | Basic <lob-API-key> |
Content-Type |
application/json |
c) Request Body
The following is an example request body for the Lob postcards endpoint. While this request body is provided in the base Lob template, if you wish to use other endpoints, you must adjust your Liquid fields accordingly.
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
Check the Lob dashboard once you test the configuration or trigger the campaign.