Prerequisites
- You need an Owner, Admin, or Editor workspace role to access integration settings.
- You need a Braze REST API key with two email template permissions (step 1).
- You need to know your Braze instance (for example
EU-02).
Step 1: Create your Braze REST API key
A Braze API key only works in the workspace where it was created. Create it in the workspace where your email templates should land.- Log in to your Braze dashboard and switch to the right workspace
- Go to Settings → APIs and Identifiers → API Keys
- Click Create API key and name it
Mailkick - Under Templates, enable only these two permissions:
- Leave IP allowlisting empty: Mailkick syncs from cloud servers whose addresses change
- Save and copy the key
Only Braze admins, or users allowed to manage API keys, can create one. If Create API key is missing, ask your
Braze admin to create the key with the two permissions above. Mailkick needs no access to your other workspaces.
Step 2: Find your instance
Your instance is in the address of your Braze dashboard: for example,dashboard-02.braze.eu is EU-02. If in doubt, your Braze admin or Customer Success Manager can confirm it.
Step 3: Add Braze in Mailkick
- Open Settings → Integrations
- Select Braze
- Paste your API key
- Choose your instance
- Click Save changes
Step 4: Sync an email
- Open an email in the editor
- Click Export
- Click Sync to Braze
How sync works
- First sync → Creates a new email template in Braze
- Subsequent syncs → Updates the same template (idempotent via content hash)
- Template deleted in Braze → Mailkick automatically recreates it
Mailkick uses content hashing to avoid unnecessary API calls. If the email hasn’t changed, nothing is sent.
