[{"data":1,"prerenderedAt":2399},["ShallowReactive",2],{"navigation":3,"\u002Fdocs\u002Fapi-reference\u002Fprize-draw-entries":260,"\u002Fdocs\u002Fapi-reference\u002Fprize-draw-entries-surround":2394},[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":243,"body":262,"description":2388,"extension":2389,"meta":2390,"navigation":2391,"path":244,"seo":2392,"stem":245,"__hash__":2393},"docs\u002F1.docs\u002F3.api-reference\u002F7.prize-draw-entries.md",{"type":263,"value":264,"toc":2367},"minimark",[265,269,283,286,297,312,317,327,331,338,361,407,412,468,472,490,493,506,510,683,695,711,715,861,865,1380,1393,1400,1585,1652,1673,1677,1738,1742,1756,1965,1986,1989,2002,2020,2057,2061,2257,2262,2266,2346,2350,2363],[266,267,243],"h1",{"id":268},"prize-draw-entries-api",[270,271,272,273,277,278,282],"p",{},"Enter members into a prize draw and look up their submissions from your own system — a CRM, e-commerce platform, POS or internal app. This surface is part of the ",[274,275,276],"strong",{},"Custom API"," (",[279,280,281],"code",{},"externalApi",").",[270,284,285],{},"Typical uses: one entry per purchase, bonus entries for higher spend, or entering every customer who completes a sign-up or survey. The customer never fills in a form; your system decides who qualifies and sends the request.",[287,288,291],"callout",{"color":289,"icon":290},"info","i-lucide-flask-conical",[270,292,293,296],{},[274,294,295],{},"Beta."," Prize draw entry by API is available to beta programs. Field names and responses may change before general release.",[287,298,301],{"color":299,"icon":300},"neutral","i-lucide-info",[270,302,303,304,306,307,311],{},"Using ",[274,305,248],{},"? Follow ",[308,309,310],"a",{"href":258},"Braze → Prize Draws"," instead. It uses the same endpoint, set up through a Braze integration.",[313,314,316],"h2",{"id":315},"base-url","Base URL",[318,319,324],"pre",{"className":320,"code":322,"language":323},[321],"language-text","https:\u002F\u002Fus-central1-incentable-app-37d9c.cloudfunctions.net\u002FexternalApi\u002Fapi\u002Fv1\u002Fexternal\n","text",[279,325,322],{"__ignoreMap":326},"",[313,328,330],{"id":329},"authentication-permissions","Authentication & permissions",[270,332,333,334,337],{},"Use a Bearer API key (",[279,335,336],{},"inc_…","):",[318,339,343],{"className":340,"code":341,"language":342,"meta":326,"style":326},"language-bash shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","Authorization: Bearer YOUR_API_KEY\n","bash",[279,344,345],{"__ignoreMap":326},[346,347,350,354,358],"span",{"class":348,"line":349},"line",1,[346,351,353],{"class":352},"sBMFI","Authorization:",[346,355,357],{"class":356},"sfazB"," Bearer",[346,359,360],{"class":356}," YOUR_API_KEY\n",[362,363,364,377],"table",{},[365,366,367],"thead",{},[368,369,370,374],"tr",{},[371,372,373],"th",{},"Action",[371,375,376],{},"Required permission",[378,379,380,395],"tbody",{},[368,381,382,386],{},[383,384,385],"td",{},"Enter a member",[383,387,388,391,392],{},[279,389,390],{},"prizeDraws"," → ",[274,393,394],{},"write",[368,396,397,400],{},[383,398,399],{},"Look up a submission",[383,401,402,391,404],{},[279,403,390],{},[274,405,406],{},"read",[408,409,411],"h3",{"id":410},"set-up-the-integration","Set up the integration",[413,414,415,430,440,454,465],"ol",{},[416,417,418,419,425,426,429],"li",{},"Log in to the ",[308,420,424],{"href":421,"rel":422},"https:\u002F\u002Fapp.incentable.com",[423],"nofollow","Incentable Admin Dashboard"," and ",[274,427,428],{},"select the program"," that runs the prize draw (API keys are scoped to a single program).",[416,431,432,433,436,437,439],{},"Open ",[274,434,435],{},"Integrations"," and add (or open) a ",[274,438,276],{}," integration.",[416,441,442,443,446,447,425,450,453],{},"Under ",[274,444,445],{},"Permissions & Configuration → Prize Draws",", confirm ",[274,448,449],{},"Read",[274,451,452],{},"Write"," are on. New Custom API keys have both on by default. Permission changes are made by Incentable — contact support if you need one changed.",[416,455,456,457,460,461,464],{},"Optionally choose a ",[274,458,459],{},"Default Prize Draw"," on the same card, so requests can omit ",[279,462,463],{},"prizeDrawId",".",[416,466,467],{},"Generate the API key and store it securely.",[408,469,471],{"id":470},"find-the-prize-draw-id","Find the prize draw ID",[270,473,474,475,478,479,481,482,485,486,489],{},"Open the prize draw in the Admin dashboard, go to the ",[274,476,477],{},"Entries"," tab and click ",[274,480,233],{},". The ",[274,483,484],{},"Prize draw ID"," is shown with a copy button. The integration's settings page also has an ",[274,487,488],{},"Example body"," button next to the prize draw endpoint.",[313,491,385],{"id":492},"enter-a-member",[318,494,496],{"className":340,"code":495,"language":342,"meta":326,"style":326},"POST \u002Fprizedraws\u002Fentries\n",[279,497,498],{"__ignoreMap":326},[346,499,500,503],{"class":348,"line":349},[346,501,502],{"class":352},"POST",[346,504,505],{"class":356}," \u002Fprizedraws\u002Fentries\n",[408,507,509],{"id":508},"request-body","Request body",[362,511,512,528],{},[365,513,514],{},[368,515,516,519,522,525],{},[371,517,518],{},"Field",[371,520,521],{},"Type",[371,523,524],{},"Required",[371,526,527],{},"Description",[378,529,530,546,560,574,589,603,617,636,654,668],{},[368,531,532,537,540,543],{},[383,533,534],{},[279,535,536],{},"member.email",[383,538,539],{},"string",[383,541,542],{},"Yes",[383,544,545],{},"Entrant email. Used to match or create the member and for the confirmation email.",[368,547,548,553,555,557],{},[383,549,550],{},[279,551,552],{},"member.firstname",[383,554,539],{},[383,556,542],{},[383,558,559],{},"First name",[368,561,562,567,569,571],{},[383,563,564],{},[279,565,566],{},"member.lastname",[383,568,539],{},[383,570,542],{},[383,572,573],{},"Last name",[368,575,576,581,583,586],{},[383,577,578],{},[279,579,580],{},"member.accountKey",[383,582,539],{},[383,584,585],{},"No",[383,587,588],{},"Your customer id. Matched before email when present.",[368,590,591,596,598,600],{},[383,592,593],{},[279,594,595],{},"member.mobile",[383,597,539],{},[383,599,585],{},[383,601,602],{},"Optional mobile",[368,604,605,609,611,614],{},[383,606,607],{},[279,608,463],{},[383,610,539],{},[383,612,613],{},"Conditional",[383,615,616],{},"Prize draw to enter. Required unless a default is set on the integration.",[368,618,619,624,627,629],{},[383,620,621],{},[279,622,623],{},"quantity",[383,625,626],{},"integer",[383,628,585],{},[383,630,631,632,635],{},"Entries in this submission, 1–400 (default ",[279,633,634],{},"1","). Prize draw entry limits also apply.",[368,637,638,643,645,648],{},[383,639,640],{},[279,641,642],{},"externalRef",[383,644,539],{},[383,646,647],{},"Recommended",[383,649,650,651],{},"Your reference for the submission, such as an order number. Max 255 chars. ",[274,652,653],{},"Unique per prize draw.",[368,655,656,661,663,665],{},[383,657,658],{},[279,659,660],{},"idempotencyKey",[383,662,539],{},[383,664,585],{},[383,666,667],{},"Explicit idempotency key. Max 255 chars.",[368,669,670,675,678,680],{},[383,671,672],{},[279,673,674],{},"metadata",[383,676,677],{},"object",[383,679,585],{},[383,681,682],{},"Free-form data stored on every entry, such as store or order value. Included in entry exports.",[270,684,685,686,689,690,692,693,464],{},"Also accepted: ",[279,687,688],{},"Idempotency-Key"," header. Resolution order: body ",[279,691,660],{}," → header → ",[279,694,642],{},[287,696,699],{"color":697,"icon":698},"warning","i-lucide-shield-alert",[270,700,701,707,708,710],{},[274,702,703,704,706],{},"Send an ",[279,705,642],{}," with every request."," If your system retries after a timeout, the reference stops the retry from adding a second set of entries. Without an ",[279,709,642],{}," or idempotency key there is no duplicate protection.",[408,712,714],{"id":713},"example","Example",[318,716,718],{"className":340,"code":717,"language":342,"meta":326,"style":326},"curl -X POST \\\n  \"https:\u002F\u002Fus-central1-incentable-app-37d9c.cloudfunctions.net\u002FexternalApi\u002Fapi\u002Fv1\u002Fexternal\u002Fprizedraws\u002Fentries\" \\\n  -H \"Authorization: Bearer YOUR_API_KEY\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\n    \"prizeDrawId\": \"YOUR_PRIZE_DRAW_ID\",\n    \"member\": {\n      \"email\": \"jane@example.com\",\n      \"firstname\": \"Jane\",\n      \"lastname\": \"Doe\",\n      \"accountKey\": \"CRM-100245\"\n    },\n    \"quantity\": 2,\n    \"externalRef\": \"order-10045\",\n    \"metadata\": { \"store\": \"Sydney CBD\", \"orderTotal\": 129.95 }\n  }'\n",[279,719,720,735,750,766,780,792,798,804,810,816,822,828,834,840,846,852],{"__ignoreMap":326},[346,721,722,725,728,731],{"class":348,"line":349},[346,723,724],{"class":352},"curl",[346,726,727],{"class":356}," -X",[346,729,730],{"class":356}," POST",[346,732,734],{"class":733},"sTEyZ"," \\\n",[346,736,738,742,745,748],{"class":348,"line":737},2,[346,739,741],{"class":740},"sMK4o","  \"",[346,743,744],{"class":356},"https:\u002F\u002Fus-central1-incentable-app-37d9c.cloudfunctions.net\u002FexternalApi\u002Fapi\u002Fv1\u002Fexternal\u002Fprizedraws\u002Fentries",[346,746,747],{"class":740},"\"",[346,749,734],{"class":733},[346,751,753,756,759,762,764],{"class":348,"line":752},3,[346,754,755],{"class":356},"  -H",[346,757,758],{"class":740}," \"",[346,760,761],{"class":356},"Authorization: Bearer YOUR_API_KEY",[346,763,747],{"class":740},[346,765,734],{"class":733},[346,767,769,771,773,776,778],{"class":348,"line":768},4,[346,770,755],{"class":356},[346,772,758],{"class":740},[346,774,775],{"class":356},"Content-Type: application\u002Fjson",[346,777,747],{"class":740},[346,779,734],{"class":733},[346,781,783,786,789],{"class":348,"line":782},5,[346,784,785],{"class":356},"  -d",[346,787,788],{"class":740}," '",[346,790,791],{"class":356},"{\n",[346,793,795],{"class":348,"line":794},6,[346,796,797],{"class":356},"    \"prizeDrawId\": \"YOUR_PRIZE_DRAW_ID\",\n",[346,799,801],{"class":348,"line":800},7,[346,802,803],{"class":356},"    \"member\": {\n",[346,805,807],{"class":348,"line":806},8,[346,808,809],{"class":356},"      \"email\": \"jane@example.com\",\n",[346,811,813],{"class":348,"line":812},9,[346,814,815],{"class":356},"      \"firstname\": \"Jane\",\n",[346,817,819],{"class":348,"line":818},10,[346,820,821],{"class":356},"      \"lastname\": \"Doe\",\n",[346,823,825],{"class":348,"line":824},11,[346,826,827],{"class":356},"      \"accountKey\": \"CRM-100245\"\n",[346,829,831],{"class":348,"line":830},12,[346,832,833],{"class":356},"    },\n",[346,835,837],{"class":348,"line":836},13,[346,838,839],{"class":356},"    \"quantity\": 2,\n",[346,841,843],{"class":348,"line":842},14,[346,844,845],{"class":356},"    \"externalRef\": \"order-10045\",\n",[346,847,849],{"class":348,"line":848},15,[346,850,851],{"class":356},"    \"metadata\": { \"store\": \"Sydney CBD\", \"orderTotal\": 129.95 }\n",[346,853,855,858],{"class":348,"line":854},16,[346,856,857],{"class":356},"  }",[346,859,860],{"class":740},"'\n",[408,862,864],{"id":863},"nodejs-example","Node.js example",[318,866,870],{"className":867,"code":868,"language":869,"meta":326,"style":326},"language-js shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","const res = await fetch(\n  \"https:\u002F\u002Fus-central1-incentable-app-37d9c.cloudfunctions.net\u002FexternalApi\u002Fapi\u002Fv1\u002Fexternal\u002Fprizedraws\u002Fentries\",\n  {\n    method: \"POST\",\n    headers: {\n      Authorization: `Bearer ${process.env.INCENTABLE_API_KEY}`,\n      \"Content-Type\": \"application\u002Fjson\",\n    },\n    body: JSON.stringify({\n      prizeDrawId: process.env.PRIZE_DRAW_ID,\n      member: { email: order.email, firstname: order.firstName, lastname: order.lastName, accountKey: order.customerId },\n      quantity: Math.floor(order.total \u002F 50), \u002F\u002F e.g. one entry per $50 spent\n      externalRef: `order-${order.id}`,\n    }),\n  }\n);\n\nconst body = await res.json();\nif (res.status === 201 || res.status === 200) {\n  \u002F\u002F Entered (201) or already entered on an earlier attempt (200)\n} else if (res.status === 409 && body.code === \"DUPLICATE_EXTERNAL_REF\") {\n  \u002F\u002F This order was already entered — safe to treat as done\n} else {\n  console.error(res.status, body.code, body.message);\n}\n","js",[279,871,872,895,906,911,928,938,972,993,997,1017,1038,1107,1146,1172,1181,1186,1193,1200,1225,1264,1270,1317,1323,1332,1374],{"__ignoreMap":326},[346,873,874,878,881,884,888,892],{"class":348,"line":349},[346,875,877],{"class":876},"spNyl","const",[346,879,880],{"class":733}," res ",[346,882,883],{"class":740},"=",[346,885,887],{"class":886},"s7zQu"," await",[346,889,891],{"class":890},"s2Zo4"," fetch",[346,893,894],{"class":733},"(\n",[346,896,897,899,901,903],{"class":348,"line":737},[346,898,741],{"class":740},[346,900,744],{"class":356},[346,902,747],{"class":740},[346,904,905],{"class":740},",\n",[346,907,908],{"class":348,"line":752},[346,909,910],{"class":740},"  {\n",[346,912,913,917,920,922,924,926],{"class":348,"line":768},[346,914,916],{"class":915},"swJcz","    method",[346,918,919],{"class":740},":",[346,921,758],{"class":740},[346,923,502],{"class":356},[346,925,747],{"class":740},[346,927,905],{"class":740},[346,929,930,933,935],{"class":348,"line":782},[346,931,932],{"class":915},"    headers",[346,934,919],{"class":740},[346,936,937],{"class":740}," {\n",[346,939,940,943,945,948,951,954,957,959,962,964,967,970],{"class":348,"line":794},[346,941,942],{"class":915},"      Authorization",[346,944,919],{"class":740},[346,946,947],{"class":740}," `",[346,949,950],{"class":356},"Bearer ",[346,952,953],{"class":740},"${",[346,955,956],{"class":733},"process",[346,958,464],{"class":740},[346,960,961],{"class":733},"env",[346,963,464],{"class":740},[346,965,966],{"class":733},"INCENTABLE_API_KEY",[346,968,969],{"class":740},"}`",[346,971,905],{"class":740},[346,973,974,977,980,982,984,986,989,991],{"class":348,"line":800},[346,975,976],{"class":740},"      \"",[346,978,979],{"class":915},"Content-Type",[346,981,747],{"class":740},[346,983,919],{"class":740},[346,985,758],{"class":740},[346,987,988],{"class":356},"application\u002Fjson",[346,990,747],{"class":740},[346,992,905],{"class":740},[346,994,995],{"class":348,"line":806},[346,996,833],{"class":740},[346,998,999,1002,1004,1007,1009,1012,1015],{"class":348,"line":812},[346,1000,1001],{"class":915},"    body",[346,1003,919],{"class":740},[346,1005,1006],{"class":733}," JSON",[346,1008,464],{"class":740},[346,1010,1011],{"class":890},"stringify",[346,1013,1014],{"class":733},"(",[346,1016,791],{"class":740},[346,1018,1019,1022,1024,1027,1029,1031,1033,1036],{"class":348,"line":818},[346,1020,1021],{"class":915},"      prizeDrawId",[346,1023,919],{"class":740},[346,1025,1026],{"class":733}," process",[346,1028,464],{"class":740},[346,1030,961],{"class":733},[346,1032,464],{"class":740},[346,1034,1035],{"class":733},"PRIZE_DRAW_ID",[346,1037,905],{"class":740},[346,1039,1040,1043,1045,1048,1051,1053,1056,1058,1061,1064,1067,1069,1071,1073,1076,1078,1081,1083,1085,1087,1090,1092,1095,1097,1099,1101,1104],{"class":348,"line":824},[346,1041,1042],{"class":915},"      member",[346,1044,919],{"class":740},[346,1046,1047],{"class":740}," {",[346,1049,1050],{"class":915}," email",[346,1052,919],{"class":740},[346,1054,1055],{"class":733}," order",[346,1057,464],{"class":740},[346,1059,1060],{"class":733},"email",[346,1062,1063],{"class":740},",",[346,1065,1066],{"class":915}," firstname",[346,1068,919],{"class":740},[346,1070,1055],{"class":733},[346,1072,464],{"class":740},[346,1074,1075],{"class":733},"firstName",[346,1077,1063],{"class":740},[346,1079,1080],{"class":915}," lastname",[346,1082,919],{"class":740},[346,1084,1055],{"class":733},[346,1086,464],{"class":740},[346,1088,1089],{"class":733},"lastName",[346,1091,1063],{"class":740},[346,1093,1094],{"class":915}," accountKey",[346,1096,919],{"class":740},[346,1098,1055],{"class":733},[346,1100,464],{"class":740},[346,1102,1103],{"class":733},"customerId ",[346,1105,1106],{"class":740},"},\n",[346,1108,1109,1112,1114,1117,1119,1122,1125,1127,1130,1133,1137,1140,1142],{"class":348,"line":830},[346,1110,1111],{"class":915},"      quantity",[346,1113,919],{"class":740},[346,1115,1116],{"class":733}," Math",[346,1118,464],{"class":740},[346,1120,1121],{"class":890},"floor",[346,1123,1124],{"class":733},"(order",[346,1126,464],{"class":740},[346,1128,1129],{"class":733},"total ",[346,1131,1132],{"class":740},"\u002F",[346,1134,1136],{"class":1135},"sbssI"," 50",[346,1138,1139],{"class":733},")",[346,1141,1063],{"class":740},[346,1143,1145],{"class":1144},"sHwdD"," \u002F\u002F e.g. one entry per $50 spent\n",[346,1147,1148,1151,1153,1155,1158,1160,1163,1165,1168,1170],{"class":348,"line":836},[346,1149,1150],{"class":915},"      externalRef",[346,1152,919],{"class":740},[346,1154,947],{"class":740},[346,1156,1157],{"class":356},"order-",[346,1159,953],{"class":740},[346,1161,1162],{"class":733},"order",[346,1164,464],{"class":740},[346,1166,1167],{"class":733},"id",[346,1169,969],{"class":740},[346,1171,905],{"class":740},[346,1173,1174,1177,1179],{"class":348,"line":842},[346,1175,1176],{"class":740},"    }",[346,1178,1139],{"class":733},[346,1180,905],{"class":740},[346,1182,1183],{"class":348,"line":848},[346,1184,1185],{"class":740},"  }\n",[346,1187,1188,1190],{"class":348,"line":854},[346,1189,1139],{"class":733},[346,1191,1192],{"class":740},";\n",[346,1194,1196],{"class":348,"line":1195},17,[346,1197,1199],{"emptyLinePlaceholder":1198},true,"\n",[346,1201,1203,1205,1208,1210,1212,1215,1217,1220,1223],{"class":348,"line":1202},18,[346,1204,877],{"class":876},[346,1206,1207],{"class":733}," body ",[346,1209,883],{"class":740},[346,1211,887],{"class":886},[346,1213,1214],{"class":733}," res",[346,1216,464],{"class":740},[346,1218,1219],{"class":890},"json",[346,1221,1222],{"class":733},"()",[346,1224,1192],{"class":740},[346,1226,1228,1231,1234,1236,1239,1242,1245,1248,1250,1252,1254,1256,1259,1262],{"class":348,"line":1227},19,[346,1229,1230],{"class":886},"if",[346,1232,1233],{"class":733}," (res",[346,1235,464],{"class":740},[346,1237,1238],{"class":733},"status ",[346,1240,1241],{"class":740},"===",[346,1243,1244],{"class":1135}," 201",[346,1246,1247],{"class":740}," ||",[346,1249,1214],{"class":733},[346,1251,464],{"class":740},[346,1253,1238],{"class":733},[346,1255,1241],{"class":740},[346,1257,1258],{"class":1135}," 200",[346,1260,1261],{"class":733},") ",[346,1263,791],{"class":740},[346,1265,1267],{"class":348,"line":1266},20,[346,1268,1269],{"class":1144},"  \u002F\u002F Entered (201) or already entered on an earlier attempt (200)\n",[346,1271,1273,1276,1279,1282,1284,1286,1288,1290,1293,1296,1299,1301,1304,1306,1308,1311,1313,1315],{"class":348,"line":1272},21,[346,1274,1275],{"class":740},"}",[346,1277,1278],{"class":886}," else",[346,1280,1281],{"class":886}," if",[346,1283,1233],{"class":733},[346,1285,464],{"class":740},[346,1287,1238],{"class":733},[346,1289,1241],{"class":740},[346,1291,1292],{"class":1135}," 409",[346,1294,1295],{"class":740}," &&",[346,1297,1298],{"class":733}," body",[346,1300,464],{"class":740},[346,1302,1303],{"class":733},"code ",[346,1305,1241],{"class":740},[346,1307,758],{"class":740},[346,1309,1310],{"class":356},"DUPLICATE_EXTERNAL_REF",[346,1312,747],{"class":740},[346,1314,1261],{"class":733},[346,1316,791],{"class":740},[346,1318,1320],{"class":348,"line":1319},22,[346,1321,1322],{"class":1144},"  \u002F\u002F This order was already entered — safe to treat as done\n",[346,1324,1326,1328,1330],{"class":348,"line":1325},23,[346,1327,1275],{"class":740},[346,1329,1278],{"class":886},[346,1331,937],{"class":740},[346,1333,1335,1338,1340,1343,1345,1348,1350,1353,1355,1357,1359,1361,1363,1365,1367,1370,1372],{"class":348,"line":1334},24,[346,1336,1337],{"class":733},"  console",[346,1339,464],{"class":740},[346,1341,1342],{"class":890},"error",[346,1344,1014],{"class":915},[346,1346,1347],{"class":733},"res",[346,1349,464],{"class":740},[346,1351,1352],{"class":733},"status",[346,1354,1063],{"class":740},[346,1356,1298],{"class":733},[346,1358,464],{"class":740},[346,1360,279],{"class":733},[346,1362,1063],{"class":740},[346,1364,1298],{"class":733},[346,1366,464],{"class":740},[346,1368,1369],{"class":733},"message",[346,1371,1139],{"class":915},[346,1373,1192],{"class":740},[346,1375,1377],{"class":348,"line":1376},25,[346,1378,1379],{"class":740},"}\n",[270,1381,1382,1383,1385,1386,1388,1389,1392],{},"Make sure ",[279,1384,623],{}," is at least ",[279,1387,634],{}," — if your calculation can produce ",[279,1390,1391],{},"0",", skip the request rather than sending it.",[408,1394,1396,1397,1139],{"id":1395},"success-response-201","Success response (",[279,1398,1399],{},"201",[318,1401,1404],{"className":1402,"code":1403,"language":1219,"meta":326,"style":326},"language-json shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","{\n  \"data\": {\n    \"submissionId\": \"sub_1aae5cd95fe1b38bcedf\",\n    \"prizeDrawId\": \"YOUR_PRIZE_DRAW_ID\",\n    \"quantity\": 2,\n    \"totalEntries\": 5,\n    \"isTest\": false,\n    \"externalRef\": \"order-10045\"\n  },\n  \"memberId\": \"memberDocId\",\n  \"memberCreated\": false,\n  \"message\": \"Entries created successfully\"\n}\n",[279,1405,1406,1410,1423,1444,1463,1478,1494,1508,1526,1531,1551,1564,1581],{"__ignoreMap":326},[346,1407,1408],{"class":348,"line":349},[346,1409,791],{"class":740},[346,1411,1412,1414,1417,1419,1421],{"class":348,"line":737},[346,1413,741],{"class":740},[346,1415,1416],{"class":876},"data",[346,1418,747],{"class":740},[346,1420,919],{"class":740},[346,1422,937],{"class":740},[346,1424,1425,1428,1431,1433,1435,1437,1440,1442],{"class":348,"line":752},[346,1426,1427],{"class":740},"    \"",[346,1429,1430],{"class":352},"submissionId",[346,1432,747],{"class":740},[346,1434,919],{"class":740},[346,1436,758],{"class":740},[346,1438,1439],{"class":356},"sub_1aae5cd95fe1b38bcedf",[346,1441,747],{"class":740},[346,1443,905],{"class":740},[346,1445,1446,1448,1450,1452,1454,1456,1459,1461],{"class":348,"line":768},[346,1447,1427],{"class":740},[346,1449,463],{"class":352},[346,1451,747],{"class":740},[346,1453,919],{"class":740},[346,1455,758],{"class":740},[346,1457,1458],{"class":356},"YOUR_PRIZE_DRAW_ID",[346,1460,747],{"class":740},[346,1462,905],{"class":740},[346,1464,1465,1467,1469,1471,1473,1476],{"class":348,"line":782},[346,1466,1427],{"class":740},[346,1468,623],{"class":352},[346,1470,747],{"class":740},[346,1472,919],{"class":740},[346,1474,1475],{"class":1135}," 2",[346,1477,905],{"class":740},[346,1479,1480,1482,1485,1487,1489,1492],{"class":348,"line":794},[346,1481,1427],{"class":740},[346,1483,1484],{"class":352},"totalEntries",[346,1486,747],{"class":740},[346,1488,919],{"class":740},[346,1490,1491],{"class":1135}," 5",[346,1493,905],{"class":740},[346,1495,1496,1498,1501,1503,1505],{"class":348,"line":800},[346,1497,1427],{"class":740},[346,1499,1500],{"class":352},"isTest",[346,1502,747],{"class":740},[346,1504,919],{"class":740},[346,1506,1507],{"class":740}," false,\n",[346,1509,1510,1512,1514,1516,1518,1520,1523],{"class":348,"line":806},[346,1511,1427],{"class":740},[346,1513,642],{"class":352},[346,1515,747],{"class":740},[346,1517,919],{"class":740},[346,1519,758],{"class":740},[346,1521,1522],{"class":356},"order-10045",[346,1524,1525],{"class":740},"\"\n",[346,1527,1528],{"class":348,"line":812},[346,1529,1530],{"class":740},"  },\n",[346,1532,1533,1535,1538,1540,1542,1544,1547,1549],{"class":348,"line":818},[346,1534,741],{"class":740},[346,1536,1537],{"class":876},"memberId",[346,1539,747],{"class":740},[346,1541,919],{"class":740},[346,1543,758],{"class":740},[346,1545,1546],{"class":356},"memberDocId",[346,1548,747],{"class":740},[346,1550,905],{"class":740},[346,1552,1553,1555,1558,1560,1562],{"class":348,"line":824},[346,1554,741],{"class":740},[346,1556,1557],{"class":876},"memberCreated",[346,1559,747],{"class":740},[346,1561,919],{"class":740},[346,1563,1507],{"class":740},[346,1565,1566,1568,1570,1572,1574,1576,1579],{"class":348,"line":830},[346,1567,741],{"class":740},[346,1569,1369],{"class":876},[346,1571,747],{"class":740},[346,1573,919],{"class":740},[346,1575,758],{"class":740},[346,1577,1578],{"class":356},"Entries created successfully",[346,1580,1525],{"class":740},[346,1582,1583],{"class":348,"line":836},[346,1584,1379],{"class":740},[362,1586,1587,1596],{},[365,1588,1589],{},[368,1590,1591,1593],{},[371,1592,518],{},[371,1594,1595],{},"Meaning",[378,1597,1598,1608,1618,1628,1641],{},[368,1599,1600,1605],{},[383,1601,1602],{},[279,1603,1604],{},"data.submissionId",[383,1606,1607],{},"Id of this submission. One submission can hold several entries.",[368,1609,1610,1615],{},[383,1611,1612],{},[279,1613,1614],{},"data.quantity",[383,1616,1617],{},"Entries added by this request.",[368,1619,1620,1625],{},[383,1621,1622],{},[279,1623,1624],{},"data.totalEntries",[383,1626,1627],{},"The member's total entries in this prize draw after this request.",[368,1629,1630,1635],{},[383,1631,1632],{},[279,1633,1634],{},"data.isTest",[383,1636,1637,1640],{},[279,1638,1639],{},"true"," if the prize draw is in test mode.",[368,1642,1643,1647],{},[383,1644,1645],{},[279,1646,1557],{},[383,1648,1649,1651],{},[279,1650,1639],{}," if Incentable created a Pending member for this request.",[270,1653,1654,1655,1658,1659,1661,1662,1665,1666,1669,1670,1672],{},"A replay with the same idempotency key returns ",[279,1656,1657],{},"200"," with the original payload and adds no entries. A duplicate ",[279,1660,642],{}," in the same prize draw returns ",[279,1663,1664],{},"409"," with the original submission id in ",[279,1667,1668],{},"details.submissionId",". The same ",[279,1671,642],{}," may be used in a different prize draw.",[408,1674,1676],{"id":1675},"behaviour-notes","Behaviour notes",[1678,1679,1680,1690,1700,1706,1712,1722],"ul",{},[416,1681,1682,1685,1686,1689],{},[274,1683,1684],{},"Member upsert:"," accountKey → email → create a ",[274,1687,1688],{},"Pending"," member.",[416,1691,1692,1695,1696,1699],{},[274,1693,1694],{},"Entry rules:"," the prize draw must be ",[274,1697,1698],{},"Active"," and inside its entry period. Per-member and per-submission limits from the prize draw settings apply, and excluded members are rejected. API requests cannot override limits; admins can add entries beyond a limit from the dashboard.",[416,1701,1702,1705],{},[274,1703,1704],{},"Weighting:"," each entry is a separate ticket in the draw, so a member with 5 entries is five times as likely to win as a member with 1.",[416,1707,1708,1711],{},[274,1709,1710],{},"Test mode:"," entries created while the prize draw is in test mode are tagged as test and only used in test draws. Turn test mode off before go-live.",[416,1713,1714,1717,1718,1721],{},[274,1715,1716],{},"Email:"," if the prize draw's ",[274,1719,1720],{},"Entry received"," email is on, Incentable emails the entrant after each successful submission.",[416,1723,1724,1727,1728,1730,1731,1733,1734,1737],{},[274,1725,1726],{},"Visibility:"," entries appear on the prize draw's ",[274,1729,477],{}," tab with source ",[274,1732,233],{},". Every request — including rejected ones — is recorded in the integration's ",[274,1735,1736],{},"Activity"," log.",[408,1739,1741],{"id":1740},"common-errors","Common errors",[270,1743,1744,1745,1747,1748,425,1750,1752,1753,464],{},"Errors return a JSON body with ",[279,1746,1342],{},", ",[279,1749,1369],{},[279,1751,279],{},", and sometimes ",[279,1754,1755],{},"details",[362,1757,1758,1770],{},[365,1759,1760],{},[368,1761,1762,1765,1768],{},[371,1763,1764],{},"Status",[371,1766,1767],{},"Code",[371,1769,1595],{},[378,1771,1772,1785,1799,1814,1834,1851,1867,1880,1896,1909,1924,1936,1952],{},[368,1773,1774,1777,1782],{},[383,1775,1776],{},"400",[383,1778,1779],{},[279,1780,1781],{},"VALIDATION_ERROR",[383,1783,1784],{},"Missing member fields, or bad field types",[368,1786,1787,1789,1794],{},[383,1788,1776],{},[383,1790,1791],{},[279,1792,1793],{},"INVALID_ARGUMENT",[383,1795,1796,1798],{},[279,1797,623],{}," is not a whole number",[368,1800,1801,1803,1808],{},[383,1802,1776],{},[383,1804,1805],{},[279,1806,1807],{},"NO_PRIZE_DRAW_SPECIFIED",[383,1809,1810,1811,1813],{},"No ",[279,1812,463],{}," and no default on the integration",[368,1815,1816,1818,1823],{},[383,1817,1776],{},[383,1819,1820],{},[279,1821,1822],{},"REFERENCE_REQUIRED",[383,1824,1825,1826,1747,1828,1830,1831,1833],{},"Braze integrations only: no ",[279,1827,642],{},[279,1829,660],{}," or ",[279,1832,688],{}," header",[368,1835,1836,1839,1848],{},[383,1837,1838],{},"401",[383,1840,1841,1844,1845],{},[279,1842,1843],{},"INVALID_API_KEY"," \u002F ",[279,1846,1847],{},"MISSING_API_KEY",[383,1849,1850],{},"Key missing, wrong or revoked",[368,1852,1853,1856,1861],{},[383,1854,1855],{},"403",[383,1857,1858],{},[279,1859,1860],{},"PERMISSION_DENIED",[383,1862,1863,1864,1866],{},"Key lacks ",[279,1865,390],{}," write (or read for lookups)",[368,1868,1869,1872,1877],{},[383,1870,1871],{},"404",[383,1873,1874],{},[279,1875,1876],{},"NOT_FOUND",[383,1878,1879],{},"Prize draw (or submission) not found in this program",[368,1881,1882,1884,1888],{},[383,1883,1664],{},[383,1885,1886],{},[279,1887,1310],{},[383,1889,1890,1892,1893,1895],{},[279,1891,642],{}," already used in this prize draw — ",[279,1894,1668],{}," has the original",[368,1897,1898,1901,1906],{},[383,1899,1900],{},"422",[383,1902,1903],{},[279,1904,1905],{},"PROMOTION_NOT_ACTIVE",[383,1907,1908],{},"Prize draw is not Active",[368,1910,1911,1913,1921],{},[383,1912,1900],{},[383,1914,1915,1844,1918],{},[279,1916,1917],{},"PROMOTION_NOT_OPEN",[279,1919,1920],{},"PROMOTION_CLOSED",[383,1922,1923],{},"Request is outside the entry period",[368,1925,1926,1928,1933],{},[383,1927,1900],{},[383,1929,1930],{},[279,1931,1932],{},"ENTRANT_EXCLUDED",[383,1934,1935],{},"Member is excluded from this prize draw",[368,1937,1938,1940,1945],{},[383,1939,1900],{},[383,1941,1942],{},[279,1943,1944],{},"LIMIT_EXCEEDED",[383,1946,1947,1948,1951],{},"Over a per-member or per-submission limit — ",[279,1949,1950],{},"details.limitBreaches"," lists which",[368,1953,1954,1957,1962],{},[383,1955,1956],{},"429",[383,1958,1959],{},[279,1960,1961],{},"RATE_LIMIT_EXCEEDED",[383,1963,1964],{},"Rate limit reached for the key; retry with backoff",[270,1966,1967,1970,1971,1973,1974,425,1976,1979,1980,1983,1984,464],{},[279,1968,1969],{},"4XX"," errors other than ",[279,1972,1956],{}," will fail again if retried unchanged — fix the request rather than retrying. Retry ",[279,1975,1956],{},[279,1977,1978],{},"5XX"," with the ",[274,1981,1982],{},"same"," ",[279,1985,642],{},[313,1987,399],{"id":1988},"look-up-a-submission",[318,1990,1992],{"className":340,"code":1991,"language":342,"meta":326,"style":326},"GET \u002Fprizedraws\u002Fentries\u002F{id}?prizeDrawId=YOUR_PRIZE_DRAW_ID\n",[279,1993,1994],{"__ignoreMap":326},[346,1995,1996,1999],{"class":348,"line":349},[346,1997,1998],{"class":352},"GET",[346,2000,2001],{"class":356}," \u002Fprizedraws\u002Fentries\u002F{id}?prizeDrawId=YOUR_PRIZE_DRAW_ID\n",[270,2003,2004,2007,2008,1983,2010,2013,2014,2016,2017,2019],{},[279,2005,2006],{},"{id}"," may be the ",[279,2009,1430],{},[274,2011,2012],{},"or"," your ",[279,2015,642],{},". ",[279,2018,463],{}," can be omitted when the integration has a default prize draw.",[318,2021,2023],{"className":340,"code":2022,"language":342,"meta":326,"style":326},"curl -X GET \\\n  \"https:\u002F\u002Fus-central1-incentable-app-37d9c.cloudfunctions.net\u002FexternalApi\u002Fapi\u002Fv1\u002Fexternal\u002Fprizedraws\u002Fentries\u002Forder-10045?prizeDrawId=YOUR_PRIZE_DRAW_ID\" \\\n  -H \"Authorization: Bearer YOUR_API_KEY\"\n",[279,2024,2025,2036,2047],{"__ignoreMap":326},[346,2026,2027,2029,2031,2034],{"class":348,"line":349},[346,2028,724],{"class":352},[346,2030,727],{"class":356},[346,2032,2033],{"class":356}," GET",[346,2035,734],{"class":733},[346,2037,2038,2040,2043,2045],{"class":348,"line":737},[346,2039,741],{"class":740},[346,2041,2042],{"class":356},"https:\u002F\u002Fus-central1-incentable-app-37d9c.cloudfunctions.net\u002FexternalApi\u002Fapi\u002Fv1\u002Fexternal\u002Fprizedraws\u002Fentries\u002Forder-10045?prizeDrawId=YOUR_PRIZE_DRAW_ID",[346,2044,747],{"class":740},[346,2046,734],{"class":733},[346,2048,2049,2051,2053,2055],{"class":348,"line":752},[346,2050,755],{"class":356},[346,2052,758],{"class":740},[346,2054,761],{"class":356},[346,2056,1525],{"class":740},[408,2058,2060],{"id":2059},"example-response","Example response",[318,2062,2064],{"className":1402,"code":2063,"language":1219,"meta":326,"style":326},"{\n  \"data\": {\n    \"submissionId\": \"sub_1aae5cd95fe1b38bcedf\",\n    \"prizeDrawId\": \"YOUR_PRIZE_DRAW_ID\",\n    \"memberId\": \"memberDocId\",\n    \"externalRef\": \"order-10045\",\n    \"source\": \"api\",\n    \"quantity\": 2,\n    \"validEntries\": 2,\n    \"voidEntries\": 0,\n    \"isTest\": false,\n    \"createdAt\": \"2026-10-20T00:15:00.000Z\"\n  }\n}\n",[279,2065,2066,2070,2082,2100,2118,2136,2154,2174,2188,2203,2219,2231,2249,2253],{"__ignoreMap":326},[346,2067,2068],{"class":348,"line":349},[346,2069,791],{"class":740},[346,2071,2072,2074,2076,2078,2080],{"class":348,"line":737},[346,2073,741],{"class":740},[346,2075,1416],{"class":876},[346,2077,747],{"class":740},[346,2079,919],{"class":740},[346,2081,937],{"class":740},[346,2083,2084,2086,2088,2090,2092,2094,2096,2098],{"class":348,"line":752},[346,2085,1427],{"class":740},[346,2087,1430],{"class":352},[346,2089,747],{"class":740},[346,2091,919],{"class":740},[346,2093,758],{"class":740},[346,2095,1439],{"class":356},[346,2097,747],{"class":740},[346,2099,905],{"class":740},[346,2101,2102,2104,2106,2108,2110,2112,2114,2116],{"class":348,"line":768},[346,2103,1427],{"class":740},[346,2105,463],{"class":352},[346,2107,747],{"class":740},[346,2109,919],{"class":740},[346,2111,758],{"class":740},[346,2113,1458],{"class":356},[346,2115,747],{"class":740},[346,2117,905],{"class":740},[346,2119,2120,2122,2124,2126,2128,2130,2132,2134],{"class":348,"line":782},[346,2121,1427],{"class":740},[346,2123,1537],{"class":352},[346,2125,747],{"class":740},[346,2127,919],{"class":740},[346,2129,758],{"class":740},[346,2131,1546],{"class":356},[346,2133,747],{"class":740},[346,2135,905],{"class":740},[346,2137,2138,2140,2142,2144,2146,2148,2150,2152],{"class":348,"line":794},[346,2139,1427],{"class":740},[346,2141,642],{"class":352},[346,2143,747],{"class":740},[346,2145,919],{"class":740},[346,2147,758],{"class":740},[346,2149,1522],{"class":356},[346,2151,747],{"class":740},[346,2153,905],{"class":740},[346,2155,2156,2158,2161,2163,2165,2167,2170,2172],{"class":348,"line":800},[346,2157,1427],{"class":740},[346,2159,2160],{"class":352},"source",[346,2162,747],{"class":740},[346,2164,919],{"class":740},[346,2166,758],{"class":740},[346,2168,2169],{"class":356},"api",[346,2171,747],{"class":740},[346,2173,905],{"class":740},[346,2175,2176,2178,2180,2182,2184,2186],{"class":348,"line":806},[346,2177,1427],{"class":740},[346,2179,623],{"class":352},[346,2181,747],{"class":740},[346,2183,919],{"class":740},[346,2185,1475],{"class":1135},[346,2187,905],{"class":740},[346,2189,2190,2192,2195,2197,2199,2201],{"class":348,"line":812},[346,2191,1427],{"class":740},[346,2193,2194],{"class":352},"validEntries",[346,2196,747],{"class":740},[346,2198,919],{"class":740},[346,2200,1475],{"class":1135},[346,2202,905],{"class":740},[346,2204,2205,2207,2210,2212,2214,2217],{"class":348,"line":818},[346,2206,1427],{"class":740},[346,2208,2209],{"class":352},"voidEntries",[346,2211,747],{"class":740},[346,2213,919],{"class":740},[346,2215,2216],{"class":1135}," 0",[346,2218,905],{"class":740},[346,2220,2221,2223,2225,2227,2229],{"class":348,"line":824},[346,2222,1427],{"class":740},[346,2224,1500],{"class":352},[346,2226,747],{"class":740},[346,2228,919],{"class":740},[346,2230,1507],{"class":740},[346,2232,2233,2235,2238,2240,2242,2244,2247],{"class":348,"line":830},[346,2234,1427],{"class":740},[346,2236,2237],{"class":352},"createdAt",[346,2239,747],{"class":740},[346,2241,919],{"class":740},[346,2243,758],{"class":740},[346,2245,2246],{"class":356},"2026-10-20T00:15:00.000Z",[346,2248,1525],{"class":740},[346,2250,2251],{"class":348,"line":836},[346,2252,1185],{"class":740},[346,2254,2255],{"class":348,"line":842},[346,2256,1379],{"class":740},[270,2258,2259,2261],{},[279,2260,2209],{}," counts entries an admin has voided since the submission (for example, after a refund). Voided entries are not included in draws.",[313,2263,2265],{"id":2264},"test-checklist","Test checklist",[1678,2267,2270,2285,2299,2310,2322,2331,2340],{"className":2268},[2269],"contains-task-list",[416,2271,2274,2278,2279,2281,2282],{"className":2272},[2273],"task-list-item",[2275,2276],"input",{"disabled":1198,"type":2277},"checkbox"," Prize draw ",[274,2280,1698],{},", inside its entry period, and in ",[274,2283,2284],{},"Test mode",[416,2286,2288,2290,2291,1983,2293,2295,2296,2298],{"className":2287},[2273],[2275,2289],{"disabled":1198,"type":2277}," Custom API key has ",[279,2292,390],{},[274,2294,394],{}," (and ",[274,2297,406],{}," if you look up submissions)",[416,2300,2302,1983,2304,2306,2307,2309],{"className":2301},[2273],[2275,2303],{"disabled":1198,"type":2277},[279,2305,1399],{}," on a first request; entries visible on the prize draw's ",[274,2308,477],{}," tab",[416,2311,2313,2315,2316,2318,2319,2321],{"className":2312},[2273],[2275,2314],{"disabled":1198,"type":2277}," Same ",[279,2317,642],{}," again returns ",[279,2320,1664],{},", with no new entries",[416,2323,2325,2327,2328,2330],{"className":2324},[2273],[2275,2326],{"disabled":1198,"type":2277}," Lookup by ",[279,2329,642],{}," returns the submission",[416,2332,2334,2336,2337,2339],{"className":2333},[2273],[2275,2335],{"disabled":1198,"type":2277}," Your system handles ",[279,2338,1900],{}," rejections (closed, limit reached, excluded) without retrying",[416,2341,2343,2345],{"className":2342},[2273],[2275,2344],{"disabled":1198,"type":2277}," Test mode turned off for go-live",[313,2347,2349],{"id":2348},"related-guides","Related guides",[1678,2351,2352,2357],{},[416,2353,2354,2356],{},[308,2355,310],{"href":258}," — the same endpoint from a Braze campaign or Canvas",[416,2358,2359,2362],{},[308,2360,2361],{"href":234},"API Overview"," — base URL, auth, getting your API key",[2364,2365,2366],"style",{},"html pre.shiki code .sBMFI, html code.shiki .sBMFI{--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B}html pre.shiki code .sfazB, html code.shiki .sfazB{--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D}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);}html pre.shiki code .sTEyZ, html code.shiki .sTEyZ{--shiki-light:#90A4AE;--shiki-default:#EEFFFF;--shiki-dark:#BABED8}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 .sbssI, html code.shiki .sbssI{--shiki-light:#F76D47;--shiki-default:#F78C6C;--shiki-dark:#F78C6C}html pre.shiki code .s7zQu, html code.shiki .s7zQu{--shiki-light:#39ADB5;--shiki-light-font-style:italic;--shiki-default:#89DDFF;--shiki-default-font-style:italic;--shiki-dark:#89DDFF;--shiki-dark-font-style:italic}html pre.shiki code .s2Zo4, html code.shiki .s2Zo4{--shiki-light:#6182B8;--shiki-default:#82AAFF;--shiki-dark:#82AAFF}html pre.shiki code .swJcz, html code.shiki .swJcz{--shiki-light:#E53935;--shiki-default:#F07178;--shiki-dark:#F07178}html pre.shiki code .sHwdD, html code.shiki .sHwdD{--shiki-light:#90A4AE;--shiki-light-font-style:italic;--shiki-default:#546E7A;--shiki-default-font-style:italic;--shiki-dark:#676E95;--shiki-dark-font-style:italic}",{"title":326,"searchDepth":737,"depth":737,"links":2368},[2369,2370,2374,2383,2386,2387],{"id":315,"depth":737,"text":316},{"id":329,"depth":737,"text":330,"children":2371},[2372,2373],{"id":410,"depth":752,"text":411},{"id":470,"depth":752,"text":471},{"id":492,"depth":737,"text":385,"children":2375},[2376,2377,2378,2379,2381,2382],{"id":508,"depth":752,"text":509},{"id":713,"depth":752,"text":714},{"id":863,"depth":752,"text":864},{"id":1395,"depth":752,"text":2380},"Success response (201)",{"id":1675,"depth":752,"text":1676},{"id":1740,"depth":752,"text":1741},{"id":1988,"depth":737,"text":399,"children":2384},[2385],{"id":2059,"depth":752,"text":2060},{"id":2264,"depth":737,"text":2265},{"id":2348,"depth":737,"text":2349},"Enter members into an Incentable prize draw from your own system via the Custom API, with no entry form.","md",{},{"icon":246},{"title":243,"description":2388},"AMIQsUcgfw0jXsPDbsA9m_-dhDtRk7zI1ibqsagu6pI",[2395,2397],{"title":239,"path":240,"stem":241,"description":2396,"icon":91,"children":-1},"Issue and look up RewardStar gift cards via the Custom API.",{"title":253,"path":254,"stem":255,"description":2398,"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.",1792454585318]