--- title: "Getting Started" slug: "bloomreach-getting-started" updated: 2025-07-16T19:43:32Z published: 2025-07-16T19:43:32Z canonical: "support.jacquard.com/bloomreach-getting-started" --- > ## Documentation Index > Fetch the complete documentation index at: https://support.jacquard.com/llms.txt > Use this file to discover all available pages before exploring further. # Getting Started ### Create your token Before we begin this process, make sure you've got your **Jacquard Connect Server token** handy. If you don't have one, your Jacquard admin can create one for you by following [these instructions](/v1/docs/creating-api-tokens). ### Jacquard and Bloomreach Jacquard's Bloomreach integration leverages our cutting-edge Dynamic Optimisation technology. Dynamic Optimisation powers real-time optimisation by evaluating and reacting to how your subscribers are responding to language during a deployment. This ensures the best-performing language reaches the widest possible audience. To get these two technologies talking to each other correctly, we'll need to set up two Bloomreach integrations. Let's start with HTTP Authentication Schemas. ### HTTP Authentication Schemas This integration will handle the authentication of the real-time endpoint call Bloomreach will make to Jacquard. Essentially, it's preprogramming a password of sorts for Bloomreach to use when reaching out to Jacquard for your language variants. On the left side of your screen in Bloomreach, hover over **Data & Assets** and then click **Integrations**. [![](https://downloads.intercomcdn.com/i/o/420841377/6573409832547213917e1a5f/image.png?expires=1749730500&signature=71c298ccb382d2aa9848dd72bfb0fa896be642dcea3eb3641fbfa0bf0038c431&req=cCInHs1%2FnoZYFb4f3HP0gAiFFWf5CX9mYnkdgkVN3pWFw9ngU%2FZmJxpiRhTX%0AxJzLzOpEOELkModF2g%3D%3D%0A)](https://downloads.intercomcdn.com/i/o/420841377/6573409832547213917e1a5f/image.png?expires=1749730500&signature=71c298ccb382d2aa9848dd72bfb0fa896be642dcea3eb3641fbfa0bf0038c431&req=cCInHs1%2FnoZYFb4f3HP0gAiFFWf5CX9mYnkdgkVN3pWFw9ngU%2FZmJxpiRhTX%0AxJzLzOpEOELkModF2g%3D%3D%0A) Click **Add new integration**. [![](https://downloads.intercomcdn.com/i/o/420842638/08fea755e23ce9e3e83e8ebf/image.png?expires=1749730500&signature=b183dd060250214f7cdd80af2ed31eae3e43def72c99a7cb17e5b9ca7a02f025&req=cCInHs18m4JXFb4f3HP0gCkybjUPL8p59ncKQO7dX4fIFA%2FOe8myKrKseP04%0AskVggqsReAJE47d65A%3D%3D%0A)](https://downloads.intercomcdn.com/i/o/420842638/08fea755e23ce9e3e83e8ebf/image.png?expires=1749730500&signature=b183dd060250214f7cdd80af2ed31eae3e43def72c99a7cb17e5b9ca7a02f025&req=cCInHs18m4JXFb4f3HP0gCkybjUPL8p59ncKQO7dX4fIFA%2FOe8myKrKseP04%0AskVggqsReAJE47d65A%3D%3D%0A) Hover over **HTTP Authentication Schemas** and click **Add integration**. [![](https://downloads.intercomcdn.com/i/o/420843471/c6818bec003ec93e1115753c/image.png?expires=1749730500&signature=506be7aaaecf73543b0e5a8653aaae908cd4b0c077800564c9206ba06bde76ed&req=cCInHs19mYZeFb4f3HP0gIC%2F00DV%2Bw0odobR7Fm2BjPHfLfkqSAcvL4pBprw%0AJVMmxULaOPc6LfWIsA%3D%3D%0A)](https://downloads.intercomcdn.com/i/o/420843471/c6818bec003ec93e1115753c/image.png?expires=1749730500&signature=506be7aaaecf73543b0e5a8653aaae908cd4b0c077800564c9206ba06bde76ed&req=cCInHs19mYZeFb4f3HP0gIC%2F00DV%2Bw0odobR7Fm2BjPHfLfkqSAcvL4pBprw%0AJVMmxULaOPc6LfWIsA%3D%3D%0A) Start by giving the integration a unique name. In the example below, we have used **Phrasee Realtime**. For the **Endpoint**, you should use **https://realtime.phrasee.co**. Then, select the **Custom headers** option. Under **Key**, type **Authorization**. For the **Value**, you should type **Bearer** and then a single space. After the space, paste your Jacquard Connect Server token. Now, set the **Type** to **public.** When you're done, it should look something like the below: [![](https://downloads.intercomcdn.com/i/o/420871386/bfc9a1170f0a96bc2e98de1f/image.png?expires=1749730500&signature=e2d6950c148faa125c43176a3a7e780e18f4c221b917cbb57c5a600bcfd9fc62&req=cCInHs5%2FnolZFb4f3HP0gF9Ey798dnDNYuE0EDDnq7yesw8PscBjlsP2GEe2%0AyBvZD8RKJkJyhU7bNA%3D%3D%0A)](https://downloads.intercomcdn.com/i/o/420871386/bfc9a1170f0a96bc2e98de1f/image.png?expires=1749730500&signature=e2d6950c148faa125c43176a3a7e780e18f4c221b917cbb57c5a600bcfd9fc62&req=cCInHs5%2FnolZFb4f3HP0gF9Ey798dnDNYuE0EDDnq7yesw8PscBjlsP2GEe2%0AyBvZD8RKJkJyhU7bNA%3D%3D%0A) Now, you can save this integration with the **Save changes** button. ### Webhook preset The second Bloomreach integration we need to set up is the Webhook preset. This is the technology that will actually pass your language variants from Jacquard to Bloomreach. Head back to the **Integrations** section we were in before. Hover over **Webhook preset** and click **Add integration**. [![](https://downloads.intercomcdn.com/i/o/420877519/33cfee43ed62e52bf183b532/image.png?expires=1749730500&signature=23b4bafafd80ee08c32c0d981b105a7d7c611e917aa2194738b9f5f774b47f61&req=cCInHs55mIBWFb4f3HP0gM49yjviBdn8mqKYxzbcYl9PH%2Fp7CtmL2qksEvts%0AEYXlePnxPfhMqYloRw%3D%3D%0A)](https://downloads.intercomcdn.com/i/o/420877519/33cfee43ed62e52bf183b532/image.png?expires=1749730500&signature=23b4bafafd80ee08c32c0d981b105a7d7c611e917aa2194738b9f5f774b47f61&req=cCInHs55mIBWFb4f3HP0gM49yjviBdn8mqKYxzbcYl9PH%2Fp7CtmL2qksEvts%0AEYXlePnxPfhMqYloRw%3D%3D%0A) Again, start by giving your integration a unique name. We have used **Phrasee Get Variant** in the example below. Now, it's time to complete the settings. Selecting an **Icon** is optional, as is adding a **Description**. (But they both make it all look so much prettier down the road, and who doesn't want that?) [![](https://downloads.intercomcdn.com/i/o/420879996/cfd49a17081728212decb750/image.png?expires=1749730500&signature=6f08f92634c3bac012ec94d486486ec8f10771143b3e5336f0a293d2d91f2b07&req=cCInHs53lIhZFb4f3HP0gP0y%2FL0pmmfgdXQrHHBx1%2B%2Fo%2Bvxa7W9P%2FEJUcX6D%0AmlE%2BUA%2BNW%2FCNZZeTzw%3D%3D%0A)](https://downloads.intercomcdn.com/i/o/420879996/cfd49a17081728212decb750/image.png?expires=1749730500&signature=6f08f92634c3bac012ec94d486486ec8f10771143b3e5336f0a293d2d91f2b07&req=cCInHs53lIhZFb4f3HP0gP0y%2FL0pmmfgdXQrHHBx1%2B%2Fo%2Bvxa7W9P%2FEJUcX6D%0AmlE%2BUA%2BNW%2FCNZZeTzw%3D%3D%0A) Set the **Preset type** to **Normal Webhook**. Set the **Endpoint URL** to **GET**. For the URL itself, paste in the below: ```plaintext https://realtime.phrasee.co/live/single_variant?campaign_id=[[phrasee_campaign_id]] ``` For the **Authentication method**, you can now select the HTTP Authentication integration you created before. You'll recall we named ours **Phrasee Realtime** for our example. Your setup should now resemble the below: [![](https://downloads.intercomcdn.com/i/o/420880277/6ac1d876b638cd5120370e1c/image.png?expires=1749730500&signature=3b18feba0c92b6ff55aeec4067d063d17213eaccd549c3c8af13caec776860a1&req=cCInHsF%2Bn4ZYFb4f3HP0gB1G1xDUifQih3QrDPYZBS5yHFM5xgFwNmAHzOVJ%0A0uX6SnDfZGapeM0Rcw%3D%3D%0A)](https://downloads.intercomcdn.com/i/o/420880277/6ac1d876b638cd5120370e1c/image.png?expires=1749730500&signature=3b18feba0c92b6ff55aeec4067d063d17213eaccd549c3c8af13caec776860a1&req=cCInHsF%2Bn4ZYFb4f3HP0gB1G1xDUifQih3QrDPYZBS5yHFM5xgFwNmAHzOVJ%0A0uX6SnDfZGapeM0Rcw%3D%3D%0A) Under **Response processing**, choose **Process response as JSON**. #### Throughput Policy You will also have to create a **Throughput policy** at this point. Toggle the **Throughput policy switch** on. Then, click the **gear** that appears. Your Customer Success representative will have a recommendation for what you should enter here. In our example, we've chosen **Realtime API** for the **Policy name** and a **Concurrency limit** of 100. We recommend that your limit is increased for every webhook within an scenario (for example - if there are 5 webhooks in a scenario then set the limit to 100*5 = 500). [![](https://downloads.intercomcdn.com/i/o/774321849/14121f08a07f69f4f1dffa54/image.png?expires=1749730500&signature=91b2a3151a19f2861d1463a7cef049efa73990f99b3d70d443287da3d544fc8b&req=cycjFct%2FlYVWFb4f3HP0gBP0tsayXImhxn0pdsT9%2BWq7%2B1QnYjZy%2Frj87i9V%0AT9vOQCNI7L72EYo%2Bog%3D%3D%0A)](https://downloads.intercomcdn.com/i/o/774321849/14121f08a07f69f4f1dffa54/image.png?expires=1749730500&signature=91b2a3151a19f2861d1463a7cef049efa73990f99b3d70d443287da3d544fc8b&req=cycjFct%2FlYVWFb4f3HP0gBP0tsayXImhxn0pdsT9%2BWq7%2B1QnYjZy%2Frj87i9V%0AT9vOQCNI7L72EYo%2Bog%3D%3D%0A)[![](https://downloads.intercomcdn.com/i/o/774323846/5d04e1c69c4187343b0d2e01/image.png?expires=1749730500&signature=696388d09259494448fbf1f24ff830fbc78f2b1c424b2e9f9b607861392d4507&req=cycjFct9lYVZFb4f3HP0gOdt6be4oWZvR%2BoSGkPHsX8xsOZFDUTcxQUilmQN%0AoxNHKNOk%2BiaigzXblA%3D%3D%0A)](https://downloads.intercomcdn.com/i/o/774323846/5d04e1c69c4187343b0d2e01/image.png?expires=1749730500&signature=696388d09259494448fbf1f24ff830fbc78f2b1c424b2e9f9b607861392d4507&req=cycjFct9lYVZFb4f3HP0gOdt6be4oWZvR%2BoSGkPHsX8xsOZFDUTcxQUilmQN%0AoxNHKNOk%2BiaigzXblA%3D%3D%0A) The assignment of the **Consent category** will depend on your Bloomreach setup. **Customers** is the default here. Now, click **Save integration**. ### Configuration complete At this stage, you should have two configured integrations. [![](https://downloads.intercomcdn.com/i/o/420891080/2daddb1830e4305457eba2c3/image.png?expires=1749730500&signature=53cc4f5256c81d95d34bcebbaa9b431d243a4c2d1bbab6769ced3c1595a9ca38&req=cCInHsB%2FnYlfFb4f3HP0gI%2FbThbh8sxMrgzGPBxslPbEsn2Ugw%2FVWmxwUdhI%0ACr0KzvCJWSttI8Bymw%3D%3D%0A)](https://downloads.intercomcdn.com/i/o/420891080/2daddb1830e4305457eba2c3/image.png?expires=1749730500&signature=53cc4f5256c81d95d34bcebbaa9b431d243a4c2d1bbab6769ced3c1595a9ca38&req=cCInHsB%2FnYlfFb4f3HP0gI%2FbThbh8sxMrgzGPBxslPbEsn2Ugw%2FVWmxwUdhI%0ACr0KzvCJWSttI8Bymw%3D%3D%0A) This one-time setup is complete. Now, let's move on to [adding the ever-important Jacquard custom campaign tracking](/v1/docs/bloomreach-custom-campaign-tracking)!