Skip to main content

Braze

Braze is a customer engagement platform used to manage email, push, in-app, and SMS campaigns across your user base. Connect Braze to Willow to browse campaigns, canvases, segments, and email templates, query email list health data (unsubscribes, hard bounces), and trigger API-driven campaign sends — all from your AI assistant.

Prerequisites​

  • A Braze account with admin or developer access
  • Your Braze REST Endpoint URL (e.g. https://rest.iad-01.braze.com)
  • A Braze REST API key with the appropriate permissions

Setup​

1. Find your REST Endpoint​

  1. Log in to Braze and go to Settings → APIs and Identifiers.
  2. Copy the REST Endpoint shown on the page (for example, https://rest.iad-01.braze.com). You will need this when configuring the connector in Willow.

2. Create a REST API key​

  1. In Braze, go to Settings → APIs and Identifiers → API Keys tab.

  2. Click Create API Key and give it a descriptive name (for example, "Willow Integration").

  3. Select the permissions your integration needs:

    Minimum read-only permissions:

    • campaigns.list — List campaigns
    • campaigns.details — Get campaign details
    • campaigns.data_series — Get campaign analytics
    • canvas.list — List Canvases
    • canvas.details — Get Canvas details
    • segments.list — List segments
    • segments.details — Get segment details
    • templates.email.list — List email templates
    • templates.email.info — Get email template details
    • email.unsubscribe — Query unsubscribed emails
    • email.hard_bounces — Query hard bounced emails

    Additional permission for triggering campaigns:

    • campaigns.trigger.send — Trigger API-triggered campaign sends

  4. Click Save and copy the generated API key immediately — it is shown only once.

3. Configure the connector in Willow​

  1. In Willow, go to MCP Servers → + Add MCP server.
  2. Select Braze and click + Use.
  3. Under Authentication, select API Key and paste your API key.
  4. Under General Settings, enter your Braze REST Endpoint URL (for example, https://rest.iad-01.braze.com).
  5. Click Save Changes.

Available Tools​

The Braze connector provides 12 tools organized into four categories:

Campaigns (4 tools)​

  • List Campaigns — Browse all campaigns with pagination and filters (archived, sort direction)
  • Get Campaign Details — Retrieve full campaign configuration including message variants and conversion events
  • Get Campaign Analytics — Export time-series send, open, click, bounce, and conversion data for a campaign
  • Trigger Campaign Send — Programmatically trigger an API-triggered campaign for specific recipients or the full audience

Canvases (2 tools)​

  • List Canvases — Browse all customer journey Canvases with pagination
  • Get Canvas Details — Retrieve full Canvas configuration including steps and message details

Segments (2 tools)​

  • List Segments — Browse all user segments with pagination
  • Get Segment Details — Retrieve segment configuration and estimated user count

Email Templates (2 tools)​

  • List Email Templates — Browse all email templates; filter by modification date
  • Get Email Template — Retrieve full template content including HTML body and subject line

Email List Management (2 tools)​

  • Query Unsubscribed Emails — Export unsubscribes within a date range; filter by email address
  • Query Hard Bounced Emails — Export hard bounces within a date range; filter by email address

Troubleshooting​

"Unauthorized" or 401 errors​

Verify that your API key is correctly pasted and has not been revoked. Regenerate the key in Braze if needed.

"Forbidden" or 403 errors​

The API key is missing the permission for the requested operation. Add the required permission (for example, campaigns.trigger.send) by creating a new API key with the correct scopes.

Wrong data returned​

Confirm that the REST Endpoint in Willow matches your Braze instance (for example, EU accounts use https://rest.fra-01.braze.eu instead of a US endpoint). The endpoint is shown in Braze under Settings → APIs and Identifiers.

On this page