[{"data":1,"prerenderedAt":747},["ShallowReactive",2],{"header:help":3,"footer:default":67,"story:navigation\u002Fsearch:help":250,"story:help\u002Fcategories":288,"story:help\u002Farticles\u002Fset-up-a-custom-tax-endpoint":314,"no-guide:set-up-a-custom-tax-endpoint":59,"article:\u002Fhelp\u002Farticles\u002Fset-up-a-custom-tax-endpoint":489,"story:contact":505,"help:tree:6552c60a-9de0-4e28-9e82-16a4732c3fbb":693,"_apollo:default":746},{"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":481,"full_slug":482,"sort_by_date":59,"position":483,"tag_list":484,"is_startpage":24,"parent_id":485,"meta_data":59,"group_id":486,"first_published_at":487,"release_id":59,"lang":65,"path":59,"alternates":488,"default_full_slug":59,"translated_slugs":59},"Set up a Custom Tax Endpoint","2026-07-06T19:35:21.326Z","2026-07-06T20:33:27.854Z","2026-07-06T20:33:27.873Z",195284669811277,"6552c60a-9de0-4e28-9e82-16a4732c3fbb",{"_uid":322,"body":323,"name":315,"image":476,"pinned":24,"summary":478,"category":479,"component":266,"related_articles":480},"502cca77-1878-4b6c-a248-938d33bd61e4",{"type":324,"content":325},"doc",[326,334,340,345,359,364,459,464],{"type":327,"attrs":328,"content":330},"heading",{"level":329,"textAlign":59},2,[331],{"text":332,"type":333},"Overview","text",{"type":335,"attrs":336,"content":337},"paragraph",{"textAlign":59},[338],{"text":339,"type":333},"If you have specific tax requirements or use a system Foxy does not support natively, you can use a custom tax endpoint. It works like the custom shipping endpoint: Foxy sends a payload to your endpoint, and your endpoint returns the tax to apply. Common cases include pulling rates from an ERP or applying highly specific rates or thresholds.",{"type":327,"attrs":341,"content":342},{"level":329,"textAlign":59},[343],{"text":344,"type":333},"How it works",{"type":335,"attrs":346,"content":347},{"textAlign":59},[348,350,357],{"text":349,"type":333},"Foxy sends a payload (mirroring the API format) to your endpoint for each relevant event, and your endpoint responds with the tax to apply. The events and the response format are documented in ",{"text":351,"type":333,"marks":352},"Custom tax endpoint reference",[353],{"type":354,"attrs":355},"link",{"href":356,"uuid":59,"anchor":59,"target":59,"linktype":31},"https:\u002F\u002Ffoxy.io\u002Fhelp\u002Farticles\u002Fcustom-tax-endpoint-reference",{"text":358,"type":333},".",{"type":327,"attrs":360,"content":361},{"level":329,"textAlign":59},[362],{"text":363,"type":333},"Steps",{"type":365,"attrs":366,"content":368},"ordered_list",{"order":367},1,[369,377,416,452],{"type":370,"content":371},"list_item",[372],{"type":335,"attrs":373,"content":374},{"textAlign":59},[375],{"text":376,"type":333},"Deploy an endpoint that accepts Foxy's request and returns a valid response. Foxy provides a starter function (see below).",{"type":370,"content":378},[379],{"type":335,"attrs":380,"content":381},{"textAlign":59},[382,384,390,392,397,399,403,405,409,411,415],{"text":383,"type":333},"Go to the ",{"text":385,"type":333,"marks":386},"Foxy admin",[387],{"type":354,"attrs":388},{"href":389,"uuid":59,"anchor":59,"target":59,"linktype":31},"https:\u002F\u002Fadmin.foxy.io",{"text":391,"type":333},", go to ",{"text":393,"type":333,"marks":394},"Settings > Integrations",[395],{"type":396},"bold",{"text":398,"type":333},", and add a new integration with ",{"text":400,"type":333,"marks":401},"Provider",[402],{"type":396},{"text":404,"type":333}," set to ",{"text":406,"type":333,"marks":407},"Custom Tax Endpoint",[408],{"type":396},{"text":410,"type":333},". Enter your endpoint URL, then click ",{"text":412,"type":333,"marks":413},"Create",[414],{"type":396},{"text":358,"type":333},{"type":370,"content":417},[418],{"type":335,"attrs":419,"content":420},{"textAlign":59},[421,423,427,429,433,435,439,441,445,447,450],{"text":422,"type":333},"Go to ",{"text":424,"type":333,"marks":425},"Settings > Taxes",[426],{"type":396},{"text":428,"type":333}," and add a new tax. Enter a ",{"text":430,"type":333,"marks":431},"Name",[432],{"type":396},{"text":434,"type":333},", set the ",{"text":436,"type":333,"marks":437},"Type",[438],{"type":396},{"text":440,"type":333}," to ",{"text":442,"type":333,"marks":443},"Custom tax endpoint",[444],{"type":396},{"text":446,"type":333},", and click ",{"text":412,"type":333,"marks":448},[449],{"type":396},{"text":451,"type":333},". Only the name and type are needed; the other fields are set automatically.",{"type":370,"content":453},[454],{"type":335,"attrs":455,"content":456},{"textAlign":59},[457],{"text":458,"type":333},"Apply the tax to your categories.",{"type":327,"attrs":460,"content":461},{"level":329,"textAlign":59},[462],{"text":463,"type":333},"Starter code",{"type":335,"attrs":465,"content":466},{"textAlign":59},[467,469,474],{"text":468,"type":333},"Foxy provides a Netlify function code to help you get started. With a Netlify account, follow the readme in Foxy's Netlify functions repository (",{"text":470,"type":333,"marks":471},"https:\u002F\u002Fgithub.com\u002FFoxy\u002Ffoxy-node-netlify-functions",[472],{"type":473},"code",{"text":475,"type":333},") to deploy the example custom tax function and tailor it to your needs.",{"id":59,"alt":59,"name":13,"focus":59,"title":59,"source":59,"filename":13,"copyright":59,"fieldtype":81,"meta_data":477},{}," How to use a custom tax endpoint to calculate taxes with your own system, including the Netlify starter function code.","d8395b12-d86d-4c10-b9a0-1f2d3b100f1a",[],"set-up-a-custom-tax-endpoint","help\u002Farticles\u002Fset-up-a-custom-tax-endpoint",-3010,[],2659,"328ff19e-0b8b-44b9-af27-7c3bdcaa6505","2026-07-06T20:06:04.258Z",[],{"html":490,"sections":491,"segments":501},"\u003Csection id=\"overview\" data-title=\"Overview\" data-title-node=\"H2\">\u003Chr class=\"my-8\" style=\"margin-left: -48px; margin-right: -40vw\">\u003Ch2 data-anchor-id=\"overview\">Overview\u003C\u002Fh2>\u003Cp>If you have specific tax requirements or use a system Foxy does not support natively, you can use a custom tax endpoint. It works like the custom shipping endpoint: Foxy sends a payload to your endpoint, and your endpoint returns the tax to apply. Common cases include pulling rates from an ERP or applying highly specific rates or thresholds.\u003C\u002Fp>\u003C\u002Fsection>\u003Csection id=\"how-it-works\" data-title=\"How it works\" data-title-node=\"H2\">\u003Chr class=\"my-8\" style=\"margin-left: -48px; margin-right: -40vw\">\u003Ch2 data-anchor-id=\"how-it-works\">How it works\u003C\u002Fh2>\u003Cp>Foxy sends a payload (mirroring the API format) to your endpoint for each relevant event, and your endpoint responds with the tax to apply. The events and the response format are documented in \u003Ca href=\"https:\u002F\u002Ffoxy.io\u002Fhelp\u002Farticles\u002Fcustom-tax-endpoint-reference\" class=\"\">Custom tax endpoint reference\u003C\u002Fa>.\u003C\u002Fp>\u003C\u002Fsection>\u003Csection id=\"steps\" data-title=\"Steps\" data-title-node=\"H2\">\u003Chr class=\"my-8\" style=\"margin-left: -48px; margin-right: -40vw\">\u003Ch2 data-anchor-id=\"steps\">Steps\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>Deploy an endpoint that accepts Foxy's request and returns a valid response. Foxy provides a starter function (see below).\u003C\u002Fp>\u003C\u002Fdiv>\u003C\u002Fdiv>\u003C\u002Fdiv>\u003C\u002Fli>\u003Cli class=\"step-item\">\u003Cdiv class=\"step-content-wrapper\">\u003Cspan class=\"step-icon step-icon-soft-primary\">2\u003C\u002Fspan>\u003Cdiv class=\"w-100 overflow-hidden\">\u003Cdiv class=\"step-content mt-2\">\u003Cp>Go to the \u003Ca href=\"https:\u002F\u002Fadmin.foxy.io\" class=\"\">Foxy admin\u003C\u002Fa>, go to \u003Cstrong>Settings > Integrations\u003C\u002Fstrong>, and add a new integration with \u003Cstrong>Provider\u003C\u002Fstrong> set to \u003Cstrong>Custom Tax Endpoint\u003C\u002Fstrong>. Enter your endpoint URL, then click \u003Cstrong>Create\u003C\u002Fstrong>.\u003C\u002Fp>\u003C\u002Fdiv>\u003C\u002Fdiv>\u003C\u002Fdiv>\u003C\u002Fli>\u003Cli class=\"step-item\">\u003Cdiv class=\"step-content-wrapper\">\u003Cspan class=\"step-icon step-icon-soft-primary\">3\u003C\u002Fspan>\u003Cdiv class=\"w-100 overflow-hidden\">\u003Cdiv class=\"step-content mt-2\">\u003Cp>Go to \u003Cstrong>Settings > Taxes\u003C\u002Fstrong> and add a new tax. Enter a \u003Cstrong>Name\u003C\u002Fstrong>, set the \u003Cstrong>Type\u003C\u002Fstrong> to \u003Cstrong>Custom tax endpoint\u003C\u002Fstrong>, and click \u003Cstrong>Create\u003C\u002Fstrong>. Only the name and type are needed; the other fields are set automatically.\u003C\u002Fp>\u003C\u002Fdiv>\u003C\u002Fdiv>\u003C\u002Fdiv>\u003C\u002Fli>\u003Cli class=\"step-item\">\u003Cdiv class=\"step-content-wrapper\">\u003Cspan class=\"step-icon step-icon-soft-primary\">4\u003C\u002Fspan>\u003Cdiv class=\"w-100 overflow-hidden\">\u003Cdiv class=\"step-content mt-2\">\u003Cp>Apply the tax to your categories.\u003C\u002Fp>\u003C\u002Fdiv>\u003C\u002Fdiv>\u003C\u002Fdiv>\u003C\u002Fli>\u003C\u002Fol>\u003C\u002Fsection>\u003Csection id=\"starter-code\" data-title=\"Starter code\" data-title-node=\"H2\">\u003Chr class=\"my-8\" style=\"margin-left: -48px; margin-right: -40vw\">\u003Ch2 data-anchor-id=\"starter-code\">Starter code\u003C\u002Fh2>\u003Cp>Foxy provides a Netlify function code to help you get started. With a Netlify account, follow the readme in Foxy's Netlify functions repository (\u003Ccode class=\"badge bg-soft-danger text-danger\">https:\u002F\u002Fgithub.com\u002FFoxy\u002Ffoxy-node-netlify-functions\u003C\u002Fcode>) to deploy the example custom tax function and tailor it to your needs.\u003C\u002Fp>\u003C\u002Fsection>",[492,495,497,499],{"id":493,"title":332,"level":494},"overview","H2",{"id":496,"title":344,"level":494},"how-it-works",{"id":498,"title":363,"level":494},"steps",{"id":500,"title":463,"level":494},"starter-code",[502],{"type":503,"content":504},"html","\u003Ch2>Overview\u003C\u002Fh2>\u003Cp>If you have specific tax requirements or use a system Foxy does not support natively, you can use a custom tax endpoint. It works like the custom shipping endpoint: Foxy sends a payload to your endpoint, and your endpoint returns the tax to apply. Common cases include pulling rates from an ERP or applying highly specific rates or thresholds.\u003C\u002Fp>\u003Ch2>How it works\u003C\u002Fh2>\u003Cp>Foxy sends a payload (mirroring the API format) to your endpoint for each relevant event, and your endpoint responds with the tax to apply. The events and the response format are documented in \u003Ca href=\"https:\u002F\u002Ffoxy.io\u002Fhelp\u002Farticles\u002Fcustom-tax-endpoint-reference\" class=\"\">Custom tax endpoint reference\u003C\u002Fa>.\u003C\u002Fp>\u003Ch2>Steps\u003C\u002Fh2>\u003Col order=\"1\">\u003Cli>\u003Cp>Deploy an endpoint that accepts Foxy's request and returns a valid response. Foxy provides a starter function (see below).\u003C\u002Fp>\u003C\u002Fli>\u003Cli>\u003Cp>Go to the \u003Ca href=\"https:\u002F\u002Fadmin.foxy.io\" class=\"\">Foxy admin\u003C\u002Fa>, go to \u003Cstrong>Settings > Integrations\u003C\u002Fstrong>, and add a new integration with \u003Cstrong>Provider\u003C\u002Fstrong> set to \u003Cstrong>Custom Tax Endpoint\u003C\u002Fstrong>. Enter your endpoint URL, then click \u003Cstrong>Create\u003C\u002Fstrong>.\u003C\u002Fp>\u003C\u002Fli>\u003Cli>\u003Cp>Go to \u003Cstrong>Settings > Taxes\u003C\u002Fstrong> and add a new tax. Enter a \u003Cstrong>Name\u003C\u002Fstrong>, set the \u003Cstrong>Type\u003C\u002Fstrong> to \u003Cstrong>Custom tax endpoint\u003C\u002Fstrong>, and click \u003Cstrong>Create\u003C\u002Fstrong>. Only the name and type are needed; the other fields are set automatically.\u003C\u002Fp>\u003C\u002Fli>\u003Cli>\u003Cp>Apply the tax to your categories.\u003C\u002Fp>\u003C\u002Fli>\u003C\u002Fol>\u003Ch2>Starter code\u003C\u002Fh2>\u003Cp>Foxy provides a Netlify function code to help you get started. With a Netlify account, follow the readme in Foxy's Netlify functions repository (\u003Ccode class=\"badge bg-soft-danger text-danger\">https:\u002F\u002Fgithub.com\u002FFoxy\u002Ffoxy-node-netlify-functions\u003C\u002Fcode>) to deploy the example custom tax function and tailor it to your needs.\u003C\u002Fp>",{"name":506,"created_at":507,"published_at":508,"updated_at":509,"id":510,"uuid":47,"content":511,"slug":48,"full_slug":48,"sort_by_date":59,"position":688,"tag_list":689,"is_startpage":24,"parent_id":59,"meta_data":59,"group_id":690,"first_published_at":691,"release_id":59,"lang":65,"path":59,"alternates":692,"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":512,"_uid":515,"title":516,"action":517,"fields":518,"method":664,"columns":665,"subtitle":679,"component":48,"button_text":685,"submit_title":686,"submit_subtitle":687},{"_uid":513,"title":506,"plugin":514,"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",[519,523,527,635,638,643,658],{"_uid":520,"name":521,"type":333,"label":430,"options":13,"required":33,"component":522,"placeholder":13},"9a70b226-2036-4f90-a052-b3efa61c5896","name","form___field",{"_uid":524,"name":525,"type":525,"label":526,"options":13,"required":33,"component":522,"placeholder":13},"86ba35be-ff43-4a28-8633-14052a8f6622","email","Email Address",{"_uid":528,"name":529,"type":530,"label":531,"options":532,"required":33,"component":522,"conditions":533,"placeholder":13},"3f827475-492c-4f97-aa1e-2386ac263b6c","topic","select","Topic","Presales, Support, Billing, Partnerships, Order Enquiry, Other",[534,589,599,606,614,622,628],{"_uid":535,"equals":536,"fields":537,"component":588},"e21d97dd-e68e-4fa6-ba97-bc40f3041dde","Order Enquiry",[538],{"_uid":539,"body":540,"type":586,"title":13,"component":587},"b64992bc-6d53-48b8-b7a0-d81e5a062e50",{"type":324,"content":541},[542],{"type":335,"content":543},[544,546,553,555,557,558,562,564,569,577,579,584],{"text":545,"type":333},"We are ",{"text":547,"type":333,"marks":548},"Foxy.io",[549],{"type":354,"attrs":550},{"href":551,"uuid":59,"anchor":59,"custom":552,"target":59,"linktype":31},"http:\u002F\u002FFoxy.io",{},{"text":554,"type":333},", 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":556},"hard_break",{"type":556},{"text":559,"type":333,"marks":560},"NOTE:",[561],{"type":396},{"text":563,"type":333}," We are ",{"text":565,"type":333,"marks":566},"not ",[567],{"type":568},"italic",{"text":570,"type":333,"marks":571},"Foxy.in",[572,576],{"type":354,"attrs":573},{"href":574,"uuid":59,"anchor":59,"custom":575,"target":59,"linktype":31},"http:\u002F\u002FFoxy.in",{},{"type":568},{"text":578,"type":333},". We are not in any way affiliated with ",{"text":570,"type":333,"marks":580},[581],{"type":354,"attrs":582},{"href":574,"uuid":59,"anchor":59,"custom":583,"target":59,"linktype":31},{},{"text":585,"type":333},", and cannot help in any way with your order from that website.","danger","global___alert","form___condition",{"_uid":590,"equals":591,"fields":592,"component":588},"8765c3e1-25cf-44aa-b8ea-fc6094acf9c3","Presales",[593],{"_uid":594,"name":595,"type":596,"label":13,"options":13,"required":24,"component":522,"conditions":597,"placeholder":13,"default_value":598},"cf464f8e-d643-4f6e-af29-d3abffaf7380","department_email_address","hidden",[],"hello@foxy.io",{"_uid":600,"equals":208,"fields":601,"component":588},"4007b6d8-77e5-421d-bd1e-6f336dd853fb",[602],{"_uid":603,"name":595,"type":596,"label":13,"options":13,"required":24,"component":522,"conditions":604,"placeholder":13,"default_value":605},"7b4c6aa5-a68c-45e0-9ce1-0a36af10c0c2",[],"help@foxy.io",{"_uid":607,"equals":608,"fields":609,"component":588},"1dbb8f11-613d-43cd-9e09-1b94f6e19219","Billing",[610],{"_uid":611,"name":595,"type":596,"label":13,"options":13,"required":24,"component":522,"conditions":612,"placeholder":13,"default_value":613},"a0ac0d1b-bc4f-4a6c-a682-581d450b0b73",[],"help+billing@foxy.io",{"_uid":615,"equals":616,"fields":617,"component":588},"a0a53a50-7172-4a29-ba58-181e38874e12","Partnerships",[618],{"_uid":619,"name":595,"type":596,"label":13,"options":13,"required":24,"component":522,"conditions":620,"placeholder":13,"default_value":621},"7aa011d9-f374-4aed-b5a5-929b54aaf152",[],"partners@foxy.io",{"_uid":623,"equals":536,"fields":624,"component":588},"a4cd431f-25d5-41c7-bfdc-02c908c8fb47",[625],{"_uid":626,"name":595,"type":596,"label":13,"options":13,"required":24,"component":522,"conditions":627,"placeholder":13,"default_value":598},"f5d52168-d6ae-451b-94ee-2ced1cbd28ad",[],{"_uid":629,"equals":630,"fields":631,"component":588},"25aba1ed-eb41-4bbc-aa89-f7a7167ea86e","Other",[632],{"_uid":633,"name":595,"type":596,"label":13,"options":13,"required":24,"component":522,"conditions":634,"placeholder":13,"default_value":598},"f40dfaef-c203-4b71-bf4e-e1b43cef192b",[],{"_uid":636,"component":637},"e9c53a05-f40a-4510-aaf8-bc072a235a0c","form___subject",{"_uid":639,"name":640,"type":641,"label":642,"options":13,"required":33,"component":522,"placeholder":13},"a4c4d385-fff4-4978-99fb-b68cfea623d6","message","textarea","Message",{"_uid":644,"name":645,"type":530,"label":646,"options":647,"required":33,"component":522,"conditions":648,"placeholder":13},"8a3c9f85-f438-427d-9c7a-d7b295a14b5b","existing_user","Are you an existing user?","No, Yes",[649],{"_uid":650,"equals":651,"fields":652,"component":588},"115933d6-262a-4b59-8fa8-579c5ad73de1","Yes",[653],{"_uid":654,"name":655,"type":333,"label":656,"options":13,"required":33,"component":522,"conditions":657,"placeholder":13},"44b6ff23-98f0-4e95-b7f5-c23e06415c2d","subdomain","Store Subdomain",[],{"_uid":659,"name":660,"type":530,"label":661,"options":662,"required":33,"component":522,"conditions":663,"placeholder":13},"922a5cef-3af2-4113-8855-36c7910e3ee3","user_type","What type of user are you?","Developer, Designer, Merchant",[],"POST",[666],{"_uid":667,"text":668,"title":677,"component":678},"7323b90d-a93a-4bf1-baa9-20d0b7ead61b",{"type":324,"content":669},[670],{"type":335,"content":671},[672,674,675],{"text":673,"type":333},"855.369.9227",{"type":556},{"text":676,"type":333},"9:30am-6pm Central M-F","Pre-sales, Sales, & Partnerships","contact___footer_column",{"type":324,"content":680},[681],{"type":335,"content":682},[683],{"text":684,"type":333},"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,694,721],{"name":695,"created_at":696,"published_at":697,"updated_at":698,"id":699,"uuid":700,"content":701,"slug":715,"full_slug":716,"sort_by_date":59,"position":717,"tag_list":718,"is_startpage":24,"parent_id":310,"meta_data":59,"group_id":719,"first_published_at":697,"release_id":59,"lang":65,"path":59,"alternates":720,"default_full_slug":59,"translated_slugs":59},"Taxes","2023-01-19T16:29:41.539Z","2023-01-19T17:25:33.664Z","2023-01-19T17:25:33.710Z",28247,"1cc94adb-9972-46de-8012-0b747fec3c12",{"_uid":702,"icon":703,"name":695,"guides":704,"summary":705,"category":13,"component":297,"blog_posts":706,"content_hub":24,"icon_custom":707,"case_studies":708,"faq_sections":709,"help_articles":710,"featured_guides":711,"mailbox_category":13,"featured_articles":712,"featured_blog_posts":713,"featured_case_studies":714},"b4d76fc5-7554-4419-af57-edc9b654cecb","fa-university",[],"How taxes work in Foxy.",[],{"id":59,"alt":59,"name":13,"focus":59,"title":59,"filename":13,"copyright":59,"fieldtype":81},[],[],[],[],[],[],[],"taxes","help\u002Fcategories\u002Ftaxes",80,[],"399e677b-f067-4896-bba6-444419d3ff29",[],{"name":406,"created_at":722,"published_at":723,"updated_at":724,"id":725,"uuid":479,"content":726,"slug":739,"full_slug":740,"sort_by_date":59,"position":741,"tag_list":742,"is_startpage":24,"parent_id":310,"meta_data":59,"group_id":743,"first_published_at":744,"release_id":59,"lang":65,"path":59,"alternates":745,"default_full_slug":59,"translated_slugs":59},"2026-07-02T19:49:54.905Z","2026-07-06T21:04:27.011Z","2026-07-06T21:04:27.025Z",193872670377211,{"_uid":727,"icon":13,"name":406,"type":728,"pinned":24,"summary":729,"category":700,"component":297,"blog_posts":730,"icon_custom":731,"case_studies":733,"faq_sections":734,"featured_guides":735,"mailbox_category":13,"featured_articles":736,"featured_blog_posts":737,"featured_case_studies":738},"d5af9d6e-524e-4dc0-b859-c86a775f95ce","simple","Calculate taxes with your own system when Foxy's built-in and third-party options aren't enough.",[],{"id":59,"alt":59,"name":13,"focus":59,"title":59,"source":59,"filename":13,"copyright":59,"fieldtype":81,"meta_data":732},{},[],[],[],[],[],[],"custom-tax-endpoint","help\u002Fcategories\u002Fcustom-tax-endpoint",-560,[],"8f6745ab-2b60-4113-87aa-b5868c1dc472","2026-07-02T19:56:23.536Z",[],{},1783372633611]