Sailthru

Connecting Sailthru to Poplar

We've provided the Poplar-specific webhook directions below. Sailthru's documentation is also available.

1. Create a new or select an existing Lifecycle Optimizer Flow under the Messaging tab in Sailthru.

2. Add an Action step to the flow.

3. Select Send Webhook in the dropdown.

4. Add our URL: https://api.heypoplar.com/v1/mailing/

5. Set the method to POST.

6. Set the content type to Other.

7. Add your formatted payload - this will change depending on the data structure of your Sailthru configuration, and what you want to pass into Poplar.

Email Append:

campaign_id=XXXXX&creative_id=XXXXX&recipient[email]={email}

Mailing Address:

campaign_id=XXXXX&creative_id=XXXXX&recipient[full_name]={profile.vars.full_name}&recipient[address_1]={profile.vars.address_1}&recipient[address_2]={profile.vars.address_2}&recipient[city]={profile.vars.city}&recipient[state]={profile.vars.state}&recipient[postal_code]={profile.vars.postal_code}

"Profile" Object Syntax

When formatting your Mailing Address payload, use & to separate parameters. Be careful not to include any breaks or spaces because they will prevent the data from passing to Poplar in the right format. Nested parameters live inside square brackets [...] and continue to nest within those brackets. For example, payloadcampaign_id=XXXXX&recipient[full_name]=Poplar&recipient[postal_code]=10004 would appear:

{
    "campaign_id":"XXXXX",
    "recipient": {
        "full_name":"Poplar",
        "postal_code:"10004"
    }
}

When pulling data, it is important to know when to use profile. vs profile.vars. Sailthru's Profile Object model is a useful reference.

• Useprofile.{insert-field-name} to pull from Sailthru's core data.

• Useprofile.vars.{your-custom-variable-name} to pull any custom variables you created that were not originally fields specified by Sailthru.

• Note: The customer email is an exception to the above. It is specifically referenced as {email}.

See the Sailthru Profile Object for complete details.

key	value
campaign_id	Copy from the right side of the Campaign > Overview
creative_id	(optional) Copy from the individual creative page under Campaign > Creative
full_name	(optional) You can also replace with a fixed string like Current Resident for use on the address block
first_name	When using first & last name instead of full name in your webhook you must use BOTH or it will error out
last_name
address_1
address_2
city
state
postal_code
email

You can also add merge tags with your own variable data at the end. When using first & last name options instead of full name you need to include both or it will error.

8. Add a HTTP Header and configure an Authorization key and set the Bearer <Your API Key> (make sure to also replace the <>)

We strongly recommend you use a test API key to start. Once your workflow is set up successfully and running in test mode, go back into the webhook and swap it out for a production API key to begin mailing.

9. Underneath Headers, you must also specify your Content-Type to be text/plain.

10. Test your webhook by sending a test through the flow, and then checking the History Tab of the campaign in Poplar to confirm that the data looks as you intended.

11. We recommend leaving the webhook live with your test key for a period of time to get a sense of your volume. Once it looks like it's working well, go back in and replace the API key with a production key to begin mailing.