> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mention-me.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Set Up Bloomreach with Mention Me

> Connect your Bloomreach account to Mention Me to sync referral data, opt-ins, and activate pre-built scenarios.

## About the integration

Activate your biggest fans by feeding first-party advocacy data directly into Bloomreach to enable higher engagement, retention, and revenue across your customer base.

## Integration capabilities

* Send contact data and opt-ins from Mention Me referred customers to Bloomreach in real time
* Use referral data to power coupon email reminders
* Segment and target high-value customers with referral and advocacy data to enhance other marketing channels

## Prerequisites

* **Bloomreach** — Access to [create private API keys](https://documentation.bloomreach.com/engagement/reference/prerequisites).
* **Mention Me** — Access to the [Mention Me platform](https://mention-me.com/login). If not, contact your Mention Me CSM or [submit a support request](https://help.mention-me.com/hc/en-gb/requests/new).

## Step 1: Create Mention Me events in Bloomreach (optional)

Only required if your Bloomreach project prevents 3rd parties from creating events via the API. If you're unsure, check with your Bloomreach Admin.

<Steps>
  <Step title="Log in to Bloomreach">
    [Log in](https://app.exponea.com/login) to Bloomreach.
  </Step>

  <Step title="Navigate to Events in Data Manager">
    Navigate to **Data & Assets > Data Manager > Events**.

    <img src="https://mintcdn.com/mentionme/Dd_TNqD5daJEFstQ/images/knowledge/esp-crm/bloomreach/14840466255389.png?fit=max&auto=format&n=Dd_TNqD5daJEFstQ&q=85&s=c4ddc7519a7a6a15a6ed1311cebe1bf6" alt="Bloomreach Data Manager Events navigation" width="1046" height="416" data-path="images/knowledge/esp-crm/bloomreach/14840466255389.png" />

    Create the following events (case-sensitive):

    * `registered_as_referee`
    * `registered_as_referrer`
    * `received_referee_reward`
    * `received_referrer_reward`
    * `submitted_nps_score`
    * `received_reward_next_order`
    * `propensity_to_refer`
  </Step>
</Steps>

## Step 2: Create API keys in Bloomreach

<Steps>
  <Step title="Log in to Bloomreach">
    [Log in](https://app.exponea.com/login) to Bloomreach.
  </Step>

  <Step title="Go to API access management">
    Go to **Project Settings > Access Management > API**.

    [Learn more about private API access](https://documentation.bloomreach.com/engagement/reference/authentication#private-api-access).

    <img src="https://mintcdn.com/mentionme/Dd_TNqD5daJEFstQ/images/knowledge/esp-crm/bloomreach/12484019527837.png?fit=max&auto=format&n=Dd_TNqD5daJEFstQ&q=85&s=085150d9694fc9296872341016108543" alt="Bloomreach API access management navigation" width="1807" height="487" data-path="images/knowledge/esp-crm/bloomreach/12484019527837.png" />
  </Step>

  <Step title="Create a new API group">
    Create a new API group for Mention Me with private access.

    <img src="https://mintcdn.com/mentionme/Dd_TNqD5daJEFstQ/images/knowledge/esp-crm/bloomreach/12483990822557.png?fit=max&auto=format&n=Dd_TNqD5daJEFstQ&q=85&s=f950daad5d4e4cbde86bfb8e44dfa720" alt="Creating new API group for Mention Me" width="682" height="510" data-path="images/knowledge/esp-crm/bloomreach/12483990822557.png" />
  </Step>

  <Step title="Copy the API Secret">
    Copy the **API Secret** (you'll only see it once).

    <img src="https://mintcdn.com/mentionme/Dd_TNqD5daJEFstQ/images/knowledge/esp-crm/bloomreach/12484019537309.png?fit=max&auto=format&n=Dd_TNqD5daJEFstQ&q=85&s=8a4ef97bfa4b6593782f7e01d2bf511b" alt="Copying API Secret from Bloomreach" width="683" height="451" data-path="images/knowledge/esp-crm/bloomreach/12484019537309.png" />
  </Step>

  <Step title="Copy API Key, Project Token, and Base URL">
    Copy your:

    * API Key
    * Project Token
    * Base URL

          <img src="https://mintcdn.com/mentionme/Dd_TNqD5daJEFstQ/images/knowledge/esp-crm/bloomreach/12484019537949.png?fit=max&auto=format&n=Dd_TNqD5daJEFstQ&q=85&s=158737ef41f93c5d913b5d0297da79a4" alt="API Key and Project Token in Bloomreach" width="652" height="276" data-path="images/knowledge/esp-crm/bloomreach/12484019537949.png" />

          <img src="https://mintcdn.com/mentionme/Dd_TNqD5daJEFstQ/images/knowledge/esp-crm/bloomreach/12484019539101.png?fit=max&auto=format&n=Dd_TNqD5daJEFstQ&q=85&s=4fb2cc82b17082a7dfd6a755304dac92" alt="Base URL configuration in Bloomreach" width="854" height="308" data-path="images/knowledge/esp-crm/bloomreach/12484019539101.png" />
  </Step>

  <Step title="Set API access permissions">
    Set the API access permissions under **Customer Properties** and **Events**.

    ### Customer Properties

    <img src="https://mintcdn.com/mentionme/Dd_TNqD5daJEFstQ/images/knowledge/esp-crm/bloomreach/14878702555677.png?fit=max&auto=format&n=Dd_TNqD5daJEFstQ&q=85&s=b3c6aa940d74455243192c9098d392e6" alt="Customer Properties permissions part 1" width="1883" height="416" data-path="images/knowledge/esp-crm/bloomreach/14878702555677.png" />

    <img src="https://mintcdn.com/mentionme/Dd_TNqD5daJEFstQ/images/knowledge/esp-crm/bloomreach/13515232320669.png?fit=max&auto=format&n=Dd_TNqD5daJEFstQ&q=85&s=4990adaac44dd47f9a13f17666376570" alt="Customer Properties permissions part 2" width="1066" height="180" data-path="images/knowledge/esp-crm/bloomreach/13515232320669.png" />

    <img src="https://mintcdn.com/mentionme/Dd_TNqD5daJEFstQ/images/knowledge/esp-crm/bloomreach/13515205793181.png?fit=max&auto=format&n=Dd_TNqD5daJEFstQ&q=85&s=bddb9791f1869714d294c40a9f6b5662" alt="Customer Properties permissions part 3" width="1035" height="175" data-path="images/knowledge/esp-crm/bloomreach/13515205793181.png" />

    | Property         | Get | Set | Notes                               |
    | ---------------- | --- | --- | ----------------------------------- |
    | New Properties   | Yes | Yes |                                     |
    | Other Properties | Yes | Yes |                                     |
    | Email            | Yes | Yes | If not included in Other Properties |

    ### Events

    <img src="https://mintcdn.com/mentionme/Dd_TNqD5daJEFstQ/images/knowledge/esp-crm/bloomreach/13128313120285.png?fit=max&auto=format&n=Dd_TNqD5daJEFstQ&q=85&s=8b1e0a5140d748dbc551ee7c4a34af24" alt="Events permissions configuration part 1" width="2976" height="732" data-path="images/knowledge/esp-crm/bloomreach/13128313120285.png" />

    <img src="https://mintcdn.com/mentionme/Dd_TNqD5daJEFstQ/images/knowledge/esp-crm/bloomreach/13516526333597.png?fit=max&auto=format&n=Dd_TNqD5daJEFstQ&q=85&s=a44dd69232d00a1447d4c56a6f67f523" alt="Events permissions configuration part 2" width="1066" height="180" data-path="images/knowledge/esp-crm/bloomreach/13516526333597.png" />

    | Event                      | Get | Set | Notes                                                                                          |
    | -------------------------- | --- | --- | ---------------------------------------------------------------------------------------------- |
    | New / Other Events         | Yes | Yes | If you prevent 3rd party event creation, these must be created manually as outlined in Step 1. |
    | consent                    | Yes | Yes |                                                                                                |
    | registered\_as\_referee    | Yes | Yes |                                                                                                |
    | registered\_as\_referrer   | Yes | Yes |                                                                                                |
    | received\_referee\_reward  | Yes | Yes |                                                                                                |
    | received\_referrer\_reward | Yes | Yes |                                                                                                |
    | submitted\_nps\_score      | Yes | Yes |                                                                                                |
    | propensity\_to\_refer      | Yes | Yes |                                                                                                |
  </Step>
</Steps>

## Step 3: Set up the integration in Mention Me

<Steps>
  <Step title="Connect on Mention Me platform">
    Log in to [Mention Me](https://mention-me.com/merchant/~/integrations/bloomreach) and click **Connect**.

    <img src="https://mintcdn.com/mentionme/Dd_TNqD5daJEFstQ/images/knowledge/esp-crm/bloomreach/12484019543325.png?fit=max&auto=format&n=Dd_TNqD5daJEFstQ&q=85&s=33c93938146a541fa5811ec78514bc81" alt="Mention Me Bloomreach integration connect page" width="2606" height="1340" data-path="images/knowledge/esp-crm/bloomreach/12484019543325.png" />
  </Step>

  <Step title="Accept terms and conditions">
    Agree to Mention Me's Terms and Conditions if required.

    <img src="https://mintcdn.com/mentionme/Dd_TNqD5daJEFstQ/images/knowledge/esp-crm/bloomreach/12483990837277.png?fit=max&auto=format&n=Dd_TNqD5daJEFstQ&q=85&s=26d686459a4fd42002f2a695591a8cdd" alt="Terms and conditions acceptance for Bloomreach integration" width="1432" height="520" data-path="images/knowledge/esp-crm/bloomreach/12483990837277.png" />
  </Step>

  <Step title="Click New Authentication">
    Click **New Authentication**.

    <img src="https://mintcdn.com/mentionme/YY0faS_cOHOI7wKY/images/knowledge/esp-crm/bloomreach/22260891431709.png?fit=max&auto=format&n=YY0faS_cOHOI7wKY&q=85&s=d49042f73a643e5993ea5a4d25bcd96c" alt="New Authentication button in Mention Me" width="723" height="389" data-path="images/knowledge/esp-crm/bloomreach/22260891431709.png" />
  </Step>

  <Step title="Name the authentication and project">
    Name the authentication and project for clear identification.

    <img src="https://mintcdn.com/mentionme/YY0faS_cOHOI7wKY/images/knowledge/esp-crm/bloomreach/22260872696989.png?fit=max&auto=format&n=YY0faS_cOHOI7wKY&q=85&s=e2ee9eb2da61e58850c59d0bb5bed7fd" alt="Naming the Bloomreach authentication" width="721" height="393" data-path="images/knowledge/esp-crm/bloomreach/22260872696989.png" />
  </Step>

  <Step title="Enter API credentials">
    Enter:

    * API Key
    * API Secret
    * Project Token
    * Base URL

          <img src="https://mintcdn.com/mentionme/YY0faS_cOHOI7wKY/images/knowledge/esp-crm/bloomreach/22260891434525.png?fit=max&auto=format&n=YY0faS_cOHOI7wKY&q=85&s=29237e18d5d5078499b761b864b5b056" alt="Entering Bloomreach API credentials in Mention Me" width="1662" height="1072" data-path="images/knowledge/esp-crm/bloomreach/22260891434525.png" />
  </Step>

  <Step title="Click Next">
    Click **Next**.

    <img src="https://mintcdn.com/mentionme/YY0faS_cOHOI7wKY/images/knowledge/esp-crm/bloomreach/22260872699293.png?fit=max&auto=format&n=YY0faS_cOHOI7wKY&q=85&s=be92e1b73dcf7967aefbb3c162f8dc6c" alt="Proceeding to next step after credentials" width="977" height="524" data-path="images/knowledge/esp-crm/bloomreach/22260872699293.png" />
  </Step>

  <Step title="Select the Consent Category">
    Select the **Consent Category** opt-ins should map to.

    <img src="https://mintcdn.com/mentionme/YY0faS_cOHOI7wKY/images/knowledge/esp-crm/bloomreach/22260891436061.png?fit=max&auto=format&n=YY0faS_cOHOI7wKY&q=85&s=93487cac5d4a5ef112c8afa937b09cdf" alt="Selecting Consent Category for opt-ins" width="977" height="524" data-path="images/knowledge/esp-crm/bloomreach/22260891436061.png" />

    <Note>Mention Me captures opt-ins during the referee or post-purchase flow.</Note>
  </Step>

  <Step title="Configure custom identifier">
    If using a custom identifier (instead of the default 'registered'), enter it; otherwise click **Authorise**.

    <img src="https://mintcdn.com/mentionme/YY0faS_cOHOI7wKY/images/knowledge/esp-crm/bloomreach/26122342934429.png?fit=max&auto=format&n=YY0faS_cOHOI7wKY&q=85&s=ed0678562cd67d6e3790021c2dd6efdb" alt="Custom identifier configuration for Bloomreach" width="981" height="377" data-path="images/knowledge/esp-crm/bloomreach/26122342934429.png" />

    <Note>If this value is incorrect, contacts won't be created or updated.</Note>
  </Step>

  <Step title="Select countries to sync">
    Select the country/countries you want to sync.

    <img src="https://mintcdn.com/mentionme/YY0faS_cOHOI7wKY/images/knowledge/esp-crm/bloomreach/22260872706205.png?fit=max&auto=format&n=YY0faS_cOHOI7wKY&q=85&s=be95b161066b050b06fc87848bd1a3c2" alt="Selecting countries to sync with Bloomreach" width="991" height="553" data-path="images/knowledge/esp-crm/bloomreach/22260872706205.png" />
  </Step>

  <Step title="Finalise the connection">
    Click **Connect** to finalize setup.

    <img src="https://mintcdn.com/mentionme/YY0faS_cOHOI7wKY/images/knowledge/esp-crm/bloomreach/22260891439773.png?fit=max&auto=format&n=YY0faS_cOHOI7wKY&q=85&s=b6d5233873195b5efeef682ea2ba8776" alt="Bloomreach integration success confirmation" width="1332" height="807" data-path="images/knowledge/esp-crm/bloomreach/22260891439773.png" />

    Once connected, Mention Me events and customer data will flow into Bloomreach. Use this data in Scenarios and segmentation.

    For help, contact your Mention Me CSM or [submit a support request](https://help.mention-me.com/hc/en-gb/requests/new).
  </Step>
</Steps>

## Step 4: Install pre-built initiatives

Mention Me provides ready-made Scenarios and Segments you can use instantly within Bloomreach.

Follow [these instructions](/knowledge/esp-crm/bloomreach/setup) to import and activate them in your account.