Inkit Direct Mail Integration

Inkit enables you to save time and effort by automating your direct mail campaigns and bring offline customers back online. You can access Inkit’s services through Braze’s webhook feature and send mail to your users.

Requirements

Requirement Origin Access Description
Inkit API Key Inkit Inkit Dashboard This key will enable you to connect your Braze and Inkit accounts.
Inkit Template ID Inkit Found within the URL for each template. This key will enable you to send your template to Braze.
Within the URL https://app.inkit.io/#/templates/design/bd9b0b8c-c47b-40ae-8787-80dd76f6d2bb, the Template ID is bd9b0b8c-c47b-40ae-8787-80dd76f6d2bb.
HTTP Header Inkit Inkit Account You will combine this with your Inkit API Key to authorize the connection as a key value pair within your Braze template.

Integration

You will need to use both your Inkit and Braze accounts to use the Inkit integration.

Step 1: Create a Webhook Template in Braze

You can create this from the Templates & Media section, or create a new Webhook Campaign in Braze.

Inkit_Webhook_Template

Once you have selected the Inkit webhook template, you should see the following:

  • Webhook URL: https://internal.inkit.io/integrations/webhook
  • Request Body: Raw Text
  • HTTP Method: POST

Step 2: Fill Out Your Template

Please ensure that your liquid matches the proper custom attributes associated with the required and optional fields listed below. You can also add custom data fields to any request.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16

{
  "api_token": "INKIT_API_TOKEN",
  "template_id": "INKIT_TEMPLATE_ID",
  "company (optional)": "{{custom_attribute.${company_name}}}",
  "email": "{{${email_address}}}",
  "first_name": "{{${first_name}}}",
  "last_name": "{{${last_name}}}",
  "street": "{{custom_attribute.${address}}}",
  "unit (optional)": "{{custom_attribute.${address2}}}",
  "city": "{{${city}}}",
  "state": "{{custom_attribute.${state}}}",
  "zip": "{{custom_attribute.${zip}}}",
  "country": "{{${country}}}"
}

Replace the necessary fields with the correct information - specifically INKIT_API_TOKEN and INKIT_TEMPLATE_ID.

Inkit Integration

Inkit also requires a HTTP Header for authorization that includes your Inkit API key. The following will already be included within the template as a key-value pair, but you will need to replace INKIT_API_TOKEN with your Inkit API key.

  • Header Name: Authorization
  • Header Value: { Basic {{ 'INKIT_API_TOKEN' | base64_encode }} }

Step 3: Preview Your Request

You will see that your raw text automatically highlights if it is an applicable Braze tag. You must have street, unit, state, and zip set up as custom attributes to send this Webhook.

You should be able to preview your request in the left-hand panel, or navigate to the Test tab, where you can select a random user, an existing user, or customize your own to test your webhook.

See Inkit’s integration docs here.

Usage

If you hadn’t created this in Templates & Media, you can go to Campaigns, then click + Create Campaign. Select “Webhook” and choose your template from the “Saved Webhook Template” list. Create your Webhook!

Inkit Usage

WAS THIS PAGE HELPFUL?
New Stuff!