Setting up a ZAP~POST integration

This integration is only available for Shopify customers. 

ZAP~POST is an automated direct mail provider. 

You can send Ometria segments to ZAP~POST and target them in your direct mail campaigns.

This article explains how to sync the addresses in Shopify with Ometria to make sure ZAP~POST has the data it needs.

Shopify setup

If Shopify is your ecommerce provider, the easiest thing to do is set up a Flow in Shopify which triggers address updates to Ometria.

ZAP~POST will set up this Flow for you, please reach out to your contact there for assistance.

Set up your custom fields

If you're not already ingesting contact address details, you'll need to create the following custom fields in your Ometria account.

These match fields in Shopify Flow, so make sure the field IDs are exactly as listed:

Adding the flow to Shopify

Reach out to your contact at ZAP~POST and let them know you've set up the custom fields.

ZAP~POST will work with you to set up a Shopify Flow, which will sync mailing addresses in Shopify with Ometria.

Multiple stores

If you have multiple Shopify stores you'll need to import the flow for each of them.

Updating your historic addresses

Once you've updated your ecommerce API, you'll need to export the email and address fields and then upload them to Ometria via CSV.

See: CSV Upload

Once this is done, your contacts' address details will be up to date in Ometria and the API will continue to update and populate any new address data.

Set up your webhook

Ometria uses a webhook in an automation campaign to sync contacts with ZAP~POST in real time.

The webhook passes a single contact to ZAP~POST, who stores the records and batch them at the end of the day. 

Follow the steps for setting up webhooks using the following information:

{
  "campaignId": "**Needs to be taken from Zap Post App**",
  "scheduledSendDateId": "",
  "onlyValidRecords": false,
  "submissions": [
    {
      "customerid": "{{ profile.email }}",
      "email": "{{ profile.email }}",
      "salutation": "{{ profile.prefix }}",
      "firstname": "{{ profile.firstname }}",
      "surname": "{{ profile.lastname }}",
      "address1": "{{profile.properties.address_line_1}}",
      "address2": "{{profile.properties.address_line_2}}",
      "address3": "{{profile.properties.address_line_3}}",
      "city": "{{profile.properties.city}}",
      "postcode": "{{profile.properties.postcode}}",
      "country": "UK"
            }
    }
  ]
}

See: ZAP~POST default fields

Once your webhook is set up and tested, you can use it in an automation campaign.

Dynamic segments and automation campaigns

ZAP~POST collects dynamic segments from Ometria via the Lists endpoint.

You'll need to create the segments you require in Ometria (e.g. unengaged contacts for a re-engagement campaign).

See: Create a dynamic segment

Go to Saved segments and copy the ID for your new segments to ZAP~POST:

To make sure these segments are regularly refreshed (every four hours), create an automation campaign using Contact has entered a segment as the trigger:

Save and publish your campaign.

ZAP~POST payload example

{
  "campaignId": "**Needs to be taken from Zap Post App**",
  "scheduledSendDateId": "",
  "onlyValidRecords": false,
  "submissions": [
    {
      "customerid": "{{ profile.email }}",
      "email": "{{ profile.email }}",
      "salutation": "{{ profile.prefix }}",
      "firstname": "{{ profile.firstname }}",
      "surname": "{{ profile.lastname }}",
      "address1": "{{profile.properties.address_line_1}}",
      "address2": "{{profile.properties.address_line_2}}",
      "address3": "{{profile.properties.address_line_3}}",
      "city": "{{profile.properties.city}}",
      "postcode": "{{profile.properties.postcode}}",
      "country": "UK"
            }
    }
  ]
}

Next steps and support

Please reach out to your contact at ZAP~POST for any further questions or support.