> ## Documentation Index
> Fetch the complete documentation index at: https://help.heydenada.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Braze

> Push finished emails from Denada to Braze

Denada integrates with [Braze](https://www.braze.com) so you can design emails in Denada and push them directly to Braze as email templates, ready for campaign orchestration.

## 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:

1. Log in to your Braze account.
2. Click **Settings** on the account name in the lower left.
3. Under **API and Identifiers**, choose API Keys and **Create API Key**.
4. Provide a name.
5. Set **Permissions** to **Media Library and Templates**.
6. Click **Create API Key**.
7. Copy the **Key** (Identifier).

## Connect Denada to Braze

<Steps>
  <Step title="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.)
  </Step>

  <Step title="Select Braze">
    Choose **Braze** from the list of platforms.
  </Step>

  <Step title="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.
  </Step>

  <Step title="Validate and save">
    Click **Validate** to confirm the key and endpoint work, then click **Save**.
  </Step>
</Steps>

<Warning>
  The **API endpoint** must be a REST endpoint starting with `rest.` — not your Braze dashboard URL. If you enter a dashboard URL, validation fails with a message suggesting the matching REST endpoint. See [Braze's endpoint documentation](https://www.braze.com/docs/api/basics/#endpoints) for the full mapping.
</Warning>

## Push an email to Braze

1. Open the project and click **Share**.
2. Under **Integrations**, select **Export to Braze**.
3. 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.
4. Click **Export**.

Denada renders the final HTML and creates an email template in Braze. When the export finishes, the task includes a direct link to the new email template in your Braze dashboard.

## 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

<AccordionGroup>
  <Accordion title="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.
  </Accordion>

  <Accordion title="Export fails with a permissions error">
    Confirm the API key's permissions include **Templates** (and **Media Library** if you upload images).
  </Accordion>

  <Accordion title="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.
  </Accordion>
</AccordionGroup>

For general information about how integrations work, see [Integrations overview](/integrations/integrations-overview).

## Need help?

If you run into issues with the Braze integration, reach out to [support@heydenada.com](mailto:support@heydenada.com) or ask in our [Community Slack](https://join.slack.com/t/denadacommunity/shared_invite/zt-33ermqnvl-kU9677V0eloK5Jf2SSNO5g).