[{"data":1,"prerenderedAt":2644},["ShallowReactive",2],{"navigation":3,"\u002Fdocs\u002Fapi-reference\u002Fbraze\u002Fprize-draws":260,"\u002Fdocs\u002Fapi-reference\u002Fbraze\u002Fprize-draws-surround":2640},[4,18,232],{"title":5,"path":6,"stem":7,"children":8,"icon":17},"Getting Started","\u002Fdocs\u002Fgetting-started","1.docs\u002F1.getting-started\u002F1.index",[9,12],{"title":10,"path":6,"stem":7,"icon":11},"Introduction","i-lucide-home",{"title":13,"path":14,"stem":15,"icon":16},"Quick Start","\u002Fdocs\u002Fgetting-started\u002Finstallation","1.docs\u002F1.getting-started\u002F2.installation","i-lucide-rocket",false,{"title":19,"icon":17,"path":20,"stem":21,"children":22},"Admin Guides","\u002Fdocs\u002Fadmin-guides","1.docs\u002F2.admin-guides\u002F1.index",[23,25,34,43,62,92,116,150,175],{"title":19,"path":20,"stem":21,"icon":24},"i-lucide-book-open",{"title":26,"icon":17,"path":27,"stem":28,"children":29,"page":17},"Programs","\u002Fdocs\u002Fadmin-guides\u002Fprograms","1.docs\u002F2.admin-guides\u002F0.programs",[30],{"title":26,"path":31,"stem":32,"icon":33},"\u002Fdocs\u002Fadmin-guides\u002Fprograms\u002Fprograms","1.docs\u002F2.admin-guides\u002F0.programs\u002F1.programs","i-lucide-layout-grid",{"title":35,"icon":17,"path":36,"stem":37,"children":38,"page":17},"Dashboard","\u002Fdocs\u002Fadmin-guides\u002Fdashboard","1.docs\u002F2.admin-guides\u002F1.dashboard",[39],{"title":35,"path":40,"stem":41,"icon":42},"\u002Fdocs\u002Fadmin-guides\u002Fdashboard\u002Fdashboard","1.docs\u002F2.admin-guides\u002F1.dashboard\u002F1.dashboard","i-lucide-layout-dashboard",{"title":44,"icon":17,"path":45,"stem":46,"children":47,"page":17},"Members","\u002Fdocs\u002Fadmin-guides\u002Fmembers","1.docs\u002F2.admin-guides\u002F2.members",[48,52,57],{"title":44,"path":49,"stem":50,"icon":51},"\u002Fdocs\u002Fadmin-guides\u002Fmembers\u002Fmembers","1.docs\u002F2.admin-guides\u002F2.members\u002F1.members","i-lucide-users",{"title":53,"path":54,"stem":55,"icon":56},"Companies","\u002Fdocs\u002Fadmin-guides\u002Fmembers\u002Fcompanies","1.docs\u002F2.admin-guides\u002F2.members\u002F2.companies","i-lucide-building-2",{"title":58,"path":59,"stem":60,"icon":61},"Communicate","\u002Fdocs\u002Fadmin-guides\u002Fmembers\u002Fcommunicate","1.docs\u002F2.admin-guides\u002F2.members\u002F3.communicate","i-lucide-mail",{"title":63,"icon":17,"path":64,"stem":65,"children":66,"page":17},"Rewards","\u002Fdocs\u002Fadmin-guides\u002Frewards","1.docs\u002F2.admin-guides\u002F3.rewards",[67,72,77,82,87],{"title":68,"path":69,"stem":70,"icon":71},"Rewards Catalog","\u002Fdocs\u002Fadmin-guides\u002Frewards\u002Frewards-catalog","1.docs\u002F2.admin-guides\u002F3.rewards\u002F1.rewards-catalog","i-lucide-gift",{"title":73,"path":74,"stem":75,"icon":76},"Orders","\u002Fdocs\u002Fadmin-guides\u002Frewards\u002Forders","1.docs\u002F2.admin-guides\u002F3.rewards\u002F2.orders","i-lucide-shopping-cart",{"title":78,"path":79,"stem":80,"icon":81},"Points Import","\u002Fdocs\u002Fadmin-guides\u002Frewards\u002Fpoints-import","1.docs\u002F2.admin-guides\u002F3.rewards\u002F3.points-import","i-lucide-upload",{"title":83,"path":84,"stem":85,"icon":86},"Fund","\u002Fdocs\u002Fadmin-guides\u002Frewards\u002Ffund","1.docs\u002F2.admin-guides\u002F3.rewards\u002F4.fund","i-lucide-wallet",{"title":88,"path":89,"stem":90,"icon":91},"RewardStar Card","\u002Fdocs\u002Fadmin-guides\u002Frewards\u002Frewardstar-card","1.docs\u002F2.admin-guides\u002F3.rewards\u002F5.rewardstar-card","i-lucide-credit-card",{"title":93,"icon":17,"path":94,"stem":95,"children":96,"page":17},"Data","\u002Fdocs\u002Fadmin-guides\u002Fdata","1.docs\u002F2.admin-guides\u002F4.data",[97,102,107,111],{"title":98,"path":99,"stem":100,"icon":101},"Data Buckets","\u002Fdocs\u002Fadmin-guides\u002Fdata\u002Fdata-buckets","1.docs\u002F2.admin-guides\u002F4.data\u002F1.data-buckets","i-lucide-database",{"title":103,"path":104,"stem":105,"icon":106},"Targets","\u002Fdocs\u002Fadmin-guides\u002Fdata\u002Ftargets","1.docs\u002F2.admin-guides\u002F4.data\u002F2.targets","i-lucide-target",{"title":108,"path":109,"stem":110,"icon":81},"Data Imports","\u002Fdocs\u002Fadmin-guides\u002Fdata\u002Fdata-imports","1.docs\u002F2.admin-guides\u002F4.data\u002F3.data-imports",{"title":112,"path":113,"stem":114,"icon":115},"Target Points Rules","\u002Fdocs\u002Fadmin-guides\u002Fdata\u002Ftarget-points-rules","1.docs\u002F2.admin-guides\u002F4.data\u002F4.target-points-rules","i-lucide-calculator",{"title":117,"icon":17,"path":118,"stem":119,"children":120,"page":17},"Apps","\u002Fdocs\u002Fadmin-guides\u002Fapps","1.docs\u002F2.admin-guides\u002F5.apps",[121,126,130,135,140,145],{"title":122,"path":123,"stem":124,"icon":125},"Leaderboards","\u002Fdocs\u002Fadmin-guides\u002Fapps\u002Fleaderboards","1.docs\u002F2.admin-guides\u002F5.apps\u002F1.leaderboards","i-lucide-trophy",{"title":127,"path":128,"stem":129,"icon":106},"Target Trackers","\u002Fdocs\u002Fadmin-guides\u002Fapps\u002Ftarget-trackers","1.docs\u002F2.admin-guides\u002F5.apps\u002F2.target-trackers",{"title":131,"path":132,"stem":133,"icon":134},"Awards","\u002Fdocs\u002Fadmin-guides\u002Fapps\u002Fawards","1.docs\u002F2.admin-guides\u002F5.apps\u002F3.awards","i-lucide-medal",{"title":136,"path":137,"stem":138,"icon":139},"Tiers","\u002Fdocs\u002Fadmin-guides\u002Fapps\u002Ftiers","1.docs\u002F2.admin-guides\u002F5.apps\u002F4.tiers","i-lucide-layers",{"title":141,"path":142,"stem":143,"icon":144},"Claims","\u002Fdocs\u002Fadmin-guides\u002Fapps\u002Fclaims","1.docs\u002F2.admin-guides\u002F5.apps\u002F5.claims","i-lucide-file-check",{"title":146,"path":147,"stem":148,"icon":149},"Quizzes","\u002Fdocs\u002Fadmin-guides\u002Fapps\u002Fquizzes","1.docs\u002F2.admin-guides\u002F5.apps\u002F6.quizzes","i-lucide-help-circle",{"title":151,"icon":17,"path":152,"stem":153,"children":154,"page":17},"Content","\u002Fdocs\u002Fadmin-guides\u002Fcontent","1.docs\u002F2.admin-guides\u002F6.content",[155,160,165,170],{"title":156,"path":157,"stem":158,"icon":159},"Articles","\u002Fdocs\u002Fadmin-guides\u002Fcontent\u002Farticles","1.docs\u002F2.admin-guides\u002F6.content\u002F1.articles","i-lucide-newspaper",{"title":161,"path":162,"stem":163,"icon":164},"Pages","\u002Fdocs\u002Fadmin-guides\u002Fcontent\u002Fpages","1.docs\u002F2.admin-guides\u002F6.content\u002F2.pages","i-lucide-file-text",{"title":166,"path":167,"stem":168,"icon":169},"Menus","\u002Fdocs\u002Fadmin-guides\u002Fcontent\u002Fmenus","1.docs\u002F2.admin-guides\u002F6.content\u002F3.menus","i-lucide-menu",{"title":171,"path":172,"stem":173,"icon":174},"Design Studio","\u002Fdocs\u002Fadmin-guides\u002Fcontent\u002Fdesign-studio","1.docs\u002F2.admin-guides\u002F6.content\u002F4.design-studio","i-lucide-palette",{"title":176,"icon":17,"path":177,"stem":178,"children":179,"page":17},"Settings","\u002Fdocs\u002Fadmin-guides\u002Fsettings","1.docs\u002F2.admin-guides\u002F7.settings",[180,185,227],{"title":181,"path":182,"stem":183,"icon":184},"Overview","\u002Fdocs\u002Fadmin-guides\u002Fsettings\u002Foverview","1.docs\u002F2.admin-guides\u002F7.settings\u002F0.overview","i-lucide-layout-list",{"title":186,"icon":17,"path":187,"stem":188,"children":189,"page":17},"General Settings","\u002Fdocs\u002Fadmin-guides\u002Fsettings\u002Fgeneral-settings","1.docs\u002F2.admin-guides\u002F7.settings\u002F1.general-settings",[190,195,200,205,209,214,219,223],{"title":191,"path":192,"stem":193,"icon":194},"Admins","\u002Fdocs\u002Fadmin-guides\u002Fsettings\u002Fgeneral-settings\u002Fadmins","1.docs\u002F2.admin-guides\u002F7.settings\u002F1.general-settings\u002F2.admins","i-lucide-shield",{"title":196,"path":197,"stem":198,"icon":199},"Titles","\u002Fdocs\u002Fadmin-guides\u002Fsettings\u002Fgeneral-settings\u002Ftitles","1.docs\u002F2.admin-guides\u002F7.settings\u002F1.general-settings\u002F3.titles","i-lucide-type",{"title":201,"path":202,"stem":203,"icon":204},"Website","\u002Fdocs\u002Fadmin-guides\u002Fsettings\u002Fgeneral-settings\u002Fwebsite","1.docs\u002F2.admin-guides\u002F7.settings\u002F1.general-settings\u002F4.website","i-lucide-globe",{"title":206,"path":207,"stem":208,"icon":164},"Terms","\u002Fdocs\u002Fadmin-guides\u002Fsettings\u002Fgeneral-settings\u002Fterms","1.docs\u002F2.admin-guides\u002F7.settings\u002F1.general-settings\u002F5.terms",{"title":210,"path":211,"stem":212,"icon":213},"Privacy","\u002Fdocs\u002Fadmin-guides\u002Fsettings\u002Fgeneral-settings\u002Fprivacy","1.docs\u002F2.admin-guides\u002F7.settings\u002F1.general-settings\u002F6.privacy","i-lucide-shield-check",{"title":215,"path":216,"stem":217,"icon":218},"App","\u002Fdocs\u002Fadmin-guides\u002Fsettings\u002Fgeneral-settings\u002Fapp","1.docs\u002F2.admin-guides\u002F7.settings\u002F1.general-settings\u002F7.app","i-lucide-smartphone",{"title":220,"path":221,"stem":222,"icon":71},"Rewards Settings","\u002Fdocs\u002Fadmin-guides\u002Fsettings\u002Fgeneral-settings\u002Frewards","1.docs\u002F2.admin-guides\u002F7.settings\u002F1.general-settings\u002F8.rewards",{"title":224,"path":225,"stem":226,"icon":91},"Subscription","\u002Fdocs\u002Fadmin-guides\u002Fsettings\u002Fgeneral-settings\u002Fsubscription","1.docs\u002F2.admin-guides\u002F7.settings\u002F1.general-settings\u002F9.subscription",{"title":228,"path":229,"stem":230,"icon":231},"Translations","\u002Fdocs\u002Fadmin-guides\u002Fsettings\u002Ftranslations","1.docs\u002F2.admin-guides\u002F7.settings\u002F3.translations","i-lucide-languages",{"title":233,"path":234,"stem":235,"children":236,"icon":17},"API","\u002Fdocs\u002Fapi-reference","1.docs\u002F3.api-reference\u002F1.index",[237,238,242,247],{"title":181,"path":234,"stem":235,"icon":24},{"title":239,"path":240,"stem":241,"icon":91},"RewardStar API","\u002Fdocs\u002Fapi-reference\u002Frewardstar","1.docs\u002F3.api-reference\u002F6.rewardstar",{"title":243,"path":244,"stem":245,"icon":246},"Prize Draw Entries API","\u002Fdocs\u002Fapi-reference\u002Fprize-draw-entries","1.docs\u002F3.api-reference\u002F7.prize-draw-entries","i-lucide-ticket",{"title":248,"icon":17,"path":249,"stem":250,"children":251,"page":17},"Braze","\u002Fdocs\u002Fapi-reference\u002Fbraze","1.docs\u002F3.api-reference\u002F8.braze",[252,256],{"title":253,"path":254,"stem":255,"icon":91},"RewardStar Cards","\u002Fdocs\u002Fapi-reference\u002Fbraze\u002Frewardstar","1.docs\u002F3.api-reference\u002F8.braze\u002F1.rewardstar",{"title":257,"path":258,"stem":259,"icon":246},"Prize Draws","\u002Fdocs\u002Fapi-reference\u002Fbraze\u002Fprize-draws","1.docs\u002F3.api-reference\u002F8.braze\u002F2.prize-draws",{"id":261,"title":262,"body":263,"description":2634,"extension":2635,"meta":2636,"navigation":2637,"path":258,"seo":2638,"stem":259,"__hash__":2639},"docs\u002F1.docs\u002F3.api-reference\u002F8.braze\u002F2.prize-draws.md","Connect Braze Webhooks to Prize Draws",{"type":264,"value":265,"toc":2603},"minimark",[266,270,285,296,300,315,318,325,336,340,344,392,396,452,456,512,526,530,544,554,558,602,608,612,677,681,685,692,749,766,770,886,922,929,932,953,957,960,1205,1209,1212,1420,1429,1433,1638,1642,1651,1766,1770,1801,1902,1915,1919,1938,1942,2048,2052,2063,2067,2081,2338,2342,2434,2438,2565,2569,2599],[267,268,262],"h1",{"id":269},"connect-braze-webhooks-to-prize-draws",[271,272,273,277,278,281,284],"p",{},[274,275,276],"strong",{},"Who this is for:"," Marketing ops and Braze admins who want Braze to enter a customer into a prize draw when a campaign or Canvas step fires, for example after a purchase, a sign-up or a milestone.",[279,280],"br",{},[274,282,283],{},"Time to complete:"," About 30 minutes (plus QA), once an Incentable prize draw and a Braze integration are set up.",[286,287,290],"callout",{"color":288,"icon":289},"info","i-lucide-flask-conical",[271,291,292,295],{},[274,293,294],{},"Beta."," Prize draw entry by webhook is available to beta programs. Field names and responses may change before general release.",[297,298,181],"h2",{"id":299},"overview",[271,301,302,303,306,307,310,311,314],{},"When a Braze campaign or Canvas step runs, Braze sends an HTTP webhook to Incentable. Incentable finds the member (or creates them as ",[274,304,305],{},"Pending","), adds the entries to the prize draw, and records the request in your integration's ",[274,308,309],{},"Activity"," log. If the prize draw's ",[274,312,313],{},"Entry received"," email is turned on, Incentable emails the entrant to confirm.",[271,316,317],{},"The customer never fills in a form. Their Braze profile supplies their details, and your Braze trigger decides when they qualify.",[271,319,320,321,324],{},"Every entry goes through the same rules as an entry added in the Admin dashboard: the prize draw must be ",[274,322,323],{},"Active"," and inside its entry period, per-member and per-submission entry limits apply, and excluded members are rejected.",[286,326,329],{"color":327,"icon":328},"neutral","i-lucide-info",[271,330,331,332,335],{},"This is a ",[274,333,334],{},"custom webhook from Braze → Incentable",". It is not a Braze Alloy partner connector, and Incentable does not call Braze for this flow.",[297,337,339],{"id":338},"prerequisites","Prerequisites",[341,342,248],"h3",{"id":343},"braze",[345,346,347,360],"table",{},[348,349,350],"thead",{},[351,352,353,357],"tr",{},[354,355,356],"th",{},"Requirement",[354,358,359],{},"Notes",[361,362,363,376,384],"tbody",{},[351,364,365,369],{},[366,367,368],"td",{},"Webhooks enabled on your Braze package",[366,370,371,372,375],{},"Availability depends on your Braze contract. If ",[274,373,374],{},"Webhooks"," is not visible, ask your Braze account manager or customer success manager.",[351,377,378,381],{},[366,379,380],{},"Permission to create a Webhook Campaign or Canvas webhook step",[366,382,383],{},"Needed to configure the call to Incentable.",[351,385,386,389],{},[366,387,388],{},"A defined trigger",[366,390,391],{},"Custom event (for example, purchase completed) or Canvas entry \u002F step criteria after the customer qualifies.",[341,393,395],{"id":394},"incentable","Incentable",[345,397,398,406],{},[348,399,400],{},[351,401,402,404],{},[354,403,356],{},[354,405,359],{},[361,407,408,423,439],{},[351,409,410,413],{},[366,411,412],{},"A prize draw in the program",[366,414,415,416,418,419,422],{},"Set to ",[274,417,323],{}," with an entry period that covers your campaign dates. Use ",[274,420,421],{},"Test mode"," during QA so test entries are kept out of live draws.",[351,424,425,428],{},[366,426,427],{},"A Braze (or Custom API) integration",[366,429,430,431,434,435,438],{},"With ",[274,432,433],{},"Prize Draws: Write"," permission. ",[274,436,437],{},"Read"," is optional and only needed to look up submissions.",[351,440,441,444],{},[366,442,443],{},"Optional: Default prize draw",[366,445,446,447,451],{},"If set on the integration, Braze does not need to send ",[448,449,450],"code",{},"prizeDrawId"," in every payload.",[297,453,455],{"id":454},"get-credentials-from-incentable","Get credentials from Incentable",[457,458,459,471,477,491,502,509],"ol",{},[460,461,462,463,470],"li",{},"Log in to the ",[464,465,469],"a",{"href":466,"rel":467},"https:\u002F\u002Fapp.incentable.com",[468],"nofollow","Incentable Admin Dashboard",".",[460,472,473,476],{},[274,474,475],{},"Select the program"," that runs the prize draw (API keys are scoped to a single program).",[460,478,479,480,483,484,486,487,490],{},"Open ",[274,481,482],{},"Integrations"," and add (or open) a ",[274,485,248],{}," integration. A ",[274,488,489],{},"Custom API"," integration also works if you are calling from your own system rather than Braze.",[460,492,493,494,497,498,501],{},"Under ",[274,495,496],{},"Permissions & Configuration → Prize Draws",", confirm ",[274,499,500],{},"Write"," is on. New Braze integration keys have it on by default.",[460,503,504,505,508],{},"Optionally choose a ",[274,506,507],{},"Default Prize Draw"," on the same card and save.",[460,510,511],{},"Generate the API key and store it in a secure password manager.",[286,513,516],{"color":514,"icon":515},"warning","i-lucide-key",[271,517,518,521,522,525],{},[274,519,520],{},"Security:"," Treat the API key as a secret. Put it only in the Braze webhook ",[274,523,524],{},"Authorization"," header. Never put the API key in the webhook URL. Prefer Braze secrets \u002F credential fields if your workspace supports them.",[341,527,529],{"id":528},"find-the-prize-draw-id","Find the prize draw ID",[271,531,532,533,536,537,539,540,543],{},"If you are not using a default prize draw, you need the prize draw's ID for the webhook body. In the Admin dashboard, open the prize draw, go to the ",[274,534,535],{},"Entries"," tab and click ",[274,538,233],{},". The ",[274,541,542],{},"Prize draw ID"," is shown with a copy button.",[286,545,547],{"color":327,"icon":546},"i-lucide-lightbulb",[271,548,549,550,553],{},"The Braze integration settings page has an ",[274,551,552],{},"Example body"," button next to the prize draw webhook. It gives you a ready-made body with Braze Liquid already filled in.",[297,555,557],{"id":556},"endpoint-braze-should-call","Endpoint Braze should call",[345,559,560,570],{},[348,561,562],{},[351,563,564,567],{},[354,565,566],{},"Item",[354,568,569],{},"Value",[361,571,572,582,592],{},[351,573,574,577],{},[366,575,576],{},"Method",[366,578,579],{},[448,580,581],{},"POST",[351,583,584,587],{},[366,585,586],{},"Path",[366,588,589],{},[448,590,591],{},"\u002Fprizedraws\u002Fentries",[351,593,594,597],{},[366,595,596],{},"Full URL",[366,598,599],{},[448,600,601],{},"https:\u002F\u002Fus-central1-incentable-app-37d9c.cloudfunctions.net\u002FexternalApi\u002Fapi\u002Fv1\u002Fexternal\u002Fprizedraws\u002Fentries",[271,603,604,605,470],{},"The URL is also shown on the Braze integration's settings page under ",[274,606,607],{},"Connection",[341,609,611],{"id":610},"headers","Headers",[345,613,614,626],{},[348,615,616],{},[351,617,618,621,624],{},[354,619,620],{},"Header",[354,622,623],{},"Required",[354,625,569],{},[361,627,628,642,656],{},[351,629,630,634,637],{},[366,631,632],{},[448,633,524],{},[366,635,636],{},"Yes",[366,638,639],{},[448,640,641],{},"Bearer \u003CYOUR_API_KEY>",[351,643,644,649,651],{},[366,645,646],{},[448,647,648],{},"Content-Type",[366,650,636],{},[366,652,653],{},[448,654,655],{},"application\u002Fjson",[351,657,658,663,666],{},[366,659,660],{},[448,661,662],{},"Idempotency-Key",[366,664,665],{},"Recommended",[366,667,668,669,672,673,676],{},"Stable unique string for this entry. Body ",[448,670,671],{},"idempotencyKey"," takes precedence over this header; ",[448,674,675],{},"externalRef"," is used if neither is sent.",[297,678,680],{"id":679},"request-body-for-the-braze-webhook-composer","Request body for the Braze webhook composer",[341,682,684],{"id":683},"fields","Fields",[271,686,687,688,691],{},"The body uses the same fields as the ",[464,689,243],{"href":690},"\u002Fdocs\u002Fapi-reference\u002Fprize-draw-entries#request-body"," — see that page for every field, type and limit. The ones that matter most in Braze:",[693,694,695,710,717,729],"ul",{},[460,696,697,709],{},[274,698,699,702,703,702,706],{},[448,700,701],{},"member.email",", ",[448,704,705],{},"member.firstname",[448,707,708],{},"member.lastname"," — required; map them from the Braze profile.",[460,711,712,716],{},[274,713,714],{},[448,715,450],{}," — required unless a Default Prize Draw is set on the integration.",[460,718,719,724,725,728],{},[274,720,721],{},[448,722,723],{},"quantity"," — optional, 1–400 (default ",[448,726,727],{},"1","); prize draw entry limits also apply.",[460,730,731,735,736,739,740,742,743,745,746,470],{},[274,732,733],{},[448,734,675],{}," — ",[274,737,738],{},"required for Braze"," (or ",[448,741,671],{}," \u002F an ",[448,744,662],{}," header); unique ",[274,747,748],{},"per prize draw",[286,750,753],{"color":751,"icon":752},"success","i-lucide-check",[271,754,755,758,759,761,762,765],{},[274,756,757],{},"Braze-friendly input."," Braze Liquid renders values as text. Incentable accepts a whole number in quotes for ",[448,760,723],{}," (for example ",[448,763,764],{},"\"2\"","), and treats an empty value (a Braze attribute that is not set) as not supplied rather than an error.",[341,767,769],{"id":768},"recommended-braze-payload-mapping","Recommended Braze → payload mapping",[345,771,772,782],{},[348,773,774],{},[351,775,776,779],{},[354,777,778],{},"Incentable field",[354,780,781],{},"Suggested Braze source",[361,783,784,795,806,817,830,843,852,864,873],{},[351,785,786,790],{},[366,787,788],{},[448,789,701],{},[366,791,792],{},[448,793,794],{},"{{${email_address}}}",[351,796,797,801],{},[366,798,799],{},[448,800,705],{},[366,802,803],{},[448,804,805],{},"{{${first_name}}}",[351,807,808,812],{},[366,809,810],{},[448,811,708],{},[366,813,814],{},[448,815,816],{},"{{${last_name}}}",[351,818,819,824],{},[366,820,821],{},[448,822,823],{},"member.accountKey",[366,825,826,829],{},[448,827,828],{},"{{${user_id}}}"," or a custom attribute holding your CRM id",[351,831,832,837],{},[366,833,834],{},[448,835,836],{},"member.mobile",[366,838,839,842],{},[448,840,841],{},"{{${phone_number}}}"," or a custom attribute",[351,844,845,849],{},[366,846,847],{},[448,848,450],{},[366,850,851],{},"Fixed string, or omit if a default prize draw is configured",[351,853,854,858],{},[366,855,856],{},[448,857,723],{},[366,859,860,861],{},"Fixed number, or an event property such as ",[448,862,863],{},"{{event_properties.${entries}}}",[351,865,866,870],{},[366,867,868],{},[448,869,675],{},[366,871,872],{},"Must be unique per entry moment — e.g. campaign\u002FCanvas id + user id + order or event id",[351,874,875,880],{},[366,876,877],{},[448,878,879],{},"metadata",[366,881,882,883],{},"Fixed values or Liquid, e.g. ",[448,884,885],{},"{{campaign.${name}}}",[286,887,889],{"color":514,"icon":888},"i-lucide-shield-alert",[271,890,891,894,895,702,898,901,902,905,906,702,908,910,911,913,914,917,918,921],{},[274,892,893],{},"A stable reference is required."," Braze may retry on ",[448,896,897],{},"408",[448,899,900],{},"429"," and ",[448,903,904],{},"5XX",", and without a stable reference a retry would add a second set of entries. Requests from a Braze integration with no ",[448,907,675],{},[448,909,671],{}," or ",[448,912,662],{}," header are rejected with ",[448,915,916],{},"400 REFERENCE_REQUIRED"," before anything is created. Braze does not retry a ",[448,919,920],{},"400",", so a missing reference shows up in your test send rather than as duplicate entries.",[341,923,925,926],{"id":924},"choosing-accountkey","Choosing ",[448,927,928],{},"accountKey",[271,930,931],{},"Prefer, in order:",[457,933,934,941,947],{},[460,935,936,940],{},[274,937,938],{},[448,939,828],{}," — always present in Braze, stable, no custom attribute setup.",[460,942,943,946],{},[274,944,945],{},"Custom attribute"," — when you already sync a CRM id into Braze and want Incentable to match on the same key.",[460,948,949,952],{},[274,950,951],{},"Omit"," — Incentable matches or creates by email only (works, but weaker if emails change).",[341,954,956],{"id":955},"simple-body-recommended-for-most-campaigns","Simple body (recommended for most campaigns)",[271,958,959],{},"One entry per qualifying event, fixed prize draw:",[961,962,967],"pre",{"className":963,"code":964,"language":965,"meta":966,"style":966},"language-json shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","{\n  \"prizeDrawId\": \"YOUR_PRIZE_DRAW_ID\",\n  \"member\": {\n    \"email\": \"{{${email_address}}}\",\n    \"firstname\": \"{{${first_name}}}\",\n    \"lastname\": \"{{${last_name}}}\",\n    \"accountKey\": \"{{${user_id}}}\"\n  },\n  \"quantity\": 1,\n  \"externalRef\": \"braze-{{campaign.${api_id}}}-{{${user_id}}}-{{event_properties.${order_id}}}\",\n  \"idempotencyKey\": \"braze-{{campaign.${api_id}}}-{{${user_id}}}-{{event_properties.${order_id}}}\",\n  \"metadata\": {\n    \"campaign\": \"{{campaign.${name}}}\"\n  }\n}\n","json","",[448,968,969,978,1005,1020,1042,1062,1082,1100,1106,1123,1143,1162,1175,1193,1199],{"__ignoreMap":966},[970,971,974],"span",{"class":972,"line":973},"line",1,[970,975,977],{"class":976},"sMK4o","{\n",[970,979,981,984,987,990,993,996,1000,1002],{"class":972,"line":980},2,[970,982,983],{"class":976},"  \"",[970,985,450],{"class":986},"spNyl",[970,988,989],{"class":976},"\"",[970,991,992],{"class":976},":",[970,994,995],{"class":976}," \"",[970,997,999],{"class":998},"sfazB","YOUR_PRIZE_DRAW_ID",[970,1001,989],{"class":976},[970,1003,1004],{"class":976},",\n",[970,1006,1008,1010,1013,1015,1017],{"class":972,"line":1007},3,[970,1009,983],{"class":976},[970,1011,1012],{"class":986},"member",[970,1014,989],{"class":976},[970,1016,992],{"class":976},[970,1018,1019],{"class":976}," {\n",[970,1021,1023,1026,1030,1032,1034,1036,1038,1040],{"class":972,"line":1022},4,[970,1024,1025],{"class":976},"    \"",[970,1027,1029],{"class":1028},"sBMFI","email",[970,1031,989],{"class":976},[970,1033,992],{"class":976},[970,1035,995],{"class":976},[970,1037,794],{"class":998},[970,1039,989],{"class":976},[970,1041,1004],{"class":976},[970,1043,1045,1047,1050,1052,1054,1056,1058,1060],{"class":972,"line":1044},5,[970,1046,1025],{"class":976},[970,1048,1049],{"class":1028},"firstname",[970,1051,989],{"class":976},[970,1053,992],{"class":976},[970,1055,995],{"class":976},[970,1057,805],{"class":998},[970,1059,989],{"class":976},[970,1061,1004],{"class":976},[970,1063,1065,1067,1070,1072,1074,1076,1078,1080],{"class":972,"line":1064},6,[970,1066,1025],{"class":976},[970,1068,1069],{"class":1028},"lastname",[970,1071,989],{"class":976},[970,1073,992],{"class":976},[970,1075,995],{"class":976},[970,1077,816],{"class":998},[970,1079,989],{"class":976},[970,1081,1004],{"class":976},[970,1083,1085,1087,1089,1091,1093,1095,1097],{"class":972,"line":1084},7,[970,1086,1025],{"class":976},[970,1088,928],{"class":1028},[970,1090,989],{"class":976},[970,1092,992],{"class":976},[970,1094,995],{"class":976},[970,1096,828],{"class":998},[970,1098,1099],{"class":976},"\"\n",[970,1101,1103],{"class":972,"line":1102},8,[970,1104,1105],{"class":976},"  },\n",[970,1107,1109,1111,1113,1115,1117,1121],{"class":972,"line":1108},9,[970,1110,983],{"class":976},[970,1112,723],{"class":986},[970,1114,989],{"class":976},[970,1116,992],{"class":976},[970,1118,1120],{"class":1119},"sbssI"," 1",[970,1122,1004],{"class":976},[970,1124,1126,1128,1130,1132,1134,1136,1139,1141],{"class":972,"line":1125},10,[970,1127,983],{"class":976},[970,1129,675],{"class":986},[970,1131,989],{"class":976},[970,1133,992],{"class":976},[970,1135,995],{"class":976},[970,1137,1138],{"class":998},"braze-{{campaign.${api_id}}}-{{${user_id}}}-{{event_properties.${order_id}}}",[970,1140,989],{"class":976},[970,1142,1004],{"class":976},[970,1144,1146,1148,1150,1152,1154,1156,1158,1160],{"class":972,"line":1145},11,[970,1147,983],{"class":976},[970,1149,671],{"class":986},[970,1151,989],{"class":976},[970,1153,992],{"class":976},[970,1155,995],{"class":976},[970,1157,1138],{"class":998},[970,1159,989],{"class":976},[970,1161,1004],{"class":976},[970,1163,1165,1167,1169,1171,1173],{"class":972,"line":1164},12,[970,1166,983],{"class":976},[970,1168,879],{"class":986},[970,1170,989],{"class":976},[970,1172,992],{"class":976},[970,1174,1019],{"class":976},[970,1176,1178,1180,1183,1185,1187,1189,1191],{"class":972,"line":1177},13,[970,1179,1025],{"class":976},[970,1181,1182],{"class":1028},"campaign",[970,1184,989],{"class":976},[970,1186,992],{"class":976},[970,1188,995],{"class":976},[970,1190,885],{"class":998},[970,1192,1099],{"class":976},[970,1194,1196],{"class":972,"line":1195},14,[970,1197,1198],{"class":976},"  }\n",[970,1200,1202],{"class":972,"line":1201},15,[970,1203,1204],{"class":976},"}\n",[341,1206,1208],{"id":1207},"advanced-body-entries-vary-per-event","Advanced body (entries vary per event)",[271,1210,1211],{},"Entries from an event property, for example one entry per $50 spent calculated in Braze. Adjust property names to match your workspace:",[961,1213,1215],{"className":963,"code":1214,"language":965,"meta":966,"style":966},"{\n  \"member\": {\n    \"email\": \"{{${email_address}}}\",\n    \"firstname\": \"{{${first_name}}}\",\n    \"lastname\": \"{{${last_name}}}\",\n    \"accountKey\": \"{{custom_attribute.${account_key}}}\"\n  },\n  \"quantity\": \"{{event_properties.${entries}}}\",\n  \"externalRef\": \"braze-{{campaign.${api_id}}}-{{${user_id}}}-{{event_properties.${order_id}}}\",\n  \"idempotencyKey\": \"braze-{{campaign.${api_id}}}-{{${user_id}}}-{{event_properties.${order_id}}}\",\n  \"metadata\": {\n    \"orderId\": \"{{event_properties.${order_id}}}\",\n    \"store\": \"{{event_properties.${store}}}\"\n  }\n}\n",[448,1216,1217,1221,1233,1251,1269,1287,1304,1308,1326,1344,1362,1374,1394,1412,1416],{"__ignoreMap":966},[970,1218,1219],{"class":972,"line":973},[970,1220,977],{"class":976},[970,1222,1223,1225,1227,1229,1231],{"class":972,"line":980},[970,1224,983],{"class":976},[970,1226,1012],{"class":986},[970,1228,989],{"class":976},[970,1230,992],{"class":976},[970,1232,1019],{"class":976},[970,1234,1235,1237,1239,1241,1243,1245,1247,1249],{"class":972,"line":1007},[970,1236,1025],{"class":976},[970,1238,1029],{"class":1028},[970,1240,989],{"class":976},[970,1242,992],{"class":976},[970,1244,995],{"class":976},[970,1246,794],{"class":998},[970,1248,989],{"class":976},[970,1250,1004],{"class":976},[970,1252,1253,1255,1257,1259,1261,1263,1265,1267],{"class":972,"line":1022},[970,1254,1025],{"class":976},[970,1256,1049],{"class":1028},[970,1258,989],{"class":976},[970,1260,992],{"class":976},[970,1262,995],{"class":976},[970,1264,805],{"class":998},[970,1266,989],{"class":976},[970,1268,1004],{"class":976},[970,1270,1271,1273,1275,1277,1279,1281,1283,1285],{"class":972,"line":1044},[970,1272,1025],{"class":976},[970,1274,1069],{"class":1028},[970,1276,989],{"class":976},[970,1278,992],{"class":976},[970,1280,995],{"class":976},[970,1282,816],{"class":998},[970,1284,989],{"class":976},[970,1286,1004],{"class":976},[970,1288,1289,1291,1293,1295,1297,1299,1302],{"class":972,"line":1064},[970,1290,1025],{"class":976},[970,1292,928],{"class":1028},[970,1294,989],{"class":976},[970,1296,992],{"class":976},[970,1298,995],{"class":976},[970,1300,1301],{"class":998},"{{custom_attribute.${account_key}}}",[970,1303,1099],{"class":976},[970,1305,1306],{"class":972,"line":1084},[970,1307,1105],{"class":976},[970,1309,1310,1312,1314,1316,1318,1320,1322,1324],{"class":972,"line":1102},[970,1311,983],{"class":976},[970,1313,723],{"class":986},[970,1315,989],{"class":976},[970,1317,992],{"class":976},[970,1319,995],{"class":976},[970,1321,863],{"class":998},[970,1323,989],{"class":976},[970,1325,1004],{"class":976},[970,1327,1328,1330,1332,1334,1336,1338,1340,1342],{"class":972,"line":1108},[970,1329,983],{"class":976},[970,1331,675],{"class":986},[970,1333,989],{"class":976},[970,1335,992],{"class":976},[970,1337,995],{"class":976},[970,1339,1138],{"class":998},[970,1341,989],{"class":976},[970,1343,1004],{"class":976},[970,1345,1346,1348,1350,1352,1354,1356,1358,1360],{"class":972,"line":1125},[970,1347,983],{"class":976},[970,1349,671],{"class":986},[970,1351,989],{"class":976},[970,1353,992],{"class":976},[970,1355,995],{"class":976},[970,1357,1138],{"class":998},[970,1359,989],{"class":976},[970,1361,1004],{"class":976},[970,1363,1364,1366,1368,1370,1372],{"class":972,"line":1145},[970,1365,983],{"class":976},[970,1367,879],{"class":986},[970,1369,989],{"class":976},[970,1371,992],{"class":976},[970,1373,1019],{"class":976},[970,1375,1376,1378,1381,1383,1385,1387,1390,1392],{"class":972,"line":1164},[970,1377,1025],{"class":976},[970,1379,1380],{"class":1028},"orderId",[970,1382,989],{"class":976},[970,1384,992],{"class":976},[970,1386,995],{"class":976},[970,1388,1389],{"class":998},"{{event_properties.${order_id}}}",[970,1391,989],{"class":976},[970,1393,1004],{"class":976},[970,1395,1396,1398,1401,1403,1405,1407,1410],{"class":972,"line":1177},[970,1397,1025],{"class":976},[970,1399,1400],{"class":1028},"store",[970,1402,989],{"class":976},[970,1404,992],{"class":976},[970,1406,995],{"class":976},[970,1408,1409],{"class":998},"{{event_properties.${store}}}",[970,1411,1099],{"class":976},[970,1413,1414],{"class":972,"line":1195},[970,1415,1198],{"class":976},[970,1417,1418],{"class":972,"line":1201},[970,1419,1204],{"class":976},[271,1421,1422,1423,1425,1426,1428],{},"This example omits ",[448,1424,450],{},", so it uses the ",[274,1427,507],{}," set on the integration.",[341,1430,1432],{"id":1431},"static-json-sample-for-smoke-tests","Static JSON sample (for smoke tests)",[961,1434,1436],{"className":963,"code":1435,"language":965,"meta":966,"style":966},"{\n  \"prizeDrawId\": \"YOUR_PRIZE_DRAW_ID\",\n  \"member\": {\n    \"email\": \"jane.doe@example.com\",\n    \"firstname\": \"Jane\",\n    \"lastname\": \"Doe\",\n    \"accountKey\": \"CRM-100245\"\n  },\n  \"quantity\": 2,\n  \"externalRef\": \"braze-qa-2026-10-20-001\",\n  \"idempotencyKey\": \"braze-qa-2026-10-20-001\",\n  \"metadata\": { \"source\": \"qa\" }\n}\n",[448,1437,1438,1442,1460,1472,1491,1510,1529,1546,1550,1565,1584,1602,1634],{"__ignoreMap":966},[970,1439,1440],{"class":972,"line":973},[970,1441,977],{"class":976},[970,1443,1444,1446,1448,1450,1452,1454,1456,1458],{"class":972,"line":980},[970,1445,983],{"class":976},[970,1447,450],{"class":986},[970,1449,989],{"class":976},[970,1451,992],{"class":976},[970,1453,995],{"class":976},[970,1455,999],{"class":998},[970,1457,989],{"class":976},[970,1459,1004],{"class":976},[970,1461,1462,1464,1466,1468,1470],{"class":972,"line":1007},[970,1463,983],{"class":976},[970,1465,1012],{"class":986},[970,1467,989],{"class":976},[970,1469,992],{"class":976},[970,1471,1019],{"class":976},[970,1473,1474,1476,1478,1480,1482,1484,1487,1489],{"class":972,"line":1022},[970,1475,1025],{"class":976},[970,1477,1029],{"class":1028},[970,1479,989],{"class":976},[970,1481,992],{"class":976},[970,1483,995],{"class":976},[970,1485,1486],{"class":998},"jane.doe@example.com",[970,1488,989],{"class":976},[970,1490,1004],{"class":976},[970,1492,1493,1495,1497,1499,1501,1503,1506,1508],{"class":972,"line":1044},[970,1494,1025],{"class":976},[970,1496,1049],{"class":1028},[970,1498,989],{"class":976},[970,1500,992],{"class":976},[970,1502,995],{"class":976},[970,1504,1505],{"class":998},"Jane",[970,1507,989],{"class":976},[970,1509,1004],{"class":976},[970,1511,1512,1514,1516,1518,1520,1522,1525,1527],{"class":972,"line":1064},[970,1513,1025],{"class":976},[970,1515,1069],{"class":1028},[970,1517,989],{"class":976},[970,1519,992],{"class":976},[970,1521,995],{"class":976},[970,1523,1524],{"class":998},"Doe",[970,1526,989],{"class":976},[970,1528,1004],{"class":976},[970,1530,1531,1533,1535,1537,1539,1541,1544],{"class":972,"line":1084},[970,1532,1025],{"class":976},[970,1534,928],{"class":1028},[970,1536,989],{"class":976},[970,1538,992],{"class":976},[970,1540,995],{"class":976},[970,1542,1543],{"class":998},"CRM-100245",[970,1545,1099],{"class":976},[970,1547,1548],{"class":972,"line":1102},[970,1549,1105],{"class":976},[970,1551,1552,1554,1556,1558,1560,1563],{"class":972,"line":1108},[970,1553,983],{"class":976},[970,1555,723],{"class":986},[970,1557,989],{"class":976},[970,1559,992],{"class":976},[970,1561,1562],{"class":1119}," 2",[970,1564,1004],{"class":976},[970,1566,1567,1569,1571,1573,1575,1577,1580,1582],{"class":972,"line":1125},[970,1568,983],{"class":976},[970,1570,675],{"class":986},[970,1572,989],{"class":976},[970,1574,992],{"class":976},[970,1576,995],{"class":976},[970,1578,1579],{"class":998},"braze-qa-2026-10-20-001",[970,1581,989],{"class":976},[970,1583,1004],{"class":976},[970,1585,1586,1588,1590,1592,1594,1596,1598,1600],{"class":972,"line":1145},[970,1587,983],{"class":976},[970,1589,671],{"class":986},[970,1591,989],{"class":976},[970,1593,992],{"class":976},[970,1595,995],{"class":976},[970,1597,1579],{"class":998},[970,1599,989],{"class":976},[970,1601,1004],{"class":976},[970,1603,1604,1606,1608,1610,1612,1615,1617,1620,1622,1624,1626,1629,1631],{"class":972,"line":1164},[970,1605,983],{"class":976},[970,1607,879],{"class":986},[970,1609,989],{"class":976},[970,1611,992],{"class":976},[970,1613,1614],{"class":976}," {",[970,1616,995],{"class":976},[970,1618,1619],{"class":1028},"source",[970,1621,989],{"class":976},[970,1623,992],{"class":976},[970,1625,995],{"class":976},[970,1627,1628],{"class":998},"qa",[970,1630,989],{"class":976},[970,1632,1633],{"class":976}," }\n",[970,1635,1636],{"class":972,"line":1177},[970,1637,1204],{"class":976},[297,1639,1641],{"id":1640},"braze-setup-steps","Braze setup steps",[271,1643,1644,1645,1650],{},"Aligns with Braze's ",[464,1646,1649],{"href":1647,"rel":1648},"https:\u002F\u002Fwww.braze.com\u002Fdocs\u002Fuser_guide\u002Fchannels\u002Fwebhooks\u002Fcreate_a_webhook",[468],"Create a webhook"," flow. Exact UI labels can vary by Braze version.",[457,1652,1653,1663,1669,1677,1705,1716,1725,1744,1753],{},[460,1654,1655,1658,1659,1662],{},[274,1656,1657],{},"Create"," a Webhook Campaign, or add a ",[274,1660,1661],{},"Webhook"," component in a Canvas.",[460,1664,1665,1668],{},[274,1666,1667],{},"Webhook URL:"," paste the prize draw entry endpoint from above.",[460,1670,1671,1674,1675,470],{},[274,1672,1673],{},"HTTP method:"," ",[448,1676,581],{},[460,1678,1679,1682],{},[274,1680,1681],{},"Request headers:",[693,1683,1684,1691,1697],{},[460,1685,1686,1688,1689],{},[448,1687,524],{},": ",[448,1690,641],{},[460,1692,1693,1688,1695],{},[448,1694,648],{},[448,1696,655],{},[460,1698,1699,1700,1702,1703,470],{},"Optional but recommended: ",[448,1701,662],{}," with the same Liquid expression as ",[448,1704,675],{},[460,1706,1707,1710,1711,1715],{},[274,1708,1709],{},"Request body:"," choose JSON \u002F raw body and paste the ",[464,1712,1714],{"href":1713},"#simple-body-recommended-for-most-campaigns","simple body"," (or the advanced body if entries vary).",[460,1717,1718,1721,1722,1724],{},[274,1719,1720],{},"Compose \u002F personalization:"," preview with a test user so email, name, quantity and ",[448,1723,675],{}," look correct.",[460,1726,1727,1730],{},[274,1728,1729],{},"Delivery \u002F trigger:",[693,1731,1732,1738],{},[460,1733,1734,1737],{},[274,1735,1736],{},"Campaign:"," action-based on a custom event (for example, purchase completed), or",[460,1739,1740,1743],{},[274,1741,1742],{},"Canvas:"," place the webhook step after the qualification path.",[460,1745,1746,1749,1750,1752],{},[274,1747,1748],{},"Optional multichannel:"," add a Braze email or push in the same campaign\u002FCanvas, for example \"You're in the draw!\". Turn off the prize draw's ",[274,1751,313],{}," email in Incentable if you don't want the entrant to get two confirmations.",[460,1754,1755,1758,1759,1762,1763,470],{},[274,1756,1757],{},"Save",", run a ",[274,1760,1761],{},"test send",", then ",[274,1764,1765],{},"launch",[297,1767,1769],{"id":1768},"how-braze-retries-interact-with-prize-draw-responses","How Braze retries interact with prize draw responses",[271,1771,1772,1773,1776,1777,702,1779,702,1781,1783,1784,1787,1788,1791,1792,1795,1796,470],{},"Braze retries ",[274,1774,1775],{},"only"," for certain HTTP responses (for example ",[448,1778,897],{},[448,1780,900],{},[448,1782,904],{},"). Most other responses, including ",[448,1785,1786],{},"401"," and other ",[448,1789,1790],{},"4XX",", are ",[274,1793,1794],{},"not"," retried. See Braze's ",[464,1797,1800],{"href":1798,"rel":1799},"https:\u002F\u002Fwww.braze.com\u002Fdocs\u002Fuser_guide\u002Fchannels\u002Fwebhooks\u002Fcreate_a_webhook#response-codes-and-retry-logic",[468],"Response codes and retry logic",[345,1802,1803,1816],{},[348,1804,1805],{},[351,1806,1807,1810,1813],{},[354,1808,1809],{},"Incentable response",[354,1811,1812],{},"Braze typically…",[354,1814,1815],{},"What you should do",[361,1817,1818,1831,1844,1874],{},[351,1819,1820,1825,1828],{},[366,1821,1822],{},[448,1823,1824],{},"201 Created",[366,1826,1827],{},"Success, no retry",[366,1829,1830],{},"Done — entries were added.",[351,1832,1833,1839,1841],{},[366,1834,1835,1838],{},[448,1836,1837],{},"200 OK"," (idempotent replay)",[366,1840,1827],{},[366,1842,1843],{},"Safe — the earlier submission is returned and no entries are added.",[351,1845,1846,1865,1871],{},[366,1847,1848,1850,1851,1850,1853,1850,1856,1850,1859,1850,1862],{},[448,1849,920],{}," \u002F ",[448,1852,1786],{},[448,1854,1855],{},"403",[448,1857,1858],{},"404",[448,1860,1861],{},"409",[448,1863,1864],{},"422",[366,1866,1867,1868,1870],{},"Usually ",[274,1869,1794],{}," retried",[366,1872,1873],{},"Fix config or payload; check Braze webhook \u002F Message Activity logs and the Incentable integration's Activity log.",[351,1875,1876,1884,1889],{},[366,1877,1878,1850,1880,1850,1882],{},[448,1879,897],{},[448,1881,900],{},[448,1883,904],{},[366,1885,1886],{},[274,1887,1888],{},"May retry",[366,1890,1891,1892,1895,1896,1898,1899,1901],{},"You ",[274,1893,1894],{},"must"," use a stable ",[448,1897,675],{}," (and\u002For ",[448,1900,662],{},") so retries do not add duplicate entries.",[286,1903,1905],{"color":514,"icon":1904},"i-lucide-alert-triangle",[271,1906,1907,1910,1911,1914],{},[274,1908,1909],{},"Host-level deferral:"," If most webhook requests to Incentable are failing, Braze may temporarily defer ",[274,1912,1913],{},"all"," sends to that host until a cooldown ends. Fix the root cause, wait for the cooldown, then retest.",[297,1916,1918],{"id":1917},"success-response","Success response",[271,1920,1921,1922,1925,1926,1929,1930,1933,1934,1937],{},"A successful request returns ",[448,1923,1924],{},"201"," with the ",[448,1927,1928],{},"submissionId",", the number of entries added, the member's total entries and a test flag. A replay of the same idempotency key returns ",[448,1931,1932],{},"200"," with the original payload and adds nothing. Field-by-field details are on the ",[464,1935,243],{"href":1936},"\u002Fdocs\u002Fapi-reference\u002Fprize-draw-entries#success-response-201"," page.",[297,1939,1941],{"id":1940},"idempotency-duplicates","Idempotency & duplicates",[345,1943,1944,1954],{},[348,1945,1946],{},[351,1947,1948,1951],{},[354,1949,1950],{},"Concept",[354,1952,1953],{},"Rule",[361,1955,1956,1972,1984,2007,2024],{},[351,1957,1958,1963],{},[366,1959,1960,1962],{},[448,1961,675],{}," uniqueness",[366,1964,1965,1966,1968,1969,1971],{},"Unique ",[274,1967,748],{},". The same ",[448,1970,675],{}," can be used in a different prize draw.",[351,1973,1974,1977],{},[366,1975,1976],{},"Choosing a Braze-side key",[366,1978,1979,1980,1983],{},"Use something that will not change on retry, e.g. ",[448,1981,1982],{},"braze-{campaign_or_canvas_id}-{user_id}-{order_or_event_id}",". Avoid timestamps or random values.",[351,1985,1986,1992],{},[366,1987,1988,1850,1990],{},[448,1989,662],{},[448,1991,671],{},[366,1993,1994,1995,1997,1998,2000,2001,2003,2004,2006],{},"Prefer the same stable value as ",[448,1996,675],{},". The API resolves: body ",[448,1999,671],{}," → ",[448,2002,662],{}," header → ",[448,2005,675],{},". Braze integrations must send at least one; Custom API callers without one get no duplicate protection.",[351,2008,2009,2016],{},[366,2010,2011,2013,2014],{},[448,2012,1924],{}," vs ",[448,2015,1932],{},[366,2017,2018,2020,2021,2023],{},[448,2019,1924],{}," = new entries. ",[448,2022,1932],{}," = safe replay of a completed submission with the same idempotency key.",[351,2025,2026,2030],{},[366,2027,2028],{},[448,2029,1861],{},[366,2031,2032,2035,2036,2038,2039,2042,2043,2045,2046,470],{},[448,2033,2034],{},"DUPLICATE_EXTERNAL_REF"," — entries with this ",[448,2037,675],{}," already exist in this prize draw. The response ",[448,2040,2041],{},"details.submissionId"," gives the original submission. Braze typically does ",[274,2044,1794],{}," retry ",[448,2047,1861],{},[297,2049,2051],{"id":2050},"look-up-a-submission-optional","Look up a submission (optional)",[271,2053,2054,2055,2058,2059,470],{},"Braze does not need this, but it is useful for support and reconciliation. It requires ",[274,2056,2057],{},"Prize Draws: Read"," on the integration — see ",[464,2060,2062],{"href":2061},"\u002Fdocs\u002Fapi-reference\u002Fprize-draw-entries#look-up-a-submission","Look up a submission",[297,2064,2066],{"id":2065},"troubleshooting","Troubleshooting",[271,2068,2069,2070,2073,2074,2076,2077,2080],{},"Start in Braze ",[274,2071,2072],{},"Message Activity"," \u002F webhook error logs, then check the Incentable integration's ",[274,2075,309],{}," log. Every request, including rejected ones, is recorded there. The ",[464,2078,243],{"href":2079},"\u002Fdocs\u002Fapi-reference\u002Fprize-draw-entries#common-errors"," page lists every error code.",[345,2082,2083,2096],{},[348,2084,2085],{},[351,2086,2087,2090,2093],{},[354,2088,2089],{},"Status \u002F code",[354,2091,2092],{},"Plain language",[354,2094,2095],{},"What to fix",[361,2097,2098,2117,2142,2166,2188,2208,2223,2243,2260,2278,2293,2315,2327],{},[351,2099,2100,2105,2111],{},[366,2101,2102,2104],{},[448,2103,920],{}," validation",[366,2106,2107,2108,2110],{},"Missing member fields, or ",[448,2109,723],{}," not a whole number.",[366,2112,2113,2114,2116],{},"Check Liquid (empty email or names), and that ",[448,2115,723],{}," renders as a whole number.",[351,2118,2119,2126,2136],{},[366,2120,2121,1674,2123],{},[448,2122,920],{},[448,2124,2125],{},"REFERENCE_REQUIRED",[366,2127,2128,2129,702,2131,910,2133,2135],{},"A Braze request had no ",[448,2130,675],{},[448,2132,671],{},[448,2134,662],{}," header.",[366,2137,2138,2139,2141],{},"Add a stable ",[448,2140,675],{}," to the webhook body. Check the Liquid isn't rendering it empty.",[351,2143,2144,2151,2157],{},[366,2145,2146,1674,2148],{},[448,2147,920],{},[448,2149,2150],{},"NO_PRIZE_DRAW_SPECIFIED",[366,2152,2153,2154,2156],{},"No ",[448,2155,450],{}," in the body and no default on the integration.",[366,2158,2159,2160,2162,2163,2165],{},"Add ",[448,2161,450],{},", or set a ",[274,2164,507],{}," on the integration.",[351,2167,2168,2172,2175],{},[366,2169,2170],{},[448,2171,1786],{},[366,2173,2174],{},"Invalid or missing API key.",[366,2176,2177,2178,2181,2182,2184,2185,2187],{},"Fix ",[448,2179,2180],{},"Authorization: Bearer …",". Braze will ",[274,2183,1794],{}," keep retrying most ",[448,2186,1786],{},"s.",[351,2189,2190,2197,2205],{},[366,2191,2192,1674,2194],{},[448,2193,1855],{},[448,2195,2196],{},"PERMISSION_DENIED",[366,2198,2199,2200,739,2202,2204],{},"The key lacks Prize Draws ",[274,2201,500],{},[274,2203,437],{}," for lookups).",[366,2206,2207],{},"Ask Incentable to enable the permission on the integration.",[351,2209,2210,2214,2217],{},[366,2211,2212],{},[448,2213,1858],{},[366,2215,2216],{},"Prize draw not found in this program.",[366,2218,2219,2220,2222],{},"Confirm the ",[448,2221,450],{}," (or default) belongs to the same program as the API key.",[351,2224,2225,2231,2237],{},[366,2226,2227,1674,2229],{},[448,2228,1861],{},[448,2230,2034],{},[366,2232,2233,2234,2236],{},"That ",[448,2235,675],{}," was already used in this prize draw.",[366,2238,2239,2240,2242],{},"Expected on a true duplicate. Use a new ",[448,2241,675],{}," only when you intend a new submission.",[351,2244,2245,2252,2255],{},[366,2246,2247,1674,2249],{},[448,2248,1864],{},[448,2250,2251],{},"PROMOTION_NOT_ACTIVE",[366,2253,2254],{},"The prize draw is Draft, Closed or otherwise not Active.",[366,2256,2257,2258,470],{},"Set the prize draw to ",[274,2259,323],{},[351,2261,2262,2272,2275],{},[366,2263,2264,1674,2266,1850,2269],{},[448,2265,1864],{},[448,2267,2268],{},"PROMOTION_NOT_OPEN",[448,2270,2271],{},"PROMOTION_CLOSED",[366,2273,2274],{},"The request arrived before the entry period opened or after it closed.",[366,2276,2277],{},"Check the prize draw's open and close dates against your campaign schedule.",[351,2279,2280,2287,2290],{},[366,2281,2282,1674,2284],{},[448,2283,1864],{},[448,2285,2286],{},"ENTRANT_EXCLUDED",[366,2288,2289],{},"The member has been excluded from this prize draw.",[366,2291,2292],{},"Expected — excluded members cannot enter. Review exclusions in the Admin dashboard if unexpected.",[351,2294,2295,2302,2309],{},[366,2296,2297,1674,2299],{},[448,2298,1864],{},[448,2300,2301],{},"LIMIT_EXCEEDED",[366,2303,2304,2305,2308],{},"Over the per-member or per-submission entry limit. ",[448,2306,2307],{},"details.limitBreaches"," lists which.",[366,2310,2311,2312,2314],{},"Lower ",[448,2313,723],{},", or review the prize draw's entry limits.",[351,2316,2317,2321,2324],{},[366,2318,2319],{},[448,2320,900],{},[366,2322,2323],{},"Rate limit reached for the key.",[366,2325,2326],{},"Braze retries with backoff. If it persists, ask Incentable about the key's rate-limit tier.",[351,2328,2329,2332,2335],{},[366,2330,2331],{},"Braze defers the host",[366,2333,2334],{},"Many failures caused Braze to pause sends to Incentable.",[366,2336,2337],{},"Fix the root cause, wait for the cooldown, then retest.",[297,2339,2341],{"id":2340},"test-plan","Test plan",[457,2343,2344,2353,2365,2396,2413,2419,2428],{},[460,2345,2346,2347,2349,2350,2352],{},"Put the prize draw in ",[274,2348,421],{}," and make sure it is ",[274,2351,323],{}," and inside its entry period.",[460,2354,2355,2356,1674,2359,761,2361,2364],{},"In Braze, send a test webhook for a QA user with a ",[274,2357,2358],{},"unique",[448,2360,675],{},[448,2362,2363],{},"braze-qa-\u003Cdate>-001",").",[460,2366,2367,2368],{},"Confirm:\n",[693,2369,2370,2375,2383,2393],{},[460,2371,2372,2373,2364],{},"Braze shows a successful webhook delivery (",[448,2374,1924],{},[460,2376,2377,2378,2380,2381,470],{},"The entries appear on the prize draw's ",[274,2379,535],{}," tab with source ",[274,2382,233],{},[460,2384,2385,2386,2389,2390,2392],{},"The request shows as ",[274,2387,2388],{},"allocated"," in the integration's ",[274,2391,309],{}," log.",[460,2394,2395],{},"The QA inbox receives the entry confirmation (if the Entry received email is on).",[460,2397,2398,2401,2402,1674,2405,2407,2408,910,2410,2412],{},[274,2399,2400],{},"Retry simulation:"," send again with the ",[274,2403,2404],{},"same",[448,2406,675],{}," and idempotency key. Expect ",[448,2409,1932],{},[448,2411,1861],{},", and no new entries.",[460,2414,2415,2416,2418],{},"Send with a bad API key. Expect ",[448,2417,1786],{},", and confirm Braze does not keep retrying.",[460,2420,2421,2422,2424,2425,2427],{},"Send once with ",[448,2423,675],{}," removed. Expect ",[448,2426,916],{}," and no entries.",[460,2429,2430,2431,2433],{},"Before launch, turn ",[274,2432,421],{}," off on the prize draw. Test entries are not included in live draws.",[297,2435,2437],{"id":2436},"pre-launch-checklist","Pre-launch checklist",[693,2439,2442,2452,2458,2464,2472,2481,2490,2502,2508,2522,2531,2542,2551,2557],{"className":2440},[2441],"contains-task-list",[460,2443,2446,2451],{"className":2444},[2445],"task-list-item",[2447,2448],"input",{"disabled":2449,"type":2450},true,"checkbox"," Braze package includes Webhooks",[460,2453,2455,2457],{"className":2454},[2445],[2447,2456],{"disabled":2449,"type":2450}," Webhook Campaign or Canvas webhook step created",[460,2459,2461,2463],{"className":2460},[2445],[2447,2462],{"disabled":2449,"type":2450}," Trigger \u002F Canvas path matches the moment a customer should be entered",[460,2465,2467,2469,2470],{"className":2466},[2445],[2447,2468],{"disabled":2449,"type":2450}," Braze integration created in Incentable with ",[274,2471,433],{},[460,2473,2475,2477,2478,2480],{"className":2474},[2445],[2447,2476],{"disabled":2449,"type":2450}," API key stored securely; used only in the ",[448,2479,524],{}," header",[460,2482,2484,2486,2487,2489],{"className":2483},[2445],[2447,2485],{"disabled":2449,"type":2450}," Prize draw ",[274,2488,323],{},", entry period covers the campaign, entry limits reviewed",[460,2491,2493,2495,2496,1674,2499,2501],{"className":2492},[2445],[2447,2494],{"disabled":2449,"type":2450}," Default Prize Draw set ",[274,2497,2498],{},"or",[448,2500,450],{}," included in the Braze body",[460,2503,2505,2507],{"className":2504},[2445],[2447,2506],{"disabled":2449,"type":2450}," Liquid maps email, first name and last name correctly",[460,2509,2511,2513,2514,2516,2517,1850,2519,2521],{"className":2510},[2445],[2447,2512],{"disabled":2449,"type":2450}," Stable unique ",[448,2515,675],{}," (and matching ",[448,2518,671],{},[448,2520,662],{},") on every send",[460,2523,2525,2527,2528,2530],{"className":2524},[2445],[2447,2526],{"disabled":2449,"type":2450}," Test send: ",[448,2529,1924],{},", entries visible in Incentable, Activity log shows allocated",[460,2532,2534,2536,2537,910,2539,2541],{"className":2533},[2445],[2447,2535],{"disabled":2449,"type":2450}," Same-key resend: ",[448,2538,1932],{},[448,2540,1861],{},", no extra entries",[460,2543,2545,2547,2548,2550],{"className":2544},[2445],[2447,2546],{"disabled":2449,"type":2450}," Bad-auth test: ",[448,2549,1786],{},", no Braze retry loop",[460,2552,2554,2556],{"className":2553},[2445],[2447,2555],{"disabled":2449,"type":2450}," Decided which confirmation the entrant gets: Incentable email, Braze message, or both",[460,2558,2560,2486,2562,2564],{"className":2559},[2445],[2447,2561],{"disabled":2449,"type":2450},[274,2563,421],{}," turned off for go-live",[297,2566,2568],{"id":2567},"related","Related",[693,2570,2571,2577,2582,2588,2594],{},[460,2572,2573,2576],{},[464,2574,2575],{"href":254},"Connect Braze Webhooks to RewardStar"," — issue gift cards from the same Braze integration",[460,2578,2579,2581],{},[464,2580,243],{"href":244}," — the same endpoint from your own system via a Custom API integration",[460,2583,2584,2587],{},[464,2585,2586],{"href":234},"API Overview"," — base URL, auth, getting your API key",[460,2589,2590,2591],{},"Braze — ",[464,2592,1649],{"href":1647,"rel":2593},[468],[460,2595,2590,2596],{},[464,2597,1800],{"href":1798,"rel":2598},[468],[2600,2601,2602],"style",{},"html pre.shiki code .sMK4o, html code.shiki .sMK4o{--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF}html pre.shiki code .spNyl, html code.shiki .spNyl{--shiki-light:#9C3EDA;--shiki-default:#C792EA;--shiki-dark:#C792EA}html pre.shiki code .sfazB, html code.shiki .sfazB{--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D}html pre.shiki code .sBMFI, html code.shiki .sBMFI{--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B}html pre.shiki code .sbssI, html code.shiki .sbssI{--shiki-light:#F76D47;--shiki-default:#F78C6C;--shiki-dark:#F78C6C}html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}",{"title":966,"searchDepth":980,"depth":980,"links":2604},[2605,2606,2610,2613,2616,2625,2626,2627,2628,2629,2630,2631,2632,2633],{"id":299,"depth":980,"text":181},{"id":338,"depth":980,"text":339,"children":2607},[2608,2609],{"id":343,"depth":1007,"text":248},{"id":394,"depth":1007,"text":395},{"id":454,"depth":980,"text":455,"children":2611},[2612],{"id":528,"depth":1007,"text":529},{"id":556,"depth":980,"text":557,"children":2614},[2615],{"id":610,"depth":1007,"text":611},{"id":679,"depth":980,"text":680,"children":2617},[2618,2619,2620,2622,2623,2624],{"id":683,"depth":1007,"text":684},{"id":768,"depth":1007,"text":769},{"id":924,"depth":1007,"text":2621},"Choosing accountKey",{"id":955,"depth":1007,"text":956},{"id":1207,"depth":1007,"text":1208},{"id":1431,"depth":1007,"text":1432},{"id":1640,"depth":980,"text":1641},{"id":1768,"depth":980,"text":1769},{"id":1917,"depth":980,"text":1918},{"id":1940,"depth":980,"text":1941},{"id":2050,"depth":980,"text":2051},{"id":2065,"depth":980,"text":2066},{"id":2340,"depth":980,"text":2341},{"id":2436,"depth":980,"text":2437},{"id":2567,"depth":980,"text":2568},"Set up Braze webhooks so campaigns and Canvas steps enter members into an Incentable prize draw, with no entry form.","md",{},{"title":257,"icon":246},{"title":262,"description":2634},"TitQHKb2RMH7NmdjqCLtsjF51l4I7q0NtZPQevVrGpU",[2641,2643],{"title":253,"path":254,"stem":255,"description":2642,"icon":91,"children":-1},"Set up a Braze integration so campaigns and Canvas steps issue RewardStar gift cards, and recipient unsubscribes sync back to Braze.",null,1792454585378]