Welcome to Encatch Docs
Data syncBetaConnectorsEngagement and marketing

Braze

Send Encatch survey events to Braze - where to find the details in Braze and how to set up the connection

Beta. This connector is built from Braze's public API documentation and is waiting for its first confirmation on a live Braze account. The steps below are a high-level guide: menu names in Braze may differ slightly. Use Test connection and Logs to confirm your set-up, and tell us what you find.

Overview

The Braze connector sends survey events to Braze as custom events on the user, so a survey answer can trigger a Canvas or a campaign.

What it getsSurvey events as custom events
EventsSurvey shown, started, submitted, partially submitted and dismissed
Anonymous respondentsNot sent: identified users only
User profileNot updated yet: events only
StatusBeta

What You'll Need

Before you start, make sure you have:

  • A Braze workspace — and the address of the dashboard you sign in at
  • A REST API key — with the users.track permission (Step 1)

Step 1: Create a REST API key in Braze

  1. In Braze, open Settings → APIs and Identifiers → API Keys.
  2. Create an API key with the users.track permission and copy it.
  3. Note your instance from the address you sign in at, for example dashboard-01.braze.com is US-01 and dashboard-01.braze.eu is EU-01.

Step 2: Add the connection in Encatch

  1. In Encatch, open Data sync → Survey events and click Add connection.
  2. Choose Braze.
  3. Enter a Name you'll recognise in the list and in Logs.
  4. Fill in the Braze settings:
FieldWhat to enter
REST endpointYour Braze instance, by the dashboard address you sign in at.
REST API keyThe API key with the users.track permission.
  1. Press Test connection. Encatch shows what Braze answered.

Encatch keeps the keys encrypted and never shows them again. To change one later, press Replace.


Step 3: Choose what to send

  1. Under Surveys, choose All surveys or Only these surveys.
  2. Under What is sent, tick the events to send. A new connection starts with Survey shown, started, submitted and dismissed ticked. Survey partially submitted is off until you tick it.
  3. Rename an event if you want another name in Braze. The defaults are encatch_survey_shown, encatch_survey_started, encatch_survey_submitted, encatch_survey_partial and encatch_survey_dismissed.
  4. Open Advanced options to choose how users are identified, whether answers are sent and the rate limit.

Every option is explained in Connection settings.


Step 4: Save and start sending

Click Save. Saving does not start sending: press Start sending when you are ready. From then on events go out as they happen, and every delivery is listed in Logs.


Check it in Braze

After Test connection, look for the event encatch_test_event in Braze, for example on a user's profile or under custom events in your data settings.


Good to know

  • New profiles. Braze creates a profile for any user ID it does not have yet; each event counts toward your Braze data points.
  • Events only. Braze gets the events; Encatch does not set user attributes in Braze yet, so Update the user's profile is shown off.
  • Rate limit. Braze's limit depends on your contract: see the API Usage Dashboard in Braze (Settings → APIs and Identifiers). Its published burst limit is 3,000 requests per 3 seconds.
  • Also send the email. Braze keeps the email in its own field next to the user ID. Turn the option on in Advanced options to send it.

Was this page helpful?