[{"data":1,"prerenderedAt":773},["ShallowReactive",2],{"header:help":3,"footer:default":67,"story:navigation\u002Fsearch:help":250,"story:help\u002Fcategories":288,"story:help\u002Farticles\u002Fset-up-gift-cards-for-purchase-via-the-api":314,"no-guide:set-up-gift-cards-for-purchase-via-the-api":59,"article:\u002Fhelp\u002Farticles\u002Fset-up-gift-cards-for-purchase-via-the-api":515,"story:contact":529,"help:tree:160d5414-88f8-4235-884d-8d3dec6d4c1d":719,"_apollo:default":772},{"name":4,"created_at":5,"published_at":6,"updated_at":7,"id":8,"uuid":9,"content":10,"slug":57,"full_slug":58,"sort_by_date":59,"position":60,"tag_list":61,"is_startpage":24,"parent_id":62,"meta_data":59,"group_id":63,"first_published_at":64,"release_id":59,"lang":65,"path":59,"alternates":66,"default_full_slug":59,"translated_slugs":59},"Help Center Header","2024-08-09T18:06:34.939Z","2024-10-21T21:58:39.217Z","2024-10-21T21:58:39.232Z",10082752,"3e9b88f7-c163-4657-a2f2-62532d600fad",{"_uid":11,"link":12,"badge":16,"items":17,"title":13,"buttons":50,"new_tab":24,"submenu":51,"alignment":13,"component":52,"badge_link":53,"top_menu_items":56},"e5645a1a-f991-40e8-8d67-e40ebc082b5a",{"id":13,"url":13,"linktype":14,"fieldtype":15,"cached_url":13},"","story","multilink","Help Center",[18,27,34,39,44],{"_uid":19,"link":20,"title":23,"new_tab":24,"submenu":25,"component":26},"5cbe2861-1f49-4166-97da-a4dddd8105e3",{"id":21,"url":13,"linktype":14,"fieldtype":15,"cached_url":22},"4c0a2d99-ec30-4579-8ef1-6bf5564d4839","help\u002Fcategories\u002F","Articles",false,[],"header___item",{"_uid":28,"link":29,"title":32,"new_tab":33,"component":26},"1c8edeb5-b9e9-4cb8-b1c6-c1f292f7d7cd",{"id":13,"url":30,"linktype":31,"fieldtype":15,"cached_url":30},"https:\u002F\u002Fwiki.foxycart.com\u002F","url","Documentation",true,{"_uid":35,"link":36,"title":38,"new_tab":33,"component":26},"8d7df70e-f087-4da0-b616-6f0e9a5af35c",{"id":13,"url":37,"linktype":31,"fieldtype":15,"cached_url":37},"https:\u002F\u002Fapi.foxycart.com\u002F","API Documentation",{"_uid":40,"link":41,"title":43,"new_tab":33,"component":26},"f76e7944-23d5-4652-87e4-cdae79272762",{"id":13,"url":42,"linktype":31,"fieldtype":15,"cached_url":42},"https:\u002F\u002Fstatus.foxy.io\u002F","System Status",{"_uid":45,"link":46,"title":49,"new_tab":24,"component":26},"0de16771-4c84-466c-a1da-d8568113c71f",{"id":47,"url":13,"linktype":14,"fieldtype":15,"cached_url":48},"01e4e370-f9b9-45af-8fa9-f15540699b0d","contact","Contact Us",[],[],"header",{"id":54,"url":13,"linktype":14,"fieldtype":15,"cached_url":55},"4a679eb7-662d-4ea4-a976-5a2acbf0b663","help\u002F",[],"help-header","navigation\u002Fhelp-header",null,20,[],10082747,"71b81c2e-5e09-48a1-a397-a3c72fcd344a","2022-09-21T14:50:25.655Z","default",[],{"name":68,"created_at":69,"published_at":70,"updated_at":71,"id":72,"uuid":73,"content":74,"slug":243,"full_slug":244,"sort_by_date":59,"position":245,"tag_list":246,"is_startpage":24,"parent_id":62,"meta_data":59,"group_id":247,"first_published_at":248,"release_id":59,"lang":65,"path":59,"alternates":249,"default_full_slug":59,"translated_slugs":59},"Default Footer","2024-08-09T18:06:59.024Z","2025-09-04T06:24:46.223Z","2025-09-04T06:24:46.241Z",10082753,"e59e67ac-248a-482f-84a1-53d4f318186a",{"_uid":75,"about":76,"logos":77,"socials":82,"sections":108,"component":225,"cta_title":226,"bottom_links":227,"cta_subtitle":241,"cta_button_link":242,"cta_button_text":183},"830983f5-c4c4-43c8-b150-86a5e3fa6dc8","Foxy’s hosted cart & payment page allow you to sell anything, using your existing website or platform.",[78],{"id":79,"alt":13,"name":13,"focus":13,"title":13,"filename":80,"copyright":13,"fieldtype":81},14760,"https:\u002F\u002Fa-us.storyblok.com\u002Ff\u002F1001040\u002Fx\u002F3b030847ec\u002Fb-corp.svg","asset",[83,90,96,102],{"_uid":84,"icon":85,"link":86,"name":88,"component":89},"faf0a618-ea94-42ea-9182-03be18c43216","fa-facebook",{"id":13,"url":87,"linktype":31,"fieldtype":15,"cached_url":87},"https:\u002F\u002Fwww.facebook.com\u002Ffoxycart","Facebook","footer___social",{"_uid":91,"icon":92,"link":93,"name":95,"component":89},"14309c18-7e79-423e-b375-34555bac0811","fa-instagram",{"id":13,"url":94,"linktype":31,"fieldtype":15,"cached_url":94},"https:\u002F\u002Fwww.instagram.com\u002Ffoxy_io","Instagram",{"_uid":97,"icon":98,"link":99,"name":101,"component":89},"8f7fe7cf-0dd3-4596-8334-226ea466716a","fa-linkedin",{"id":13,"url":100,"linktype":31,"fieldtype":15,"cached_url":100},"https:\u002F\u002Fwww.linkedin.com\u002Fcompany\u002Ffoxycart.com","LinkedIn",{"_uid":103,"icon":104,"link":105,"name":107,"component":89},"90a675b4-dd97-40b5-be09-00a87223d4c5","fa-youtube",{"id":13,"url":106,"linktype":31,"fieldtype":15,"cached_url":106},"https:\u002F\u002Fwww.youtube.com\u002Fuser\u002Ffoxycart","Youtube",[109,139,184,206],{"_uid":110,"name":111,"items":112,"component":138},"82849945-282f-488c-b18d-a8d2252f514a","Company",[113,120,126,132],{"_uid":114,"link":115,"title":118,"new_tab":24,"component":119},"1f699ab1-938b-4d9d-9825-aabcbe6f57fe",{"id":116,"url":13,"linktype":14,"fieldtype":15,"cached_url":117},"63634293-a749-4226-9439-9f38ee6dcda0","about-us","About Us","footer___menu_items",{"_uid":121,"link":122,"title":125,"new_tab":24,"component":119},"b26b00f1-a0e7-4be2-8ab3-428b8cc841f8",{"id":123,"url":13,"linktype":14,"fieldtype":15,"cached_url":124},"26cb7c55-faed-4a77-a291-1552d4111b3e","how-foxy-works","How Foxy Works",{"_uid":127,"link":128,"title":131,"new_tab":24,"component":119},"b40c68a0-1ceb-4226-9515-6176534f61fe",{"id":129,"url":13,"linktype":14,"fieldtype":15,"cached_url":130},"dc6657d7-7f4f-4c0d-b781-e971b038ee26","for-good","Foxy For Good",{"_uid":133,"link":134,"title":137,"new_tab":24,"component":119},"3ad0c134-bef9-4fff-b891-e09f16109036",{"id":135,"url":13,"linktype":14,"fieldtype":15,"cached_url":136},"23cae210-baf4-4588-9862-d09f4f52ccd2","brand-assets","Brand Assets","footer___section",{"_uid":140,"name":141,"items":142,"component":138},"a6805fa8-ac60-47f1-b8f0-f27aded0afbe","Product",[143,149,155,161,167,173,179],{"_uid":144,"link":145,"title":148,"new_tab":24,"component":119},"b39c8a4e-2383-486f-b76a-11fbb15d8134",{"id":146,"url":13,"linktype":14,"fieldtype":15,"cached_url":147},"bb04690f-fe98-4ce6-80be-05b950f2364f","features\u002F","Features",{"_uid":150,"link":151,"title":154,"new_tab":24,"component":119},"64f8a41f-c181-433d-bc0a-fc94e71ecbf6",{"id":152,"url":13,"linktype":14,"fieldtype":15,"cached_url":153},"c450c58d-761d-48c0-a9af-0b064611689b","pricing","Pricing",{"_uid":156,"link":157,"title":160,"new_tab":24,"component":119},"6e0b287f-fd8c-4146-9e0e-0ab0b5c9ce3c",{"id":158,"url":13,"linktype":14,"fieldtype":15,"cached_url":159},"fab20ad9-e76a-4947-b709-3a6fdfa88028","blog\u002Fcategories\u002Fproduct-updates","Product Updates",{"_uid":162,"link":163,"title":166,"new_tab":24,"component":119},"47e5a074-a6b5-4f1c-8c2f-89a2ae9f83eb",{"id":164,"url":13,"linktype":14,"fieldtype":15,"cached_url":165},"d2c83612-d611-47f3-a3b4-ca7fe08540b8","changelogs\u002F","Changelogs",{"_uid":168,"link":169,"title":172,"new_tab":24,"component":119},"b5c08774-542f-4ffd-b357-c94d674488b9",{"id":170,"url":13,"linktype":14,"fieldtype":15,"cached_url":171},"08876121-0df3-4ed9-aa11-902b3e41cd02","whats-next","What's Next",{"_uid":174,"link":175,"title":178,"new_tab":24,"component":119},"9c2704ed-6d9f-43e1-9e67-c8d91c083288",{"id":176,"url":13,"linktype":14,"fieldtype":15,"cached_url":177},"056a7857-b18f-4025-8f97-91a38fc19bc8","compare\u002F","Compare",{"_uid":180,"link":181,"title":183,"new_tab":24,"component":119},"5f2db35b-674b-406a-8fa7-d246633af9fe",{"id":13,"url":182,"linktype":31,"fieldtype":15,"cached_url":182},"https:\u002F\u002Fadmin.foxy.io\u002Fsign-up","Try Foxy Free",{"_uid":185,"name":186,"items":187,"component":138},"63fa1f29-4252-4640-9922-fe310e69e54a","Security",[188,194,200],{"_uid":189,"link":190,"title":193,"new_tab":24,"component":119},"1158ddb6-9eb0-466f-8eb6-7ca2ae66c8b8",{"id":191,"url":13,"linktype":14,"fieldtype":15,"cached_url":192},"1f58fb2c-8681-4742-b6e8-09999beae9f6","security-contact","Security Contact",{"_uid":195,"link":196,"title":199,"new_tab":24,"component":119},"9a79c54a-6022-4dfd-854b-766f5e4703ba",{"id":197,"url":13,"linktype":14,"fieldtype":15,"cached_url":198},"55cbfcc3-425a-4261-8037-54e919851d2d","pci","PCI Compliance",{"_uid":201,"link":202,"title":205,"new_tab":24,"component":119},"0b85f5b6-9534-4071-b323-b39d053dd4d7",{"id":203,"url":13,"linktype":14,"fieldtype":15,"cached_url":204},"c3ac0fe3-83e2-4879-afbd-d4c83e1590df","help\u002Farticles\u002Four-official-domains-public-code","Domains & Codebases",{"_uid":207,"name":208,"items":209,"component":138},"998ded67-d107-49f4-8154-ca6be51671ec","Support",[210,213,216,219,222],{"_uid":211,"link":212,"title":16,"new_tab":24,"component":119},"594ffd35-3049-4004-bb08-0db568ebd819",{"id":54,"url":13,"linktype":14,"fieldtype":15,"cached_url":55},{"_uid":214,"link":215,"title":32,"new_tab":33,"component":119},"0a1a55ab-a985-4f9d-8b42-26da714d0c1c",{"id":13,"url":30,"linktype":31,"fieldtype":15,"cached_url":30},{"_uid":217,"link":218,"title":38,"new_tab":33,"component":119},"61e0b7c8-aadf-419b-a339-b3ccabc65bf4",{"id":13,"url":37,"linktype":31,"fieldtype":15,"cached_url":37},{"_uid":220,"link":221,"title":43,"new_tab":33,"component":119},"fd67a89e-1c54-4d31-94b5-64be999062d6",{"id":13,"url":42,"linktype":31,"fieldtype":15,"cached_url":42},{"_uid":223,"link":224,"title":49,"new_tab":24,"component":119},"231a6f71-e996-4ad4-b033-d4d5542f34f0",{"id":47,"url":13,"linktype":14,"fieldtype":15,"cached_url":48},"footer","Get started with our *unlimited free trial*.",[228,235],{"_uid":229,"link":230,"text":233,"component":234},"f0b77210-2632-45a2-8436-e57cad84d01a",{"id":231,"url":13,"linktype":14,"fieldtype":15,"cached_url":232},"60ba16a2-c1f4-485f-b978-8d2eeeafbf5a","terms-of-service","Terms of Service","footer___bottom_links",{"_uid":236,"link":237,"text":240,"component":234},"4bd497b0-993f-4b4d-a5b7-8a49c7c8fec9",{"id":238,"url":13,"linktype":14,"fieldtype":15,"cached_url":239},"332302b9-1d18-4016-b9c8-9b33c72d782b","privacy-policy","Privacy Policy","No credit card required.",{"id":13,"url":182,"linktype":31,"fieldtype":15,"cached_url":182},"default-footer","navigation\u002Fdefault-footer",50,[],"11006268-07f9-41e9-96f3-c51fb723399d","2022-09-21T20:39:02.357Z",[],{"name":251,"created_at":252,"published_at":253,"updated_at":254,"id":255,"uuid":256,"content":257,"slug":279,"full_slug":282,"sort_by_date":59,"position":283,"tag_list":284,"is_startpage":24,"parent_id":62,"meta_data":59,"group_id":285,"first_published_at":286,"release_id":59,"lang":65,"path":59,"alternates":287,"default_full_slug":59,"translated_slugs":59},"Search","2024-10-21T22:08:54.973Z","2025-05-26T09:17:25.790Z","2025-05-26T09:17:25.804Z",13592003,"14cbc359-9ac1-4a7a-a8de-ad4ac8ef26d4",{"_uid":258,"name":251,"indices":259,"summary":13,"component":279,"primary_image":280},"5e4a56e8-76f1-4790-b3a7-70f1be97d042",[260,265,269,274],{"key":261,"_uid":262,"icon":13,"name":263,"component":264},"all","c12a3210-7323-4273-8217-5215e52efe84","All","index",{"key":266,"_uid":267,"icon":268,"name":23,"component":264},"help_center_article","5acff080-95e4-44d3-8dcf-1b19720af382","fa-file-alt",{"key":270,"_uid":271,"icon":272,"name":273,"component":264},"help_center_guide","b8fbc206-c083-471e-a1f0-0ebeb90a669d","fa-book","Guides",{"key":275,"_uid":276,"icon":277,"name":278,"component":264},"blog_post","23419e83-2e56-4c4c-8a05-9fd1b3c9a9bd","fa-file-image","Blog Posts","search",{"id":59,"alt":59,"name":13,"focus":59,"title":59,"source":59,"filename":13,"copyright":59,"fieldtype":81,"meta_data":281},{},"navigation\u002Fsearch",60,[],"11e1fd31-95cd-4fc9-b736-8b8910663e6c","2024-10-21T23:17:05.904Z",[],{"name":23,"created_at":289,"published_at":290,"updated_at":291,"id":292,"uuid":21,"content":293,"slug":307,"full_slug":22,"sort_by_date":59,"position":308,"tag_list":309,"is_startpage":33,"parent_id":310,"meta_data":59,"group_id":311,"first_published_at":312,"release_id":59,"lang":65,"path":59,"alternates":313,"default_full_slug":59,"translated_slugs":59},"2022-09-19T14:42:29.685Z","2024-07-30T18:17:22.506Z","2024-07-30T18:17:22.525Z",2660,{"_uid":294,"icon":13,"name":23,"guides":295,"pinned":24,"summary":296,"category":13,"component":297,"blog_posts":298,"content_hub":24,"icon_custom":299,"case_studies":300,"faq_sections":301,"help_articles":302,"featured_guides":303,"mailbox_category":13,"featured_articles":304,"featured_blog_posts":305,"featured_case_studies":306},"d6dae89a-907a-4bf7-82de-fe2ba875ee6e",[],"Get your questions answered with our browsable knowledge base.","help_center_category",[],{"id":59,"alt":59,"name":13,"focus":59,"title":59,"filename":13,"copyright":59,"fieldtype":81},[],[],[],[],[],[],[],"categories",530,[],2658,"19ebcdd2-027f-47f5-9a5b-a8992c959578","2022-09-19T16:24:39.219Z",[],{"name":315,"created_at":316,"published_at":317,"updated_at":318,"id":319,"uuid":320,"content":321,"slug":508,"full_slug":509,"sort_by_date":59,"position":510,"tag_list":511,"is_startpage":24,"parent_id":512,"meta_data":59,"group_id":513,"first_published_at":317,"release_id":59,"lang":65,"path":59,"alternates":514,"default_full_slug":59,"translated_slugs":59},"Set up gift cards for purchase via the API","2026-07-17T01:19:20.951Z","2026-07-17T01:21:55.352Z","2026-07-17T01:21:55.367Z",198908153704091,"160d5414-88f8-4235-884d-8d3dec6d4c1d",{"_uid":322,"body":323,"name":315,"image":503,"pinned":24,"summary":505,"category":506,"component":266,"related_articles":507},"9eb03d73-1bbf-480c-8a32-b5a28118a246",{"type":324,"content":325},"doc",[326,333,340,352,358,396,401,431,436,447,469,474,479],{"type":327,"attrs":328,"content":329},"paragraph",{"textAlign":59},[330],{"text":331,"type":332},"You can enable a gift card for customer purchase and set up its recipient notification email entirely through the API, as an alternative to the admin UI.","text",{"type":334,"attrs":335,"content":337},"heading",{"level":336,"textAlign":59},2,[338],{"text":339,"type":332},"Enable the gift card for purchase",{"type":327,"attrs":341,"content":342},{"textAlign":59},[343,345,350],{"text":344,"type":332},"When creating a gift card via the API, include a ",{"text":346,"type":332,"marks":347},"provisioning_config",[348],{"type":349},"code",{"text":351,"type":332}," object to allow customers to purchase it:",{"type":353,"attrs":354,"content":355},"code_block",{"class":59},[356],{"text":357,"type":332},"{\n  \"name\": \"Widgets Gift Card\",\n  \"provisioning_config\": {\n    \"allow_autoprovisioning\": true,\n    \"initial_balance_max\": 100,\n    \"initial_balance_min\": 10\n  },\n  \"sku\": \"widgets\"\n}\n",{"type":359,"content":360},"bullet_list",[361,379],{"type":362,"content":363},"list_item",[364],{"type":327,"attrs":365,"content":366},{"textAlign":59},[367,371,373,377],{"text":368,"type":332,"marks":369},"allow_autoprovisioning",[370],{"type":349},{"text":372,"type":332}," — set to ",{"text":374,"type":332,"marks":375},"false",[376],{"type":349},{"text":378,"type":332}," to disallow new gift cards from being purchased by customers",{"type":362,"content":380},[381],{"type":327,"attrs":382,"content":383},{"textAlign":59},[384,388,390,394],{"text":385,"type":332,"marks":386},"initial_balance_min",[387],{"type":349},{"text":389,"type":332}," \u002F ",{"text":391,"type":332,"marks":392},"initial_balance_max",[393],{"type":349},{"text":395,"type":332}," — set the minimum and maximum balance a customer can put on the gift card when purchasing",{"type":334,"attrs":397,"content":398},{"level":336,"textAlign":59},[399],{"text":400,"type":332},"Set up the recipient notification email",{"type":402,"attrs":403,"content":405},"ordered_list",{"order":404},1,[406],{"type":362,"content":407},[408],{"type":327,"attrs":409,"content":410},{"textAlign":59},[411,413,417,419,423,425,429],{"text":412,"type":332},"Create a new email template by posting to the ",{"text":414,"type":332,"marks":415},"email_templates",[416],{"type":349},{"text":418,"type":332}," resource, including at minimum a ",{"text":420,"type":332,"marks":421},"description",[422],{"type":349},{"text":424,"type":332}," and ",{"text":426,"type":332,"marks":427},"subject",[428],{"type":349},{"text":430,"type":332},":",{"type":353,"attrs":432,"content":433},{"class":59},[434],{"text":435,"type":332},"{\n  \"description\": \"Gift Card Template\",\n  \"subject\": \"You have a gift!\"\n}\n",{"type":327,"attrs":437,"content":438},{"textAlign":59},[439,441,445],{"text":440,"type":332},"The API returns the new template’s URL, for example ",{"text":442,"type":332,"marks":443},"https:\u002F\u002F...\u002Femail_templates\u002F87992",[444],{"type":349},{"text":446,"type":332},".",{"type":402,"attrs":448,"content":449},{"order":404},[450],{"type":362,"content":451},[452],{"type":327,"attrs":453,"content":454},{"textAlign":59},[455,457,461,463,467],{"text":456,"type":332},"Associate the template with the category customers will use when purchasing the gift card. Send a PATCH request to the ",{"text":458,"type":332,"marks":459},"item_categories",[460],{"type":349},{"text":462,"type":332}," resource for that category, setting ",{"text":464,"type":332,"marks":465},"gift_recipient_email_template_uri",[466],{"type":349},{"text":468,"type":332}," to the template’s URL:",{"type":353,"attrs":470,"content":471},{"class":59},[472],{"text":473,"type":332},"{\n  \"gift_recipient_email_template_uri\": \"https:\u002F\u002Fapi.foxycart.com\u002Femail_templates\u002F{{your_new_email_template_id}}\"\n}\n",{"type":334,"attrs":475,"content":476},{"level":336,"textAlign":59},[477],{"text":478,"type":332},"Notes",{"type":359,"content":480},[481,496],{"type":362,"content":482},[483],{"type":327,"attrs":484,"content":485},{"textAlign":59},[486,488,495],{"text":487,"type":332},"This covers the API path only. For the equivalent steps in the admin UI, see ",{"text":489,"type":332,"marks":490},"Allow customers to purchase gift cards on your store",[491],{"type":492,"attrs":493},"link",{"href":494,"uuid":59,"anchor":59,"target":59,"linktype":31},"https:\u002F\u002Ffoxy.io\u002Fhelp\u002Farticles\u002Fallow-customers-to-purchase-gift-cards-on-your-store",{"text":446,"type":332},{"type":362,"content":497},[498],{"type":327,"attrs":499,"content":500},{"textAlign":59},[501],{"text":502,"type":332},"You’ll still need to build a storefront add-to-cart form for customers to purchase the gift card — see the same article for the required fields.",{"id":59,"alt":59,"name":13,"focus":59,"title":59,"source":59,"filename":13,"copyright":59,"fieldtype":81,"meta_data":504},{},"How to enable a gift card for customer purchase and set up its notification email using the API.","dc762556-754f-4db3-8560-6df76f76d887",[],"set-up-gift-cards-for-purchase-via-the-api","help\u002Farticles\u002Fset-up-gift-cards-for-purchase-via-the-api",-3580,[],2659,"ee884ce7-4443-45de-8333-6278b8172c20",[],{"html":516,"sections":517,"segments":525},"\u003Cp>You can enable a gift card for customer purchase and set up its recipient notification email entirely through the API, as an alternative to the admin UI.\u003C\u002Fp>\u003Csection id=\"enable-the-gift-card-for-purchase\" data-title=\"Enable the gift card for purchase\" data-title-node=\"H2\">\u003Chr class=\"my-8\" style=\"margin-left: -48px; margin-right: -40vw\">\u003Ch2 data-anchor-id=\"enable-the-gift-card-for-purchase\">Enable the gift card for purchase\u003C\u002Fh2>\u003Cp>When creating a gift card via the API, include a \u003Ccode class=\"badge bg-soft-danger text-danger\">provisioning_config\u003C\u002Fcode> object to allow customers to purchase it:\u003C\u002Fp>\u003Cdiv class=\"position-relative w-100 overflow-hidden rounded-2\" data-code-block>\u003Cdiv class=\"d-flex justify-content-end border-bottom\" style=\"background:#2b2c3b;\">\u003Cbutton type=\"button\" class=\"btn btn-link btn-sm text-light\" title=\"Copy\" data-code-button>\u003Cspan data-code-default style=\"\">\u003Ci class=\"fal fa-copy me-2\">\u003C\u002Fi> Copy \u003C\u002Fspan>\u003Cspan class=\"text-success\" data-code-success style=\"display:none;\">\u003Ci class=\"fal fa-check ms-2\">\u003C\u002Fi> Copied \u003C\u002Fspan>\u003C\u002Fbutton>\u003C\u002Fdiv>\u003Cdiv class=\"small\">\u003Cpre class=\"hljs p-2\" data-code-content>{\n  "name": "Widgets Gift Card",\n  "provisioning_config": {\n    "allow_autoprovisioning": true,\n    "initial_balance_max": 100,\n    "initial_balance_min": 10\n  },\n  "sku": "widgets"\n}\n\u003C\u002Fpre>\u003C\u002Fdiv>\u003C\u002Fdiv>\u003Cul>\u003Cli>\u003Cp>\u003Ccode class=\"badge bg-soft-danger text-danger\">allow_autoprovisioning\u003C\u002Fcode> — set to \u003Ccode class=\"badge bg-soft-danger text-danger\">false\u003C\u002Fcode> to disallow new gift cards from being purchased by customers\u003C\u002Fp>\u003C\u002Fli>\u003Cli>\u003Cp>\u003Ccode class=\"badge bg-soft-danger text-danger\">initial_balance_min\u003C\u002Fcode> \u002F \u003Ccode class=\"badge bg-soft-danger text-danger\">initial_balance_max\u003C\u002Fcode> — set the minimum and maximum balance a customer can put on the gift card when purchasing\u003C\u002Fp>\u003C\u002Fli>\u003C\u002Ful>\u003C\u002Fsection>\u003Csection id=\"set-up-the-recipient-notification-email\" data-title=\"Set up the recipient notification email\" data-title-node=\"H2\">\u003Chr class=\"my-8\" style=\"margin-left: -48px; margin-right: -40vw\">\u003Ch2 data-anchor-id=\"set-up-the-recipient-notification-email\">Set up the recipient notification email\u003C\u002Fh2>\u003Col class=\"step step-icon-sm step-dashed step-border-last-0 mt-3\">\u003Cli class=\"step-item\">\u003Cdiv class=\"step-content-wrapper\">\u003Cspan class=\"step-icon step-icon-soft-primary\">1\u003C\u002Fspan>\u003Cdiv class=\"w-100 overflow-hidden\">\u003Cdiv class=\"step-content mt-2\">\u003Cp>Create a new email template by posting to the \u003Ccode class=\"badge bg-soft-danger text-danger\">email_templates\u003C\u002Fcode> resource, including at minimum a \u003Ccode class=\"badge bg-soft-danger text-danger\">description\u003C\u002Fcode> and \u003Ccode class=\"badge bg-soft-danger text-danger\">subject\u003C\u002Fcode>:\u003C\u002Fp>\u003C\u002Fdiv>\u003C\u002Fdiv>\u003C\u002Fdiv>\u003C\u002Fli>\u003C\u002Fol>\u003Cdiv class=\"position-relative w-100 overflow-hidden rounded-2\" data-code-block>\u003Cdiv class=\"d-flex justify-content-end border-bottom\" style=\"background:#2b2c3b;\">\u003Cbutton type=\"button\" class=\"btn btn-link btn-sm text-light\" title=\"Copy\" data-code-button>\u003Cspan data-code-default style=\"\">\u003Ci class=\"fal fa-copy me-2\">\u003C\u002Fi> Copy \u003C\u002Fspan>\u003Cspan class=\"text-success\" data-code-success style=\"display:none;\">\u003Ci class=\"fal fa-check ms-2\">\u003C\u002Fi> Copied \u003C\u002Fspan>\u003C\u002Fbutton>\u003C\u002Fdiv>\u003Cdiv class=\"small\">\u003Cpre class=\"hljs p-2\" data-code-content>{\n  "description": "Gift Card Template",\n  "subject": "You have a gift!"\n}\n\u003C\u002Fpre>\u003C\u002Fdiv>\u003C\u002Fdiv>\u003Cp>The API returns the new template’s URL, for example \u003Ccode class=\"badge bg-soft-danger text-danger\">https:\u002F\u002F...\u002Femail_templates\u002F87992\u003C\u002Fcode>.\u003C\u002Fp>\u003Col class=\"step step-icon-sm step-dashed step-border-last-0 mt-3\">\u003Cli class=\"step-item\">\u003Cdiv class=\"step-content-wrapper\">\u003Cspan class=\"step-icon step-icon-soft-primary\">1\u003C\u002Fspan>\u003Cdiv class=\"w-100 overflow-hidden\">\u003Cdiv class=\"step-content mt-2\">\u003Cp>Associate the template with the category customers will use when purchasing the gift card. Send a PATCH request to the \u003Ccode class=\"badge bg-soft-danger text-danger\">item_categories\u003C\u002Fcode> resource for that category, setting \u003Ccode class=\"badge bg-soft-danger text-danger\">gift_recipient_email_template_uri\u003C\u002Fcode> to the template’s URL:\u003C\u002Fp>\u003C\u002Fdiv>\u003C\u002Fdiv>\u003C\u002Fdiv>\u003C\u002Fli>\u003C\u002Fol>\u003Cdiv class=\"position-relative w-100 overflow-hidden rounded-2\" data-code-block>\u003Cdiv class=\"d-flex justify-content-end border-bottom\" style=\"background:#2b2c3b;\">\u003Cbutton type=\"button\" class=\"btn btn-link btn-sm text-light\" title=\"Copy\" data-code-button>\u003Cspan data-code-default style=\"\">\u003Ci class=\"fal fa-copy me-2\">\u003C\u002Fi> Copy \u003C\u002Fspan>\u003Cspan class=\"text-success\" data-code-success style=\"display:none;\">\u003Ci class=\"fal fa-check ms-2\">\u003C\u002Fi> Copied \u003C\u002Fspan>\u003C\u002Fbutton>\u003C\u002Fdiv>\u003Cdiv class=\"small\">\u003Cpre class=\"hljs p-2\" data-code-content>{\n  "gift_recipient_email_template_uri": "https:\u002F\u002Fapi.foxycart.com\u002Femail_templates\u002F{{your_new_email_template_id}}"\n}\n\u003C\u002Fpre>\u003C\u002Fdiv>\u003C\u002Fdiv>\u003C\u002Fsection>\u003Csection id=\"notes\" data-title=\"Notes\" data-title-node=\"H2\">\u003Chr class=\"my-8\" style=\"margin-left: -48px; margin-right: -40vw\">\u003Ch2 data-anchor-id=\"notes\">Notes\u003C\u002Fh2>\u003Cul>\u003Cli>\u003Cp>This covers the API path only. For the equivalent steps in the admin UI, see \u003Ca href=\"https:\u002F\u002Ffoxy.io\u002Fhelp\u002Farticles\u002Fallow-customers-to-purchase-gift-cards-on-your-store\" class=\"\">Allow customers to purchase gift cards on your store\u003C\u002Fa>.\u003C\u002Fp>\u003C\u002Fli>\u003Cli>\u003Cp>You’ll still need to build a storefront add-to-cart form for customers to purchase the gift card — see the same article for the required fields.\u003C\u002Fp>\u003C\u002Fli>\u003C\u002Ful>\u003C\u002Fsection>",[518,521,523],{"id":519,"title":339,"level":520},"enable-the-gift-card-for-purchase","H2",{"id":522,"title":400,"level":520},"set-up-the-recipient-notification-email",{"id":524,"title":478,"level":520},"notes",[526],{"type":527,"content":528},"html","\u003Cp>You can enable a gift card for customer purchase and set up its recipient notification email entirely through the API, as an alternative to the admin UI.\u003C\u002Fp>\u003Ch2>Enable the gift card for purchase\u003C\u002Fh2>\u003Cp>When creating a gift card via the API, include a \u003Ccode class=\"badge bg-soft-danger text-danger\">provisioning_config\u003C\u002Fcode> object to allow customers to purchase it:\u003C\u002Fp>\u003Cpre>\u003Ccode>{\n  "name": "Widgets Gift Card",\n  "provisioning_config": {\n    "allow_autoprovisioning": true,\n    "initial_balance_max": 100,\n    "initial_balance_min": 10\n  },\n  "sku": "widgets"\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\u003Cul>\u003Cli>\u003Cp>\u003Ccode class=\"badge bg-soft-danger text-danger\">allow_autoprovisioning\u003C\u002Fcode> — set to \u003Ccode class=\"badge bg-soft-danger text-danger\">false\u003C\u002Fcode> to disallow new gift cards from being purchased by customers\u003C\u002Fp>\u003C\u002Fli>\u003Cli>\u003Cp>\u003Ccode class=\"badge bg-soft-danger text-danger\">initial_balance_min\u003C\u002Fcode> \u002F \u003Ccode class=\"badge bg-soft-danger text-danger\">initial_balance_max\u003C\u002Fcode> — set the minimum and maximum balance a customer can put on the gift card when purchasing\u003C\u002Fp>\u003C\u002Fli>\u003C\u002Ful>\u003Ch2>Set up the recipient notification email\u003C\u002Fh2>\u003Col order=\"1\">\u003Cli>\u003Cp>Create a new email template by posting to the \u003Ccode class=\"badge bg-soft-danger text-danger\">email_templates\u003C\u002Fcode> resource, including at minimum a \u003Ccode class=\"badge bg-soft-danger text-danger\">description\u003C\u002Fcode> and \u003Ccode class=\"badge bg-soft-danger text-danger\">subject\u003C\u002Fcode>:\u003C\u002Fp>\u003C\u002Fli>\u003C\u002Fol>\u003Cpre>\u003Ccode>{\n  "description": "Gift Card Template",\n  "subject": "You have a gift!"\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\u003Cp>The API returns the new template’s URL, for example \u003Ccode class=\"badge bg-soft-danger text-danger\">https:\u002F\u002F...\u002Femail_templates\u002F87992\u003C\u002Fcode>.\u003C\u002Fp>\u003Col order=\"1\">\u003Cli>\u003Cp>Associate the template with the category customers will use when purchasing the gift card. Send a PATCH request to the \u003Ccode class=\"badge bg-soft-danger text-danger\">item_categories\u003C\u002Fcode> resource for that category, setting \u003Ccode class=\"badge bg-soft-danger text-danger\">gift_recipient_email_template_uri\u003C\u002Fcode> to the template’s URL:\u003C\u002Fp>\u003C\u002Fli>\u003C\u002Fol>\u003Cpre>\u003Ccode>{\n  "gift_recipient_email_template_uri": "https:\u002F\u002Fapi.foxycart.com\u002Femail_templates\u002F{{your_new_email_template_id}}"\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\u003Ch2>Notes\u003C\u002Fh2>\u003Cul>\u003Cli>\u003Cp>This covers the API path only. For the equivalent steps in the admin UI, see \u003Ca href=\"https:\u002F\u002Ffoxy.io\u002Fhelp\u002Farticles\u002Fallow-customers-to-purchase-gift-cards-on-your-store\" class=\"\">Allow customers to purchase gift cards on your store\u003C\u002Fa>.\u003C\u002Fp>\u003C\u002Fli>\u003Cli>\u003Cp>You’ll still need to build a storefront add-to-cart form for customers to purchase the gift card — see the same article for the required fields.\u003C\u002Fp>\u003C\u002Fli>\u003C\u002Ful>",{"name":530,"created_at":531,"published_at":532,"updated_at":533,"id":534,"uuid":47,"content":535,"slug":48,"full_slug":48,"sort_by_date":59,"position":714,"tag_list":715,"is_startpage":24,"parent_id":59,"meta_data":59,"group_id":716,"first_published_at":717,"release_id":59,"lang":65,"path":59,"alternates":718,"default_full_slug":59,"translated_slugs":59},"Contact","2022-09-23T19:56:58.957Z","2025-05-08T18:24:40.382Z","2025-05-08T18:24:40.392Z",3138,{"seo":536,"_uid":539,"title":540,"action":541,"fields":542,"method":690,"columns":691,"subtitle":705,"component":48,"button_text":711,"submit_title":712,"submit_subtitle":713},{"_uid":537,"title":530,"plugin":538,"description":13},"24ff7574-3bcc-48d2-85b5-e529dfea1cc4","meta-fields","8f54f1da-9d8f-49b2-89e7-840e886491cb","We're here to help.","https:\u002F\u002Fusebasin.com\u002Ff\u002F029f48d65402",[543,548,552,661,664,669,684],{"_uid":544,"name":545,"type":332,"label":546,"options":13,"required":33,"component":547,"placeholder":13},"9a70b226-2036-4f90-a052-b3efa61c5896","name","Name","form___field",{"_uid":549,"name":550,"type":550,"label":551,"options":13,"required":33,"component":547,"placeholder":13},"86ba35be-ff43-4a28-8633-14052a8f6622","email","Email Address",{"_uid":553,"name":554,"type":555,"label":556,"options":557,"required":33,"component":547,"conditions":558,"placeholder":13},"3f827475-492c-4f97-aa1e-2386ac263b6c","topic","select","Topic","Presales, Support, Billing, Partnerships, Order Enquiry, Other",[559,615,625,632,640,648,654],{"_uid":560,"equals":561,"fields":562,"component":614},"e21d97dd-e68e-4fa6-ba97-bc40f3041dde","Order Enquiry",[563],{"_uid":564,"body":565,"type":612,"title":13,"component":613},"b64992bc-6d53-48b8-b7a0-d81e5a062e50",{"type":324,"content":566},[567],{"type":327,"content":568},[569,571,578,580,582,583,588,590,595,603,605,610],{"text":570,"type":332},"We are ",{"text":572,"type":332,"marks":573},"Foxy.io",[574],{"type":492,"attrs":575},{"href":576,"uuid":59,"anchor":59,"custom":577,"target":59,"linktype":31},"http:\u002F\u002FFoxy.io",{},{"text":579,"type":332},", an ecommerce platform powering ecommerce for other merchants. We do not sell products, and are unable to assist with questions about order statuses or refunds for any merchants using our platform. Please contact the merchant you ordered from for assistance. If you’d like to report a store using Foxy for fraudulent practices, please select ‘other’ in the subject.",{"type":581},"hard_break",{"type":581},{"text":584,"type":332,"marks":585},"NOTE:",[586],{"type":587},"bold",{"text":589,"type":332}," We are ",{"text":591,"type":332,"marks":592},"not ",[593],{"type":594},"italic",{"text":596,"type":332,"marks":597},"Foxy.in",[598,602],{"type":492,"attrs":599},{"href":600,"uuid":59,"anchor":59,"custom":601,"target":59,"linktype":31},"http:\u002F\u002FFoxy.in",{},{"type":594},{"text":604,"type":332},". We are not in any way affiliated with ",{"text":596,"type":332,"marks":606},[607],{"type":492,"attrs":608},{"href":600,"uuid":59,"anchor":59,"custom":609,"target":59,"linktype":31},{},{"text":611,"type":332},", and cannot help in any way with your order from that website.","danger","global___alert","form___condition",{"_uid":616,"equals":617,"fields":618,"component":614},"8765c3e1-25cf-44aa-b8ea-fc6094acf9c3","Presales",[619],{"_uid":620,"name":621,"type":622,"label":13,"options":13,"required":24,"component":547,"conditions":623,"placeholder":13,"default_value":624},"cf464f8e-d643-4f6e-af29-d3abffaf7380","department_email_address","hidden",[],"hello@foxy.io",{"_uid":626,"equals":208,"fields":627,"component":614},"4007b6d8-77e5-421d-bd1e-6f336dd853fb",[628],{"_uid":629,"name":621,"type":622,"label":13,"options":13,"required":24,"component":547,"conditions":630,"placeholder":13,"default_value":631},"7b4c6aa5-a68c-45e0-9ce1-0a36af10c0c2",[],"help@foxy.io",{"_uid":633,"equals":634,"fields":635,"component":614},"1dbb8f11-613d-43cd-9e09-1b94f6e19219","Billing",[636],{"_uid":637,"name":621,"type":622,"label":13,"options":13,"required":24,"component":547,"conditions":638,"placeholder":13,"default_value":639},"a0ac0d1b-bc4f-4a6c-a682-581d450b0b73",[],"help+billing@foxy.io",{"_uid":641,"equals":642,"fields":643,"component":614},"a0a53a50-7172-4a29-ba58-181e38874e12","Partnerships",[644],{"_uid":645,"name":621,"type":622,"label":13,"options":13,"required":24,"component":547,"conditions":646,"placeholder":13,"default_value":647},"7aa011d9-f374-4aed-b5a5-929b54aaf152",[],"partners@foxy.io",{"_uid":649,"equals":561,"fields":650,"component":614},"a4cd431f-25d5-41c7-bfdc-02c908c8fb47",[651],{"_uid":652,"name":621,"type":622,"label":13,"options":13,"required":24,"component":547,"conditions":653,"placeholder":13,"default_value":624},"f5d52168-d6ae-451b-94ee-2ced1cbd28ad",[],{"_uid":655,"equals":656,"fields":657,"component":614},"25aba1ed-eb41-4bbc-aa89-f7a7167ea86e","Other",[658],{"_uid":659,"name":621,"type":622,"label":13,"options":13,"required":24,"component":547,"conditions":660,"placeholder":13,"default_value":624},"f40dfaef-c203-4b71-bf4e-e1b43cef192b",[],{"_uid":662,"component":663},"e9c53a05-f40a-4510-aaf8-bc072a235a0c","form___subject",{"_uid":665,"name":666,"type":667,"label":668,"options":13,"required":33,"component":547,"placeholder":13},"a4c4d385-fff4-4978-99fb-b68cfea623d6","message","textarea","Message",{"_uid":670,"name":671,"type":555,"label":672,"options":673,"required":33,"component":547,"conditions":674,"placeholder":13},"8a3c9f85-f438-427d-9c7a-d7b295a14b5b","existing_user","Are you an existing user?","No, Yes",[675],{"_uid":676,"equals":677,"fields":678,"component":614},"115933d6-262a-4b59-8fa8-579c5ad73de1","Yes",[679],{"_uid":680,"name":681,"type":332,"label":682,"options":13,"required":33,"component":547,"conditions":683,"placeholder":13},"44b6ff23-98f0-4e95-b7f5-c23e06415c2d","subdomain","Store Subdomain",[],{"_uid":685,"name":686,"type":555,"label":687,"options":688,"required":33,"component":547,"conditions":689,"placeholder":13},"922a5cef-3af2-4113-8855-36c7910e3ee3","user_type","What type of user are you?","Developer, Designer, Merchant",[],"POST",[692],{"_uid":693,"text":694,"title":703,"component":704},"7323b90d-a93a-4bf1-baa9-20d0b7ead61b",{"type":324,"content":695},[696],{"type":327,"content":697},[698,700,701],{"text":699,"type":332},"855.369.9227",{"type":581},{"text":702,"type":332},"9:30am-6pm Central M-F","Pre-sales, Sales, & Partnerships","contact___footer_column",{"type":324,"content":706},[707],{"type":327,"content":708},[709],{"text":710,"type":332},"Get in touch to get help from our friendly support team.","Submit","Success!","Your email has been received. We'll get back to you as soon as we can, but it might take a business day. If you don't hear back from us in a timely manner, please check your spam folder to ensure our reply didn't go there.",-80,[],"2fd9fb7d-a48a-4184-acfd-30022d8d6f08","2022-09-23T20:10:45.360Z",[],[288,720,748],{"name":721,"created_at":722,"published_at":723,"updated_at":724,"id":725,"uuid":726,"content":727,"slug":741,"full_slug":742,"sort_by_date":59,"position":743,"tag_list":744,"is_startpage":24,"parent_id":310,"meta_data":59,"group_id":745,"first_published_at":746,"release_id":59,"lang":65,"path":59,"alternates":747,"default_full_slug":59,"translated_slugs":59},"Payments","2025-05-19T15:01:39.297Z","2025-10-15T00:38:24.356Z","2025-10-15T00:38:24.365Z",34027808,"7093e179-f73f-4533-a5ed-230e211e3724",{"_uid":728,"icon":729,"name":721,"type":730,"pinned":24,"summary":731,"category":13,"component":297,"blog_posts":732,"icon_custom":733,"case_studies":735,"faq_sections":736,"featured_guides":737,"mailbox_category":13,"featured_articles":738,"featured_blog_posts":739,"featured_case_studies":740},"d71d645d-26db-4d04-950c-5be6f945b883","fa-cash-register","simple","Manage payment methods, settings, and other payment related options.",[],{"id":59,"alt":59,"name":13,"focus":59,"title":59,"source":59,"filename":13,"copyright":59,"fieldtype":81,"meta_data":734},{},[],[],[],[],[],[],"payments","help\u002Fcategories\u002Fpayments",-100,[],"76057f91-3ad5-43ee-8674-7d3562faf5eb","2025-05-23T19:23:05.066Z",[],{"name":749,"created_at":750,"published_at":751,"updated_at":752,"id":753,"uuid":506,"content":754,"slug":766,"full_slug":767,"sort_by_date":59,"position":768,"tag_list":769,"is_startpage":24,"parent_id":310,"meta_data":59,"group_id":770,"first_published_at":751,"release_id":59,"lang":65,"path":59,"alternates":771,"default_full_slug":59,"translated_slugs":59},"Gift Cards","2026-07-17T01:10:17.566Z","2026-07-17T01:12:23.560Z","2026-07-17T01:12:23.569Z",198905928007319,{"_uid":755,"icon":13,"name":749,"type":730,"pinned":24,"summary":756,"category":726,"component":297,"blog_posts":757,"icon_custom":758,"case_studies":760,"faq_sections":761,"featured_guides":762,"mailbox_category":13,"featured_articles":763,"featured_blog_posts":764,"featured_case_studies":765},"7d35b9eb-8045-477f-bd12-fd6cc693941b","Sell, create, and manage gift cards in Foxy, including customer purchases, balances, and API setup.",[],{"id":59,"alt":59,"name":13,"focus":59,"title":59,"source":59,"filename":13,"copyright":59,"fieldtype":81,"meta_data":759},{},[],[],[],[],[],[],"gift-cards","help\u002Fcategories\u002Fgift-cards",-680,[],"719ff665-efe6-4cdc-8881-8cb142592762",[],{},1784253391470]