{"id":28013,"date":"2025-12-18T17:04:04","date_gmt":"2025-12-18T17:04:04","guid":{"rendered":"https:\/\/refiner.io\/docs\/?post_type=knowledgebase&#038;p=28013"},"modified":"2025-12-18T17:29:09","modified_gmt":"2025-12-18T17:29:09","slug":"braze-integration","status":"publish","type":"knowledgebase","link":"https:\/\/refiner.io\/docs\/kb\/integrations\/braze-integration\/","title":{"rendered":"Braze Integration"},"content":{"rendered":"\n\n\n<h2 class=\"wp-block-heading\">Introduction<\/h2>\n\n\n\n<p>Our <a href=\"https:\/\/braze.com\" target=\"_blank\" rel=\"noreferrer noopener\">Braze<\/a> integration lets you do two primary things with Refiner:<\/p>\n\n\n\n<ol class=\"wp-block-list\">\n<li><strong>Embed Refiner surveys in Braze messaging campaigns<\/strong> (including email and other channels supported in Braze).<\/li>\n\n\n\n<li><strong>Sync survey event and response data to your Braze account<\/strong> as user events and attributes.<\/li>\n<\/ol>\n\n\n\n<p>You can use these features independently or together to enhance your engagement workflows.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Send email surveys with Braze<\/h2>\n\n\n\n<h3 class=\"wp-block-heading\">How it works<\/h3>\n\n\n\n<p>If you want to distribute Refiner surveys via messages sent through Braze, you can embed surveys directly into your Braze campaigns. Unlike Refiner\u2019s own delivery mechanisms, Braze remains the tool that sends the messages &#8211; Refiner supplies the survey experience.<\/p>\n\n\n<div class=\"wp-block-image\">\n<figure class=\"aligncenter size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"889\" src=\"https:\/\/refiner.io\/docs\/wp-content\/uploads\/2025\/12\/Screenshot-2022-05-09-at-12.09.59-1024x889.png\" alt=\"\" class=\"wp-image-28016\" srcset=\"https:\/\/refiner.io\/docs\/wp-content\/uploads\/2025\/12\/Screenshot-2022-05-09-at-12.09.59-1024x889.png 1024w, https:\/\/refiner.io\/docs\/wp-content\/uploads\/2025\/12\/Screenshot-2022-05-09-at-12.09.59-800x695.png 800w, https:\/\/refiner.io\/docs\/wp-content\/uploads\/2025\/12\/Screenshot-2022-05-09-at-12.09.59-768x667.png 768w, https:\/\/refiner.io\/docs\/wp-content\/uploads\/2025\/12\/Screenshot-2022-05-09-at-12.09.59-1536x1334.png 1536w, https:\/\/refiner.io\/docs\/wp-content\/uploads\/2025\/12\/Screenshot-2022-05-09-at-12.09.59.png 1690w\" sizes=\"auto, (max-width: 1024px) 100vw, 1024px\" \/><figcaption class=\"wp-element-caption\">Example of a Churn Reason email survey<\/figcaption><\/figure><\/div>\n\n\n<p>The survey embed works by inserting HTML (generated in Refiner) into your Braze email templates or message bodies. When users interact with the embedded survey prompt, they are tracked and can complete the survey in a dedicated Refiner hosted page.<\/p>\n\n\n\n<p>The advantages of using Braze for survey delivery include:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Use Braze\u2019s existing messaging templates and segmentation.<\/li>\n\n\n\n<li>Surveys feel native to your messaging workflows.<\/li>\n\n\n\n<li>Users are properly identified through Braze personalization tags when interacting with surveys.<\/li>\n<\/ul>\n\n\n\n<h3 class=\"wp-block-heading\">Get your survey embed code<\/h3>\n\n\n\n<ol class=\"wp-block-list\">\n<li>In the Refiner survey builder, go to the <a href=\"https:\/\/refiner.io\/docs\/kb\/email\/email-survey-embed-code\/\">Embed Code<\/a> tab.<\/li>\n\n\n\n<li>Choose Braze from the list of supported providers.<\/li>\n\n\n\n<li>Copy the generated HTML code snippet. This snippet includes the necessary personalization tags to correctly identify users when they engage with a survey.<\/li>\n<\/ol>\n\n\n\n<h3 class=\"wp-block-heading\">Embed survey in Braze campaign<\/h3>\n\n\n\n<ol class=\"wp-block-list\">\n<li>In your Braze dashboard, create or open an email or message campaign where you want to include a survey.<\/li>\n\n\n\n<li>Select the <a href=\"https:\/\/www.braze.com\/docs\/user_guide\/message_building_by_channel\/email\/html_editor\/creating_an_email_campaign\">HTML Code Editor<\/a> to draft your email<\/li>\n\n\n\n<li>Paste the Refiner survey HTML embed code at the position you want the survey to appear.<\/li>\n\n\n\n<li>Switch back to standard editing mode and preview your message to verify the survey displays as expected.<\/li>\n\n\n\n<li>Save and publish your campaign.<\/li>\n<\/ol>\n\n\n\n<h2 class=\"wp-block-heading\">Sync survey data to Braze<\/h2>\n\n\n\n<h3 class=\"wp-block-heading\">Overview<\/h3>\n\n\n\n<p>The Braze integration allows you to send survey interaction events and survey response data from Refiner into your Braze account. This enables use cases such as:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Triggering Braze campaigns based on survey interactions (e.g., \u201csurvey completed\u201d).<\/li>\n\n\n\n<li>Using response data to segment users for tailored journeys.<\/li>\n\n\n\n<li>Updating Braze user profiles with traits derived from survey answers.<\/li>\n<\/ul>\n\n\n\n<h3 class=\"wp-block-heading\">Setup integration<\/h3>\n\n\n\n<ol class=\"wp-block-list\">\n<li>In the Integrations section of your Refiner project, click \u201cConnect Braze\u201d.<\/li>\n\n\n\n<li>Enter the required Braze credentials:\n<ul class=\"wp-block-list\">\n<li><strong>API Key<\/strong> (from your Braze Developer Console).<\/li>\n\n\n\n<li><strong>Braze Instance ID<\/strong> (from your Braze account)<\/li>\n<\/ul>\n<\/li>\n\n\n\n<li>Map the Refiner user identifier to the Braze identifier you use (e.g., Braze <em>external_id<\/em> or <em>email<\/em>). This ensures events are associated with the correct user in Braze.<\/li>\n<\/ol>\n\n\n\n<p>After connection:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Select the surveys whose data you want to sync to Braze.<\/li>\n\n\n\n<li>Select which Refiner events should be sent to Braze (for example: Survey Seen, Survey Dismissed, Survey Completed).<\/li>\n\n\n\n<li>Choose whether the data sent to Braze should include only survey responses or additional contact data fields as well.<\/li>\n\n\n\n<li>Choose whether synced data fields should be prefixed with &#8220;refiner_&#8221; to make them easier to identify in your Braze account.<\/li>\n<\/ul>\n\n\n\n<p>Once configured, Refiner will begin sending survey events to Braze according to your selections.<\/p>\n\n\n<div class=\"wp-block-image\">\n<figure class=\"aligncenter size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"688\" src=\"https:\/\/refiner.io\/docs\/wp-content\/uploads\/2025\/12\/Screenshot-2025-12-18-at-18.08.29-1024x688.png\" alt=\"\" class=\"wp-image-28017\" srcset=\"https:\/\/refiner.io\/docs\/wp-content\/uploads\/2025\/12\/Screenshot-2025-12-18-at-18.08.29-1024x688.png 1024w, https:\/\/refiner.io\/docs\/wp-content\/uploads\/2025\/12\/Screenshot-2025-12-18-at-18.08.29-800x537.png 800w, https:\/\/refiner.io\/docs\/wp-content\/uploads\/2025\/12\/Screenshot-2025-12-18-at-18.08.29-768x516.png 768w, https:\/\/refiner.io\/docs\/wp-content\/uploads\/2025\/12\/Screenshot-2025-12-18-at-18.08.29-1536x1032.png 1536w, https:\/\/refiner.io\/docs\/wp-content\/uploads\/2025\/12\/Screenshot-2025-12-18-at-18.08.29-2048x1376.png 2048w\" sizes=\"auto, (max-width: 1024px) 100vw, 1024px\" \/><\/figure><\/div>\n\n\n<h3 class=\"wp-block-heading\">Use survey data in Braze<\/h3>\n\n\n\n<p>With survey events and response data flowing into Braze, you can:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Segment users based on responses (e.g., NPS scores, CSAT ratings).<\/li>\n\n\n\n<li>Trigger personalized campaigns in Braze based on survey outcomes.<\/li>\n\n\n\n<li>Drive cross-channel journeys using Braze Canvas or other orchestration tools.<\/li>\n<\/ul>\n","protected":false},"excerpt":{"rendered":"<p>Introduction Our Braze integration lets you do two primary things with Refiner: You can use these features independently or together to enhance your engagement workflows. Send email surveys with Braze How it works If you want to distribute Refiner surveys via messages sent through Braze, you can embed surveys directly into your Braze campaigns. Unlike [&#8230;]<\/p>\n<p><a class=\"btn btn-secondary understrap-read-more-link\" href=\"https:\/\/refiner.io\/docs\/kb\/integrations\/braze-integration\/\">Read More&#8230;<\/a><\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"closed","ping_status":"open","template":"","knowledgebase_tag":[],"class_list":["post-28013","knowledgebase","type-knowledgebase","status-publish","hentry","knowledgebase_cat-integrations"],"featured_image_urls_v2":{"full":"","thumbnail":"","medium":"","medium_large":"","large":"","1536x1536":"","2048x2048":"","ab-block-post-grid-landscape":"","ab-block-post-grid-square":"","gb-block-post-grid-landscape":"","gb-block-post-grid-square":""},"post_excerpt_stackable_v2":"<p>Introduction Our Braze integration lets you do two primary things with Refiner: Embed Refiner surveys in Braze messaging campaigns (including email and other channels supported in Braze). Sync survey event and response data to your Braze account as user events and attributes. You can use these features independently or together to enhance your engagement workflows. Send email surveys with Braze How it works If you want to distribute Refiner surveys via messages sent through Braze, you can embed surveys directly into your Braze campaigns. Unlike Refiner\u2019s own delivery mechanisms, Braze remains the tool that sends the messages &#8211; Refiner supplies&hellip;<\/p>\n","category_list_v2":"","author_info_v2":{"name":"Moritz Dausinger","url":"https:\/\/refiner.io\/docs\/author\/user\/"},"comments_num_v2":"0 comments","acf":[],"yoast_head":"<!-- This site is optimized with the Yoast SEO plugin v23.3 - https:\/\/yoast.com\/wordpress\/plugins\/seo\/ -->\n<title>Braze Integration<\/title>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/refiner.io\/docs\/kb\/integrations\/braze-integration\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"Braze Integration\" \/>\n<meta property=\"og:description\" content=\"Introduction Our Braze integration lets you do two primary things with Refiner: You can use these features independently or together to enhance your engagement workflows. Send email surveys with Braze How it works If you want to distribute Refiner surveys via messages sent through Braze, you can embed surveys directly into your Braze campaigns. Unlike [...]Read More...\" \/>\n<meta property=\"og:url\" content=\"https:\/\/refiner.io\/docs\/kb\/integrations\/braze-integration\/\" \/>\n<meta property=\"og:site_name\" content=\"Refiner Documentation\" \/>\n<meta property=\"article:modified_time\" content=\"2025-12-18T17:29:09+00:00\" \/>\n<meta property=\"og:image\" content=\"https:\/\/refiner.io\/docs\/wp-content\/uploads\/2025\/12\/Screenshot-2022-05-09-at-12.09.59-1024x889.png\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data1\" content=\"3 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\/\/refiner.io\/docs\/kb\/integrations\/braze-integration\/\",\"url\":\"https:\/\/refiner.io\/docs\/kb\/integrations\/braze-integration\/\",\"name\":\"Braze Integration\",\"isPartOf\":{\"@id\":\"https:\/\/refiner.io\/docs\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\/\/refiner.io\/docs\/kb\/integrations\/braze-integration\/#primaryimage\"},\"image\":{\"@id\":\"https:\/\/refiner.io\/docs\/kb\/integrations\/braze-integration\/#primaryimage\"},\"thumbnailUrl\":\"https:\/\/refiner.io\/docs\/wp-content\/uploads\/2025\/12\/Screenshot-2022-05-09-at-12.09.59-1024x889.png\",\"datePublished\":\"2025-12-18T17:04:04+00:00\",\"dateModified\":\"2025-12-18T17:29:09+00:00\",\"breadcrumb\":{\"@id\":\"https:\/\/refiner.io\/docs\/kb\/integrations\/braze-integration\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/refiner.io\/docs\/kb\/integrations\/braze-integration\/\"]}]},{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/refiner.io\/docs\/kb\/integrations\/braze-integration\/#primaryimage\",\"url\":\"https:\/\/refiner.io\/docs\/wp-content\/uploads\/2025\/12\/Screenshot-2022-05-09-at-12.09.59.png\",\"contentUrl\":\"https:\/\/refiner.io\/docs\/wp-content\/uploads\/2025\/12\/Screenshot-2022-05-09-at-12.09.59.png\",\"width\":1690,\"height\":1468},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/refiner.io\/docs\/kb\/integrations\/braze-integration\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\/\/refiner.io\/docs\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Braze Integration\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\/\/refiner.io\/docs\/#website\",\"url\":\"https:\/\/refiner.io\/docs\/\",\"name\":\"Refiner Documentation\",\"description\":\"\",\"publisher\":{\"@id\":\"https:\/\/refiner.io\/docs\/#organization\"},\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\/\/refiner.io\/docs\/?s={search_term_string}\"},\"query-input\":\"required name=search_term_string\"}],\"inLanguage\":\"en-US\"},{\"@type\":\"Organization\",\"@id\":\"https:\/\/refiner.io\/docs\/#organization\",\"name\":\"Refiner Documentation\",\"url\":\"https:\/\/refiner.io\/docs\/\",\"logo\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/refiner.io\/docs\/#\/schema\/logo\/image\/\",\"url\":\"https:\/\/refiner.io\/docs\/wp-content\/uploads\/2022\/11\/cropped-Group-8.png\",\"contentUrl\":\"https:\/\/refiner.io\/docs\/wp-content\/uploads\/2022\/11\/cropped-Group-8.png\",\"width\":400,\"height\":61,\"caption\":\"Refiner Documentation\"},\"image\":{\"@id\":\"https:\/\/refiner.io\/docs\/#\/schema\/logo\/image\/\"}}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"Braze Integration","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/refiner.io\/docs\/kb\/integrations\/braze-integration\/","og_locale":"en_US","og_type":"article","og_title":"Braze Integration","og_description":"Introduction Our Braze integration lets you do two primary things with Refiner: You can use these features independently or together to enhance your engagement workflows. Send email surveys with Braze How it works If you want to distribute Refiner surveys via messages sent through Braze, you can embed surveys directly into your Braze campaigns. Unlike [...]Read More...","og_url":"https:\/\/refiner.io\/docs\/kb\/integrations\/braze-integration\/","og_site_name":"Refiner Documentation","article_modified_time":"2025-12-18T17:29:09+00:00","og_image":[{"url":"https:\/\/refiner.io\/docs\/wp-content\/uploads\/2025\/12\/Screenshot-2022-05-09-at-12.09.59-1024x889.png"}],"twitter_card":"summary_large_image","twitter_misc":{"Est. reading time":"3 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/refiner.io\/docs\/kb\/integrations\/braze-integration\/","url":"https:\/\/refiner.io\/docs\/kb\/integrations\/braze-integration\/","name":"Braze Integration","isPartOf":{"@id":"https:\/\/refiner.io\/docs\/#website"},"primaryImageOfPage":{"@id":"https:\/\/refiner.io\/docs\/kb\/integrations\/braze-integration\/#primaryimage"},"image":{"@id":"https:\/\/refiner.io\/docs\/kb\/integrations\/braze-integration\/#primaryimage"},"thumbnailUrl":"https:\/\/refiner.io\/docs\/wp-content\/uploads\/2025\/12\/Screenshot-2022-05-09-at-12.09.59-1024x889.png","datePublished":"2025-12-18T17:04:04+00:00","dateModified":"2025-12-18T17:29:09+00:00","breadcrumb":{"@id":"https:\/\/refiner.io\/docs\/kb\/integrations\/braze-integration\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/refiner.io\/docs\/kb\/integrations\/braze-integration\/"]}]},{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/refiner.io\/docs\/kb\/integrations\/braze-integration\/#primaryimage","url":"https:\/\/refiner.io\/docs\/wp-content\/uploads\/2025\/12\/Screenshot-2022-05-09-at-12.09.59.png","contentUrl":"https:\/\/refiner.io\/docs\/wp-content\/uploads\/2025\/12\/Screenshot-2022-05-09-at-12.09.59.png","width":1690,"height":1468},{"@type":"BreadcrumbList","@id":"https:\/\/refiner.io\/docs\/kb\/integrations\/braze-integration\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/refiner.io\/docs\/"},{"@type":"ListItem","position":2,"name":"Braze Integration"}]},{"@type":"WebSite","@id":"https:\/\/refiner.io\/docs\/#website","url":"https:\/\/refiner.io\/docs\/","name":"Refiner Documentation","description":"","publisher":{"@id":"https:\/\/refiner.io\/docs\/#organization"},"potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/refiner.io\/docs\/?s={search_term_string}"},"query-input":"required name=search_term_string"}],"inLanguage":"en-US"},{"@type":"Organization","@id":"https:\/\/refiner.io\/docs\/#organization","name":"Refiner Documentation","url":"https:\/\/refiner.io\/docs\/","logo":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/refiner.io\/docs\/#\/schema\/logo\/image\/","url":"https:\/\/refiner.io\/docs\/wp-content\/uploads\/2022\/11\/cropped-Group-8.png","contentUrl":"https:\/\/refiner.io\/docs\/wp-content\/uploads\/2022\/11\/cropped-Group-8.png","width":400,"height":61,"caption":"Refiner Documentation"},"image":{"@id":"https:\/\/refiner.io\/docs\/#\/schema\/logo\/image\/"}}]}},"_links":{"self":[{"href":"https:\/\/refiner.io\/docs\/wp-json\/wp\/v2\/knowledgebase\/28013","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/refiner.io\/docs\/wp-json\/wp\/v2\/knowledgebase"}],"about":[{"href":"https:\/\/refiner.io\/docs\/wp-json\/wp\/v2\/types\/knowledgebase"}],"author":[{"embeddable":true,"href":"https:\/\/refiner.io\/docs\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/refiner.io\/docs\/wp-json\/wp\/v2\/comments?post=28013"}],"version-history":[{"count":8,"href":"https:\/\/refiner.io\/docs\/wp-json\/wp\/v2\/knowledgebase\/28013\/revisions"}],"predecessor-version":[{"id":28034,"href":"https:\/\/refiner.io\/docs\/wp-json\/wp\/v2\/knowledgebase\/28013\/revisions\/28034"}],"wp:attachment":[{"href":"https:\/\/refiner.io\/docs\/wp-json\/wp\/v2\/media?parent=28013"}],"wp:term":[{"taxonomy":"knowledgebase_tag","embeddable":true,"href":"https:\/\/refiner.io\/docs\/wp-json\/wp\/v2\/knowledgebase_tag?post=28013"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}