Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.voucherify.io/llms.txt

Use this file to discover all available pages before exploring further.

Connect Voucherify resources and Bloomreach documents for easier CMS management related to the promotion offers, like coupons, cart-level promotion, etc. Create and manage the connection from the Bloomreach document by selecting available Voucherify resources.  Once the connection is set up in Bloomreach, it is also visible in Voucherify. The information about the related Bloomreach document ID(s) is stored in Voucherify’s resource metadata. A single Bloomreach document can be linked with multiple Voucherify resources and vice versa — a single Voucherify resource can be linked with multiple Bloomreach documents. Currently supported resources are: The integration with Bloomreach CMS uses API limits for downloading campaigns.

​
Integration configuration

Follow these steps to integrate Bloomreach CMS with Voucherify.

​
Voucherify

To connect Bloomreach with Voucherify, you need to generate new integration keys.
  1. Go to Project Settings and in the General tab, scroll down to Integration Keys.
  2. Click the plus button on the right.
  3. Fill in the Name for your key.
  4. Choose your role from the Role drop-down list.
  5. Choose Bloomreach from the Integration drop-down list.
  6. Click Create Integration API Key button.
Integration credentials are hidden after savingWhen you configure an external integration, API tokens and secret keys are only shown during setup. After you save the integration, these values are masked and cannot be viewed again in the Dashboard.This reduces the risk of exposing sensitive credentials through the user interface.Save your keys securely before closing the window.
You can also use the User role in the integration keys configuration (as it has Bloomreach permission selected by default). However, Voucherify recommends creating a new custom role only for integration purposes. Once the Bloomreach integration key is generated, it can be found in the Integration Keys section.

​
Bloomreach

To connect Bloomreach and Voucherify, you need to define a new custom integration in Bloomreach. Select from the left menu Setup, then Integrations, and Add a new Custom integration. In the Custom integration configuration:
  1. Fill in the Name field.
  2. Fill in the Application URL field to proper address, e.g.: https://eu1.cms-integrations.voucherify.io/frontend/bloomreach/
The address above is for the EU cluster. It can be different for shared or dedicated clusters. If you are not sure what your Voucherify cluster is, contact our Support Team.
  1. Set Configuration to stringified JSON with your Voucherify integration credentials (the ones generated in the step above) and desired resource types as follows:
{
  "appId": "YOUR_APPLICATION_ID",
  "appToken": "YOUR_SECRET_KEY",
  "resourceTypes": [
    "campaigns",
    "earningRules",
    "promotionTiers"
  ]
}
  1. Set Height(px) to a proper value. We recommend 50-60 px per resource type, so if you want to use all three available resource types (campaigns, earning rules, promotion tiers), you can set it to 180 px.
  2. Set CSP property to frame-src and ****.
Once the Voucherify integration is set up, you can define the content type. Select from the left menu Content, then choose Content types from the drop-down in the left column and select a New document type in the brxsaas folder. Then, fill in the Name and choose the required layout and build the desired layout. To include Voucherify integration, choose the Field extension option from Primitive Field list and use the Voucherify custom integration created in the previous steps in the Integration field. To allow your new content type, you need to add it to the document allowed content. In the Content section, choose Documents, then select the Edit allowed content from the folder options list. In the next window, select the content type created in the previous step. Once it is done, you can now create a new document.

​
Use guide

To get details about connected data, click the Connected <Resource type> button to see the connected data details. This window shows up to 10 elements per page. In the bottom right corner, you can see the total number of elements and you can change the page. You can also search resources by name with the search button in the top right corner. Once the Bloomreach document is connected with a Voucherify resource, it is also visible in Voucherify in the object Metadata tab.

​
Adding a connection

To add a connection:
  1. Go to document Edit mode in Bloomreach and click Manage Connected <Resource type>.
  2. In the new modal, click + Add <Resource type>.
  3. Find a resource that you want to connect and click Add.
  4. Click the Yes button to confirm your action in the new window.

​
Removing a connection

Deleting a connection is very similar to adding a new one.
  1. Go to document Edit mode in Bloomreach and click Manage Connected <Resource type>.
  2. In the new modal, find the resource whose connection you want to remove and Delete it.
  3. Click Yes to confirm your action in the new window.
If you delete a Bloomreach document that is connected to a Voucherify resource, that connection will not be deleted in Voucherify and vice versa — if a resource in Voucherify is deleted, the connection to the Bloomreach document will not be removed.
Last modified on April 20, 2026