Iterable is a cross-channel marketing platform that powers unified customer experiences and empowers you to create, optimize and measure every interaction across the entire customer journey. Automated connections in Iterable, called Journey Webhooks, can be set up in minutes with no coding. Webhooks can automate your day-to-day tasks and enable mail sends with Lob.
There are 3 common scenarios in which Iterable Journeys can trigger Lob mail sends:
Each Journey Webhook you create will connect to an HTML template that you have stored in your Lob account. You will map your Iterable data fields to the dynamic Lob merge variables in the HTML template, and trigger mail sends via either an individual user action or to a group of users.
This tutorial assumes you have signed up for a free Lob account. You can then begin sending API requests right away using your secret Test API key, at no cost and without entering any payment info. (Instantly begin sending real mail by simply adding a payment method to your account and switching to your live API key.)
We also assume you have an HTML template(s) for your mailpiece. (Don't have one? Check out our direct mail template gallery.) To leverage HTML creatives in Lob, you will want to save your HTML as a template within Lob (in your dashboard under HTML Templates), or host your HTML and generate a corresponding hosting URL. These can be passed to Lob from Iterable, but you are not able to pass a full HTML string directly to Lob from Iterable.
To get started with Iterable, you will need to sign up directly with Iterable (see Request Demo on Iterable website), or have your Iterable account enabled by your company.
1. Login to your Iterable Account.
2. Navigate to "Integrations" -> “Journey Webhooks”
3. Then click on ‘New webhook’ at the top of the page
4. Configure as follows:
5. Map your variables. The fields on the left are the required Lob request parameters, and your corresponding data fields are on the right.
6. Click ‘Create Webhook.’
7. Ensure that you are mapping all of the required HTML templates. For example, Postcards and Self Mailers will utilize two templates, one each for the front and back. Letters have just one template, mapped to the parameter ‘file’ on the left side
8. Click ‘Save’ on the right when you are finished.
9. Navigate to “Messaging”> “Journeys”
10. Click on the Journey you want to incorporate this webhook into, or create a new Journey.
11. Find the event that will trigger your Lob webhook (for example, a customer is Added to a List, or opened an email), then drag in the “Call webhook” tile and place it after that event in the Journey.
12. Open up that Webhook, and toggle on ‘Use Preset Journey Webhook’, then select the webhook you have created.
13. After you have successfully set up your Journey, send a test trigger by clicking on ‘Test Journey’. Check to see whether Iterable notes any errors.
14. Assuming no errors are caught in Iterable, head over to your Lob dashboard and verify the results of the test; you can see the new mailpieces that were generated from your Iterable journey.
Again, we recommend testing any triggered by first using your Test Lob API Keys, and ensuring that the resulting records created in Lob match your expectations. When you are ready to send actual mail, you’ll need to input a payment method for live sends and use your Live Lob API Key—then you are off to the races!