Marketo

Connecting Marketo to Poplar

We've provided detailed Poplar specific integration docs below, you can alternatively reference the Marketo Webhook Docs on Creating, Calling, and using it in a Smart Campaign.

Creating a Custom Webhook in Marketo

1. Log into Marketo, Go to Admin and click Webhooks.

2. Click New Webhook.

3. Name and configure your webhook. It may be helpful to include Poplar, and the name of the campaign you're linking to. i.e. "Poplar-Abandoned-Cart"

4. Set the URL to: https://api.heypoplar.com/v1/mailing/

5. Set the type to POST

6. Set the Template as follows:

For an email append: the customer attribute names you have in your account may differ and need to be modified.

{
  "recipient": {
    "email": {{customer.email}}
  },
  "campaign_id": "******-REPLACE WITH YOUR CAMPAIGN ID-******-****"
}

For a full address mailing:

{
  "recipient": {
    "full_name" : {{customer.full_name}},
    "address_1": {{customer.address_1}},
    "address_2": {{customer.address_2}},
    "city": {{customer.city}},
    "state": {{customer.state}},
    "postal_code": {{customer.postal_code}}
  },
  "campaign_id": "******-REPLACE WITH YOUR CAMPAIGN ID-******-****"
}

key	value
campaign_id	Copy from the right side of the campaign page on Poplar
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.

7. Set the token & response types to to JSON

8. Click Create.

9. Custom Headers – Accessed through Webhooks Actions -> Set Custom Header, this menu allows the addition of any number of custom Key-Value pairs as HTTP Headers.

You'll want to configure an Authorization key and set the Bearer <Your API Key> (make sure to also replace the <>)

Create another header and use Content-type for the key, then application/json for the value.

10. Now you can add this new webhook as a node in any of your Smart Campaigns.

Calling Poplar via a Smart Campaign

1. Create a Smart Campaign.

2. Go to the Flow tab and drag in the Call webhook flow action.

3. Select the webhook (among the dropdown list of webhooks you've created).