What you need
- A Denada project with an email ready to push
- A Braze account with permission to create REST API keys
- Your Braze REST endpoint URL (for example
https://rest.iad-01.braze.com— it varies by Braze instance)
Create a Braze API key
Create a dedicated REST API key for the Denada integration:- Log in to your Braze account.
- Click Settings on the account name in the lower left.
- Under API and Identifiers, choose API Keys and Create API Key.
- Provide a name.
- Set Permissions to Media Library and Templates.
- Click Create API Key.
- Copy the Key (Identifier).
Connect Denada to Braze
1
Open the Integrations dialog
Click Share on any project, then under Integrations, click Configure. (You can also open your team’s Settings page and click Add integration in the Integrations panel — manager access required.)
2
Select Braze
Choose Braze from the list of platforms.
3
Enter your credentials
- Name — optional, e.g. “Production”. Useful if you connect more than one Braze workspace.
- API key — the REST API key you created above.
- API endpoint — your Braze REST endpoint URL. Denada suggests the standard cluster URLs (US-01 through US-10, EU-01, EU-02, AU-01, ID-01) as you type.
4
Validate and save
Click Validate to confirm the key and endpoint work, then click Save.
Push an email to Braze
- Open the project and click Share.
- Under Integrations, select Export to Braze.
- Fill in the export dialog:
- Template name — the name that will appear in Braze. Defaults to your project’s name.
- Subject line — pre-filled from your project’s subject.
- Upload images to Braze media library — optional. When checked, Denada uploads your email’s images to the Braze media library and rewrites the HTML to use Braze-hosted URLs. When unchecked, images stay hosted on Denada’s CDN.
- Click Export.
How updates work
- Re-exporting updates in place. If you’ve pushed this project to Braze before, the export dialog shows a Previous export option: choose Overwrite to update the same Braze email template, or Create new to make a separate one.
- Name collisions are checked first. For new exports, Denada checks whether an email template with the same name already exists in Braze. If it does, you’ll see a Replace existing template? confirmation — confirm to update it, or cancel and choose a different name.
- Previously uploaded images are reused. If you upload images and export again, the Previous images option lets you reuse the existing Braze-hosted copies (Use existing) or upload fresh ones (Upload new). Reusing is the default and keeps your media library tidy.
Troubleshooting
Validation fails with an endpoint error
Validation fails with an endpoint error
Make sure you entered your Braze REST endpoint (starting with
rest.), not the dashboard URL you use to log in. The error message suggests the correct REST endpoint for your cluster.Export fails with a permissions error
Export fails with a permissions error
Confirm the API key’s permissions include Templates (and Media Library if you upload images).
Background images look wrong in the Braze preview
Background images look wrong in the Braze preview
Denada automatically adds inline
background-image styles for email backgrounds so they render correctly in Braze’s editor preview as well as in email clients.