# Braze

We've provided detailed Poplar specific integration docs below, you can alternatively reference the [Braze Webhook Documentation](https://www.braze.com/docs/user_guide/message_building_by_channel/webhooks/creating_a_webhook/).

### Creating a Poplar Webhook Template in Braze

1. Log into Braze, in the left navigation select **Templates ->** **Webhook Templates**
2. Select **Create Webhook Template**
3. Give your new template a name like: `Poplar Mail Trigger` and select "**Compose Webhook: Start from scratch**"
4. Under the configuration set the **Webhook URL** to: `https://api.heypoplar.com/v1/mailing/`
5. Switch the **Request Body** in the dropdown to **Raw Text**
6. You can then set up either an email append or an addressed API request template. You'll need to copy the campaign ID from **Poplar -> Campaign -> Campaign Overview**.

![braze - 1](https://1498057380-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7WIkx4Ya8TaaDuayPNdP%2Fuploads%2FuERFt3S7Zf5rAptCdVhl%2FScreenshot%202026-02-20%20at%201.09.20%E2%80%AFPM.png?alt=media\&token=f114b6a6-bf5e-43cd-8476-b2a927a13d88)

#### Email Append

```
{
  "recipient": {
    "email": "{{${email_address}}}"
  },
  "campaign_id": "REPLACE-WITH-YOUR-CAMPAIGN-ID"
}
```

#### Addressed User

```
{
  "recipient": {
    "full_name": "{{${first_name}}} {{${last_name}}}",
    "address_1": "{{custom_attribute.${address_1}}}",
    "address_2": "{{custom_attribute.${address_2}}}",
    "city": "{{${city}}}",
    "state": "{{custom_attribute.${state}}}",
    "postal_code": "{{custom_attribute.${postal_code}}}"
  },
  "campaign_id": "REPLACE-WITH-YOUR-CAMPAIGN-ID"
}
```

Depending on your custom attribute configuration you'll need to modify the names of the attributes from what is in the code above.

7. Select **Add New Header**. You'll want to configure an `Authorization` key and set the `Bearer <Your API Key>` (make sure to also remove the <>)

Head over to Poplar to get a **Test API Key:** [**https://app.heypoplar.com/integrations/api\_keys**](https://app.heypoplar.com/integrations/api_keys) We highly recommend setting things up using a Test API Key first because it will let you create digital proofs and check them before switching to a Production API key.&#x20;

![braze- 1 copy](https://1498057380-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7WIkx4Ya8TaaDuayPNdP%2Fuploads%2Fk61ViVgp7Tw7JCSU4vpI%2FScreenshot%202026-02-20%20at%201.16.00%E2%80%AFPM.png?alt=media\&token=99940f84-9ced-400e-b91c-8a23d90b9150)

8. Back in Braze, select the **Test** tab to test your template. Either select an existing user, or if you don't have user data select custom and send a test to Poplar. You can then head over to Poplar -> Campaigns -> Click into your **Campaign** and scroll down to the **History** to view the test you sent.
9. Once your template is successful, you can then go to Campaigns and add a new campaign or edit an existing campaign to add a webhook. Then select the template you just created to use it.
10. After selecting the template you can select your targeting and delivery settings as you would normally for any other Braze campaign.

{% hint style="info" %}
We recommend leaving the campaign live with a test API key for a period of time to make sure it's working correctly and the segmentation and delivery is correct. Then swap out the key for a production key to begin mailing.&#x20;
{% endhint %}