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

# Braze Webhook Setup Guide

> Configure Braze to deliver events to StackOne.

## Prerequisites

The connector should already be set up, with a Connector Profile and a Linked Account. See [Getting Started](/connectors/braze#getting-started) on the Braze connector page.

<section data-guide-section data-guide-scopes="">
  <h2>Stream events with a Custom Currents Export</h2>

  <p>This connector uses <strong>Manual Webhooks</strong>. Braze Currents sends message engagement and customer behavior events to the StackOne Native Webhook URL in batches of up to 100 events. StackOne routes each event in a batch to its own handler.</p>

  <Steps>
    <Step title="Copy the Native Webhook URL">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>After connecting your Braze account in StackOne, open the connected account and copy the <strong>Native Webhook URL</strong> field. It is only available after the account has been connected.</p>
      </div>
    </Step>

    <Step title="Create a Custom Currents Export">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>In the Braze dashboard, go to <strong>Partner Integrations</strong> > <strong>Currents</strong>, click <strong>Create New Current</strong>, and choose <strong>Custom Currents Export</strong>.</p>

        <ul>
          <li>If <strong>Create New Current</strong> is unavailable, your workspace has no Currents entitlements. Use <strong>Create New Test Current</strong> > <strong>Test Custom Currents Export</strong> instead; test Currents send up to 1,500 events per day.</li>
        </ul>
      </div>
    </Step>

    <Step title="Enter the endpoint">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Enter an <strong>Integration Name</strong> and a <strong>Contact Email</strong> for delivery alerts. Under <strong>Credentials</strong>, paste the StackOne <strong>Native Webhook URL</strong> into <strong>Endpoint</strong> and leave <strong>Bearer Token</strong> blank. The Native Webhook URL already identifies and authenticates the connection, so StackOne does not check the token.</p>
      </div>
    </Step>

    <Step title="Select events and launch">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Under <strong>Data Configuration</strong>, select the events you want StackOne to receive, then click <strong>Launch Current</strong>. Braze exports only the events you select.</p>

        <ul>
          <li><strong>Message Engagement Events</strong> can be ticked directly. For <strong>Customer Behavior and User Events</strong> and <strong>User Profiles and Attributes</strong>, switch on the section's <strong>Track</strong> toggle first to enable its checkboxes.</li>
          <li>Leave the <strong>Field Transformation Configuration</strong> tab at its defaults. Transformations change the payload fields StackOne reads.</li>
          <li>Braze sends up to 100 events per request. StackOne processes at most 50 events from a single request and acknowledges the rest without processing them. For high-volume workspaces, ask your Braze account manager to lower the Current's batch size to 50 or less.</li>
        </ul>
      </div>
    </Step>
  </Steps>
</section>

<section data-guide-section data-guide-scopes="">
  <h2>Receive transactional email status (optional)</h2>

  <p>If you send transactional emails with the <strong>Send Transactional Message</strong> action, Braze can post each status change (sent, processed, delivered, bounced, aborted) to StackOne.</p>

  <Steps>
    <Step title="Set the postback URL">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>In the Braze dashboard, go to <strong>Settings</strong> > <strong>Email Preferences</strong>, find <strong>Transactional Event Status Postback</strong>, paste the StackOne <strong>Native Webhook URL</strong>, and test the postback.</p>
      </div>
    </Step>
  </Steps>
</section>

## Verify

Your Connector should now be able to receive and process events. Try triggering an event and you should see an Event appear in the Connector logs.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.