Installation Guide

This guide walks you through connecting Bloomreach Engagement to ZAP-POST.

Prerequisites

You’ll need these values from Bloomreach:

1. Project token
2. Project ID (if shown separately)
3. API base URL
4. API key ID
5. API secret

If you don’t see a separate Project ID in Bloomreach, you can skip it.

Your Bloomreach API key must have permission to create new events.

Get your Bloomreach API credentials

1. Sign in to Bloomreach Engagement: https://engagement.bloomreach.com/.
2. Open Settings and select Project settings.

1. Go to Access Management → API.

1. Add a new API key and give it a name.

1. Click Create, then copy:

   • API key ID
   • API secret (shown once)

1. Confirm the API key has permissions to set/create events.

1. Copy the project token, project ID (if shown), and API base URL from the same screen.

Connect Bloomreach in the ZAP-POST app

1. Sign in to ZAP-POST: https://app.zappost.com/.
2. From the Dashboard, open Integrations.

1. Select the Bloomreach tile.

1. Enter the Bloomreach values you gathered earlier. Each field matches the label shown in Bloomreach API access settings.

1. Click Connect. ZAP-POST tests the credentials and confirms the connection.

To disable the integration later, click Disconnect on the same screen.