# 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.

<figure><img src="/files/yRQgrehEDpPnLGsHt5Hy" alt="Bloomreach API access values"><figcaption></figcaption></figure>

{% hint style="warning" %}
Your Bloomreach API key must have permission to create new events.
{% endhint %}

### Get your Bloomreach API credentials

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

<figure><img src="/files/XSWFNfdDlfH7RfBHxLFL" alt="Bloomreach project settings"><figcaption></figcaption></figure>

3. Go to `Access Management` → `API`.

<figure><img src="/files/XOqNqXbKZsvMVDX5d4qx" alt="Access Management > API"><figcaption></figcaption></figure>

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

<figure><img src="/files/QOam5KeO9x1ZUWGhJ3p5" alt="Create a new API key"><figcaption></figcaption></figure>

5. Click `Create`, then copy:
   * API key ID
   * API secret (shown once)

<figure><img src="/files/BJ9eUpUL3TdXsAab35OD" alt="Copy API key ID and secret"><figcaption></figcaption></figure>

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

<figure><img src="/files/bICczALLEOnelK9f1Q6M" alt="API key permissions"><figcaption></figcaption></figure>

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

<figure><img src="/files/C8EIavJ9X0ok2gqbeR3b" alt="Project token and base URL"><figcaption></figcaption></figure>

### Connect Bloomreach in the ZAP-POST app

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

<figure><img src="/files/vfW00EtwjiUku0RCbO56" alt="Integrations tile on the dashboard"><figcaption></figcaption></figure>

3. Select the Bloomreach tile.

<figure><img src="/files/wXPg0d1uFGm1v4rD7rkX" alt="Bloomreach integration tile"><figcaption></figcaption></figure>

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

<figure><img src="/files/kt6XERd1cudD8HBnm3Ih" alt="Enter Bloomreach credentials in ZAP~POST"><figcaption></figcaption></figure>

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

{% hint style="info" %}
To disable the integration later, click `Disconnect` on the same screen.
{% endhint %}

<figure><img src="/files/IZZ89hPXw7ZI0BWVlMwl" alt="Disconnect Bloomreach integration"><figcaption></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://userguide.zappost.com/zap-integrations/zap-post-integrations/bloomreach/populating-bloomreach-with-zap-post-events/installation-guide.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.