Oppizi
Oppizi is the global leader in offline marketing, providing a one-stop solution for businesses to run measurable, targeted direct mail and flyering campaigns.
This integration is maintained by Oppizi.
Prerequisites
Requirement | Description |
---|---|
Oppizi account | An active Oppizi account is required to use this integration. |
Oppizi API key | Found in your Oppizi account in Integrations > Braze. |
Oppizi Direct Mail workflow ID | Create a workflow in Oppizi on the Direct Mail Workflow page to obtain an ID. |
Use cases
With the Oppizi integration, you can:
- Send automated direct mail postcards using Braze triggers connected to Oppizi’s webhook and direct mail workflows.
- Configure thresholds, waves, and limits in Oppizi direct mail workflows to control the sending of your campaigns.
- Design professional postcards with Oppizi’s built-in design tool—no design experience required.
- Track campaign performance in real time with Oppizi’s dashboard.
Integration
Step 1: Generate your Oppizi API key
To use your webhook template in Braze, you’ll first need to generate your Oppizi API key.
- Log into Oppizi.
- Go to Integrations > Braze.
- Generate your API key.
You can manage, revoke, and create your keys from this page as needed.
Step 2: Create a Braze webhook template
Next, create a webhook template for Oppizi in Braze to use in future campaigns or Canvases.
- In Braze, go to Templates > Webhook templates.
In your webhook template, fill out the following fields:
- Webhook URL:
https://webhook.oppizi.com/events
- Request body: Raw Text
For request method and headers, Oppizi requires an HTTP method along with the following HTTP headers to be included in the template. Fill out the following fields:
- HTTP method: POST
- Request headers:
- Authorization:
Bearer <oppiziAPIKey>
- Content-Type:
application/json
- Authorization:
For the Request Body, you must include the field oppiziWorkflowID. This ID is generated when a workflow is created in Oppiz and is required to specify which direct mail workflow your recipients should be added to. Each direct mail workflow in Oppizi has a unique ID, so if you create an Oppizi webhook template in Braze, make sure to always update the workflow ID to the correct one.
Check that required custom attributes are set up in your Braze account for your recipients’ postal addresses, as these are necessary for sending direct mail.
The following is an example request body:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
{
"event" : "workflow.addRecipient",
"oppiziWorkflowID" : "<oppiziWorkflowID>",
"recipient" : {
"brazeID" : "{{${braze_id}}}",
"firstName" : "{{${first_name}}}",
"lastName" : "{{${last_name}}}",
"address1" : "{{custom_attribute.${address1}}}",
"address2" : "{{custom_attribute.${address2}}}",
"city" : "{{custom_attribute.${city}}}",
"country" : "{{${country}}}",
"zipCode" : "{{custom_attribute.${zipCode}}}",
"state" : "{{custom_attribute.${state}}}"
}
}
Step 3: Create a Direct Mail Workflow in Oppizi
- In Oppizi, go to Direct Mail Workflow > Create workflow
- Configure workflow details, including thresholds, waves, postcard format, and artwork.
- In the webhook details section, you’ll find a ready-to-use request body, including your workflow ID, that you can paste directly into Braze.
Step 4: Preview and test your request in Braze
After adding your request body with Oppizi’s workflow ID, preview the request and run a test to confirm your setup is working as expected. Now, you’re ready to go with your automated direct mail campaigns.