Move your Braze setup to the new Jacquard

Guides: New customer setup · Existing customers: moving to the new Jacquard · API connection (optional) · All guides

For existing Jacquard customers. Jacquard moves your account for you, and your existing Jacquard Connected Content blocks, tokens and event connections keep working, so there’s nothing to update. This guide covers the four stages of the move and how to add new touchpoints afterwards.

Your move to the new Jacquard

Your emails and push messages keep sending as normal throughout.

The four stages

1. Stage 1: Account copied (Takes minutes)

   Jacquard copies your campaigns, approved content, users and send history into the new version.

   You: tell your Jacquard contact about any code freezes, peak periods or big sends coming up, and about any new campaigns you set up from now on.

2. Stage 2: Side by side (At least 24 hours)

   The new Jacquard learns from your last 30 days and runs alongside your current setup. Your sends still use the current platform’s choices.

   You: accept your email invitation to the new Jacquard and review the parity checklist with your Jacquard contact. Your admin can do Part 1 now.

3. Stage 3: Switch-over (At least 48 hours of checks)

   Jacquard switches your existing connection so it serves content chosen by the new version. Your existing Jacquard Connected Content blocks, tokens and event connections keep working, so there’s nothing to change.

   You: keep sending as normal.

4. Stage 4: Settling (7 days after switch-over)

   Jacquard checks your reporting lines up across old and new.

   You: sign off with your Jacquard contact. After that, you can add new touchpoints (Part 2).

Part 1: Update Braze (technical)

For your Braze admin or developer. Do this any time from stage 2 of your move, once you’ve accepted your invitation, and before you add your first new touchpoint. None of this changes your sends.

1.1 Create your runtime key and Connected Content credential

New touchpoints you add after your move use a new Connected Content credential. Your existing blocks keep using your current one.

1. Create your Jacquard runtime key (From stage 2)

   In Jacquard, go to Admin > API keys & webhooks and click + New API key. Set:

   • Name: Braze Connected Content

   • Scopes: RUNTIME:SELECT

   • Integration type: Braze

   Leave the other fields as they are and click Create key. Copy the key, which starts jq_live_, straight away: it’s only shown once.

2. Add the key as a new Connected Content credential

   In Braze, go to Settings > Connected Content (older dashboards: Manage Settings > Connected Content) and add a credential. Use the credential name shown on any touchpoint’s Connect tab in Jacquard, for example jacquard_credential, choose token authentication as shown there, and paste your jq_live_ key as the value. Save.

   Leave your current Jacquard credential exactly as it is. Your existing blocks use it, and they keep working.

3. Leave your Jacquard Current running

   If you send events to Jacquard through a Current, leave it running and unchanged. Jacquard keeps using it. You don’t need to set up a new events connection.

1.2 Hand over to your marketing team

1. Confirm the setup (Jacquard does this)

   Your Jacquard contact confirms everything is in place.

2. Tell your marketing team Part 1 is done

   Point them to Part 2. Existing emails and push messages need no changes.

Part 2: Your emails and push messages (marketing)

Your existing emails and push messages need no changes. This part covers what to leave alone, and how to add new touchpoints after your move.

2.1 Your existing emails and push messages

Nothing to change.

1. Leave your existing Jacquard Connected Content blocks in place

   The Connected Content blocks already in your emails and push messages keep working with the new version of Jacquard. You don’t need to update existing touchpoints. Don’t remove, replace or edit the code.

2. Don’t look for your existing code in Jacquard

   Jacquard doesn’t display the code your existing touchpoints use. A touchpoint’s Connect tab only shows the code for adding it to a new message. That’s expected; your existing code is still working.

3. Keep sending as normal

   Launch campaigns and publish Canvases the way you do today.

2.2 Add new touchpoints after your move

New touchpoints use the new Connected Content block, set up the same way as for a new customer.

1. Create the touchpoint in Jacquard (After stage 4)

   Set up each new touchpoint in Jacquard with your Jacquard contact, or import it if you’ve connected your account (see the API connection guide).

2. Your admin creates the Connected Content block

   Your admin follows Part 1.1 of the setup guide for the new touchpoint, creating a Connected Content block that uses the credential from Part 1.1 here. Skip the credential step; you’ve already done it.

3. Your marketing team adds it to the message

   Your marketing team follows Part 2 of the setup guide to add the Connected Content block and variables to the new email or push message, then tests it.

4. Approve and activate

   Approve the experiment plan on the touchpoint in Jacquard, then activate it and launch as normal.

Reference

Who sends what, and what to check when something doesn’t look right.

Handover checklist and troubleshooting

Troubleshooting

I can’t find my existing code on the Connect tab

That’s expected. Jacquard doesn’t display the code your existing touchpoints use, but it keeps working. Leave it as it is.

An existing message has stopped showing Jacquard copy

Don’t replace the code. Tell your Jacquard contact, who can check the touchpoint.

Handling secrets safely

Keys, tokens and secrets on this page give access to your account. Enter them directly into Jacquard’s Connections screen or share them through the secure channel your Jacquard contact sets up. Never paste them into email, chat, tickets or shared documents. If one is exposed, create a replacement, update it wherever it’s used, then revoke the old one. For Jacquard keys, you do this under Admin > API keys & webhooks.