Subscribes your app to one topic on the
store the access token belongs to. Every event on that topic is then POSTed
to your callback URL, signed with this subscription’s own secret.
Without the topic’s scope the request is rejected with 403. Apps built
when this endpoint required write_shop for every topic are still allowed
to subscribe with write_shop, but events are only delivered while the
installation holds the topic’s scope — the response then carries a
warnings entry saying so. The scope is checked again on every delivery,
so revoking it stops the data.
A topic from the topic reference that is
subscribable through the API. app/installed and the GDPR topics are not:
declare them in your app manifest instead.
Deliveries to this subscription are signed with its own secret
(see Webhook Verification).
To rotate it, delete the subscription and create it again.
Subscriptions your app creates here are never changed by your manifest:
installing, re-authorising or publishing a new app version only manages
the subscriptions declared in the manifest’s webhooks[].
All of an app’s subscriptions on a store are removed when the merchant
uninstalls the app (after the app/uninstalled delivery).
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"LaunchMyStore Developers","colors":{"primary":"#3B82F6","light":"#60A5FA","dark":"#1E40AF"},"logo":{"light":"https://mintcdn.com/tradefusiontechnologiespvtltd/h0D_voj1Mzg300-x/logo/light.svg?fit=max\u0026auto=format\u0026n=h0D_voj1Mzg300-x\u0026q=85\u0026s=22ebdb2605f91ccf72f71097a82d6928","dark":"https://mintcdn.com/tradefusiontechnologiespvtltd/h0D_voj1Mzg300-x/logo/dark.svg?fit=max\u0026auto=format\u0026n=h0D_voj1Mzg300-x\u0026q=85\u0026s=d0bd7a151fcc8504ff88d67bdf086207"},"favicon":"https://mintcdn.com/tradefusiontechnologiespvtltd/GZ5CeZvKFUHoQpDN/favicon.svg?fit=max\u0026auto=format\u0026n=GZ5CeZvKFUHoQpDN\u0026q=85\u0026s=e74621046b0cb57582fc4ce3b5615df7","api":{"playground":{"display":"interactive"},"mdx":{"auth":{"method":"bearer"},"server":"https://api.launchmystore.io"}},"navbar":{"links":[{"href":"mailto:support@launchmystore.io","label":"Support"}],"primary":{"type":"button","label":"Dashboard","href":"https://app.launchmystore.io"}},"footer":{"socials":{"twitter":"https://twitter.com/launchmystore","github":"https://github.com/launchmystore","linkedin":"https://linkedin.com/company/launchmystore"}},"styling":{"latex":true},"navigation":{"global":{"anchors":[{"anchor":"GitHub","icon":"github","href":"https://github.com/launchmystore"},{"anchor":"Community","icon":"discord","href":"https://discord.gg/launchmystore"},{"anchor":"App Store","icon":"grid-2","href":"https://app.launchmystore.io/marketplace"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"tradefusiontechnologiespvtltd","hasAudioNarration":false,"actualSubdomain":"tradefusiontechnologiespvtltd","customDomains":["docs.launchmystore.io"],"gitSource":{"type":"github","owner":"launchmystore","repo":"lms-docs","deployBranch":"master","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6aea4851511dd8ff90ecfc5b","collectionId":"465d4da9-5526-4822-9ecc-27eaffcbb54c","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6aea4851511dd8ff90ecfc5b"},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6aea4d48038b060126a0ff77","clientVersion":"0.0.4054","searchFilterCounts":[{"language":"default","tag":"API Reference","count":167},{"language":"default","tag":"Documentation","count":66},{"language":"default","tag":"Extensions","count":18},{"language":"default","tag":"Metafields","count":13},{"language":"default","tag":"Theme Development","count":13},{"language":"default","tag":"Functions","count":13},{"language":"default","tag":"Themes","count":11},{"language":"default","tag":"Aqua Basics","count":11},{"language":"default","tag":"Get Started","count":11},{"language":"default","tag":"Blogs","count":10}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/webhooks/create","slug":"/api-reference/webhooks/create","pageMetadata":{"title":"Create Webhook Subscription","api":"POST https://api.launchmystore.io/api/v1/webhooks.json","description":"Subscribe your app to a webhook topic on the installed store","href":"/api-reference/webhooks/create"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Subscribe your app to a webhook topic on the installed store\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,li:`li`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{CodeBlock,CodeGroup,Expandable,Heading,ParamField,ResponseField,Table}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!CodeGroup)_missingMdxReference(`CodeGroup`,true);if(!Expandable)_missingMdxReference(`Expandable`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!ParamField)_missingMdxReference(`ParamField`,true);if(!ResponseField)_missingMdxReference(`ResponseField`,true);if(!Table)_missingMdxReference(`Table`,true);return _jsxs(_Fragment,{children:[_jsx(Heading,{level:`1`,id:`create-webhook-subscription`,children:`Create Webhook Subscription`}),`\n`,_jsxs(_components.p,{children:[`Subscribes your app to one `,_jsx(_components.a,{href:`/api-reference/webhooks/topics`,children:`topic`}),` on the\nstore the access token belongs to. Every event on that topic is then POSTed\nto your callback URL, signed with this subscription’s own secret.`]}),`\n`,_jsx(Heading,{level:`2`,id:`required-scope`,children:`Required scope`}),`\n`,_jsxs(_components.p,{children:[`Subscribing needs the `,_jsx(_components.strong,{children:`read scope of the resource the topic is about`}),` —\nthe same rule Shopify uses. A write scope implies its read scope.`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Topics`}),_jsx(_components.th,{children:`Scope (any one of)`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[_jsx(_components.code,{children:`orders/*`}),`, `,_jsx(_components.code,{children:`refunds/create`}),`, `,_jsx(_components.code,{children:`carts/*`}),`, `,_jsx(_components.code,{children:`checkouts/create`}),`, `,_jsx(_components.code,{children:`subscriptions/*`})]}),_jsx(_components.td,{children:_jsx(_components.code,{children:`read_orders`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`fulfillments/*`})}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`read_fulfillments`}),` or `,_jsx(_components.code,{children:`read_orders`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`products/*`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`read_products`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`collections/*`})}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`read_products`}),` or `,_jsx(_components.code,{children:`read_collections`})]})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[_jsx(_components.code,{children:`customers/*`}),`, `,_jsx(_components.code,{children:`newsletter/create`}),`, `,_jsx(_components.code,{children:`contact_form/create`})]}),_jsx(_components.td,{children:_jsx(_components.code,{children:`read_customers`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`inventory_levels/update`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`read_inventory`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`discounts/*`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`read_discounts`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`blogs/*`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`read_content`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`themes/publish`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`read_themes`})})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[_jsx(_components.code,{children:`shop/update`}),`, `,_jsx(_components.code,{children:`app/uninstalled`}),`, `,_jsx(_components.code,{children:`app_subscriptions/update`})]}),_jsx(_components.td,{children:`none`})]})]})]}),`\n`,_jsxs(_components.p,{children:[`Without the topic’s scope the request is rejected with `,_jsx(_components.code,{children:`403`}),`. Apps built\nwhen this endpoint required `,_jsx(_components.code,{children:`write_shop`}),` for every topic are still allowed\nto subscribe with `,_jsx(_components.code,{children:`write_shop`}),`, but events are only `,_jsx(_components.strong,{children:`delivered`}),` while the\ninstallation holds the topic’s scope — the response then carries a\n`,_jsx(_components.code,{children:`warnings`}),` entry saying so. The scope is checked again on every delivery,\nso revoking it stops the data.`]}),`\n`,_jsx(Heading,{level:`2`,id:`request`,children:`Request`}),`\n`,_jsxs(CodeGroup,{children:[_jsx(CodeBlock,{filename:`cURL`,numberOfLines:`7`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`7`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -X`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` POST`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"https://api.launchmystore.io/api/v1/webhooks.json\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Authorization: Bearer YOUR_ACCESS_TOKEN\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Content-Type: application/json\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -d`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` '{`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"topic\": \"orders/create\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"callbackUrl\": \"https://your-app.com/webhooks/orders\"`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` }'`})}),`\n`]})})}),_jsx(CodeBlock,{filename:`Node.js`,numberOfLines:`13`,language:`javascript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`javascript`,children:_jsxs(_components.code,{language:`javascript`,numberOfLines:`13`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`const`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:` response`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:` await`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:` fetch`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'https://api.launchmystore.io/api/v1/webhooks.json'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` method:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'POST'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` headers:`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'Authorization'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:\" `Bearer \"}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#569CD6`},children:\"${\"}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`accessToken`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#569CD6`},children:`}`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:\"`\"}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'Content-Type'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'application/json'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` },`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` body:`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:` JSON`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`stringify`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`({`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` topic:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'orders/create'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` callbackUrl:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'https://your-app.com/webhooks/orders'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }),`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`});`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`const`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` { `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:`data`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` } `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:` await`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` response`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`json`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`();`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`// Store data.webhook.secret now — it is never shown again.`})}),`\n`]})})})]}),`\n`,_jsxs(_components.p,{children:[`The body may also be wrapped in Shopify’s resource envelope\n(`,_jsx(_components.code,{children:`{ \"webhook\": { \"topic\": ..., \"address\": ... } }`}),`).`]}),`\n`,_jsx(Heading,{level:`2`,id:`body-parameters`,children:`Body Parameters`}),`\n`,_jsx(ParamField,{body:`topic`,type:`string`,required:true,id:`param-topic`,children:_jsxs(_components.p,{children:[`A topic from the `,_jsx(_components.a,{href:`/api-reference/webhooks/topics`,children:`topic reference`}),` that is\nsubscribable through the API. `,_jsx(_components.code,{children:`app/installed`}),` and the GDPR topics are not:\ndeclare them in your app manifest instead.`]})}),`\n`,_jsx(ParamField,{body:`callbackUrl`,type:`string`,required:true,id:`param-callback-url`,children:_jsxs(_components.p,{children:[`Where deliveries are POSTed. `,_jsx(_components.code,{children:`address`}),` (Shopify’s name) is accepted as an\nalias. Must be a public `,_jsx(_components.code,{children:`http`}),`/`,_jsx(_components.code,{children:`https`}),` URL in production; use HTTPS.`]})}),`\n`,_jsx(ParamField,{body:`format`,type:`string`,default:`json`,id:`param-format`,children:_jsxs(_components.p,{children:[`Only `,_jsx(_components.code,{children:`json`}),` is supported — webhook bodies are always JSON.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`response`,children:`Response`}),`\n`,_jsx(ResponseField,{name:`data.webhook`,type:`object`,id:`param-data-webhook`,children:_jsxs(Expandable,{title:`properties`,children:[_jsx(ResponseField,{name:`id`,type:`string`,id:`param-id`,children:`Subscription id — use it to delete the subscription.`}),_jsx(ResponseField,{name:`topic`,type:`string`,id:`param-topic-1`,children:`The subscribed topic.`}),_jsxs(ResponseField,{name:`address`,type:`string`,id:`param-address`,children:[`The callback URL (same as `,_jsx(_components.code,{children:`callbackUrl`}),`).`]}),_jsxs(ResponseField,{name:`format`,type:`string`,id:`param-format-1`,children:[`Always `,_jsx(_components.code,{children:`json`}),`.`]}),_jsxs(ResponseField,{name:`source`,type:`string`,id:`param-source`,children:[_jsx(_components.code,{children:`api`}),` for subscriptions created here.`]}),_jsxs(ResponseField,{name:`secret`,type:`string`,id:`param-secret`,children:[`The HMAC signing secret of this subscription. Returned `,_jsx(_components.strong,{children:`only`}),` in this response.`]}),_jsxs(ResponseField,{name:`isEnabled`,type:`boolean`,id:`param-is-enabled`,children:[`Always `,_jsx(_components.code,{children:`true`}),` on create.`]})]})}),`\n`,_jsx(ResponseField,{name:`data.warnings`,type:`string[]`,id:`param-data-warnings`,children:_jsxs(_components.p,{children:[`Present when the subscription was accepted through the legacy\n`,_jsx(_components.code,{children:`write_shop`}),` rule but the installation lacks the topic’s scope.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`example-response`,children:`Example Response`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`21`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`21`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"status\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`201`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"state\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"success\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"data\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"webhook\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"125fc7e5-8600-4075-a962-368615e78a3b\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"address\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"https://your-app.com/webhooks/orders\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"appWebhookId\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"125fc7e5-8600-4075-a962-368615e78a3b\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"appId\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"3b0f5a2e-…\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"storeId\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"ef10744c-…\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"topic\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"orders/create\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"callbackUrl\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"https://your-app.com/webhooks/orders\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"isEnabled\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`true`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"format\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"json\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"source\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"api\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"secret\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"9f2c…64 hex characters…\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"createdAt\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2026-09-27T10:48:12.000Z\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"updatedAt\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2026-09-27T10:48:12.000Z\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsx(Heading,{level:`2`,id:`errors`,children:`Errors`}),`\n`,_jsxs(_components.p,{children:[`Errors use the standard `,_jsx(_components.code,{children:`{ errors }`}),` body.`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Status`}),_jsx(_components.th,{children:`When`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`400`})}),_jsx(_components.td,{children:`The same topic and URL are already subscribed, or the URL is not an acceptable public URL.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`403`})}),_jsx(_components.td,{children:`The installation lacks the topic’s scope. The message names the scope.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`422`})}),_jsxs(_components.td,{children:[`Unknown or non-subscribable topic, or a `,_jsx(_components.code,{children:`format`}),` other than `,_jsx(_components.code,{children:`json`}),`.`]})]})]})]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`5`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`5`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"errors\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"base\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Subscribing to discounts/create requires the read_discounts scope\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`]`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsx(Heading,{level:`2`,id:`notes`,children:`Notes`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`Deliveries to this subscription are signed with its own `,_jsx(_components.code,{children:`secret`}),`\n(see `,_jsx(_components.a,{href:`/api-reference/webhooks/verification`,children:`Webhook Verification`}),`).\nTo rotate it, delete the subscription and create it again.`]}),`\n`,_jsxs(_components.li,{children:[`Subscriptions your app creates here are never changed by your manifest:\ninstalling, re-authorising or publishing a new app version only manages\nthe subscriptions declared in the manifest’s `,_jsx(_components.code,{children:`webhooks[]`}),`.`]}),`\n`,_jsxs(_components.li,{children:[`All of an app’s subscriptions on a store are removed when the merchant\nuninstalls the app (after the `,_jsx(_components.code,{children:`app/uninstalled`}),` delivery).`]}),`\n`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Create Webhook Subscription","api":"POST https://api.launchmystore.io/api/v1/webhooks.json","description":"Subscribe your app to a webhook topic on the installed store","href":"/api-reference/webhooks/create"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Create Webhook Subscription","slug":"create-webhook-subscription","depth":1,"children":[]},{"title":"Required scope","slug":"required-scope","depth":2,"children":[]},{"title":"Request","slug":"request","depth":2,"children":[]},{"title":"Body Parameters","slug":"body-parameters","depth":2,"children":[]},{"title":"Response","slug":"response","depth":2,"children":[]},{"title":"Example Response","slug":"example-response","depth":2,"children":[]},{"title":"Errors","slug":"errors","depth":2,"children":[]},{"title":"Notes","slug":"notes","depth":2,"children":[]}],"codeExamples":{},"endpoint":{"title":"Create Webhook Subscription","path":"/api/v1/webhooks.json","servers":[{"url":"https://api.launchmystore.io"}],"method":"post","request":{"security":[{"title":"Bearer Auth","parameters":{"header":{"Authorization":{"type":"http","scheme":"bearer","description":"Bearer authentication header of the form `Bearer \u003ctoken>`, where `\u003ctoken>` is your auth token."}},"query":{},"cookie":{}}}],"parameters":{"query":{},"header":{},"cookie":{},"path":{}},"body":{"application/json":{"schemaArray":[{"type":"object","properties":{"topic":[{"type":"string","description":"A topic from the topic reference that is subscribable through the API. `app/installed` and the GDPR topics are not: declare them in your app manifest instead.","required":true}],"callbackUrl":[{"type":"string","description":"Where deliveries are POSTed. `address` (Shopify’s name) is accepted as an alias. Must be a public `http` / `https` URL in production; use HTTPS.","required":true}],"format":[{"type":"string","description":"Only `json` is supported — webhook bodies are always JSON."}]}}],"examples":{"example":{"value":{"topic":"\u003cstring>","callbackUrl":"\u003cstring>","format":"\u003cstring>"}}}}}},"response":{"200":{"application/json":{"schemaArray":[{"type":"object","properties":{"data.webhook":[{"type":"object","properties":{"id":[{"type":"string","description":"Subscription id — use it to delete the subscription."}],"topic":[{"type":"string","description":"The subscribed topic."}],"address":[{"type":"string","description":"The callback URL (same as `callbackUrl` )."}],"format":[{"type":"string","description":"Always `json` ."}],"source":[{"type":"string","description":"`api` for subscriptions created here."}],"secret":[{"type":"string","description":"The HMAC signing secret of this subscription. Returned only in this response."}],"isEnabled":[{"type":"boolean","description":"Always `true` on create."}]}}],"data.warnings":[{"type":"array","items":[{"type":"string"}],"description":"Present when the subscription was accepted through the legacy `write_shop` rule but the installation lacks the topic’s scope."}]}}],"examples":{"example":{"value":{"data.webhook":{"id":"\u003cstring>","topic":"\u003cstring>","address":"\u003cstring>","format":"\u003cstring>","source":"\u003cstring>","secret":"\u003cstring>","isEnabled":true},"data.warnings":["\u003cstring>"]}}}}}},"deprecated":false}},"jsLinks":[],"subdomain":"tradefusiontechnologiespvtltd","siteName":"LaunchMyStore Developers","title":"Create Webhook Subscription - LaunchMyStore Developers","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-03T20:46:19.315Z","originalFileLocation":"api-reference/webhooks/create.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Subscribe your app to a webhook topic on the installed store\">\u003cmeta data-mint-head name=\"application-name\" content=\"LaunchMyStore Developers\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/tradefusiontechnologiespvtltd/AxaKSy1cjHGQnY9E/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/tradefusiontechnologiespvtltd/AxaKSy1cjHGQnY9E/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/tradefusiontechnologiespvtltd/AxaKSy1cjHGQnY9E/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/tradefusiontechnologiespvtltd/AxaKSy1cjHGQnY9E/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/tradefusiontechnologiespvtltd/AxaKSy1cjHGQnY9E/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/tradefusiontechnologiespvtltd/AxaKSy1cjHGQnY9E/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/tradefusiontechnologiespvtltd/AxaKSy1cjHGQnY9E/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/tradefusiontechnologiespvtltd/AxaKSy1cjHGQnY9E/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/tradefusiontechnologiespvtltd/AxaKSy1cjHGQnY9E/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Create Webhook Subscription - LaunchMyStore Developers\">\u003cmeta data-mint-head property=\"og:description\" content=\"Subscribe your app to a webhook topic on the installed store\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"LaunchMyStore Developers\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.launchmystore.io/api-reference/webhooks/create\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://tradefusiontechnologiespvtltd.mintlify.app/_mintlify/api/og/v2?division=Webhooks\u0026amp;title=Create+Webhook+Subscription\u0026amp;description=Subscribe+your+app+to+a+webhook+topic+on+the+installed+store\u0026amp;theme=7262308de22b2a4febf4ce58\u0026amp;signature=a0048c827a8651a34bfb922b3811680cbfece81325621e9303890eb123148f4e\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Create Webhook Subscription - LaunchMyStore Developers\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Subscribe your app to a webhook topic on the installed store\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://tradefusiontechnologiespvtltd.mintlify.app/_mintlify/api/og/v2?division=Webhooks\u0026amp;title=Create+Webhook+Subscription\u0026amp;description=Subscribe+your+app+to+a+webhook+topic+on+the+installed+store\u0026amp;theme=7262308de22b2a4febf4ce58\u0026amp;signature=a0048c827a8651a34bfb922b3811680cbfece81325621e9303890eb123148f4e\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/tradefusiontechnologiespvtltd/AxaKSy1cjHGQnY9E/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"LaunchMyStore Developers\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#3B82F6\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.launchmystore.io/api-reference/webhooks/create\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/webhooks/create.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.launchmystore.io/#organization\",\"name\":\"LaunchMyStore Developers\",\"url\":\"https://docs.launchmystore.io\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/tradefusiontechnologiespvtltd/h0D_voj1Mzg300-x/logo/light.svg?fit=max\u0026auto=format\u0026n=h0D_voj1Mzg300-x\u0026q=85\u0026s=22ebdb2605f91ccf72f71097a82d6928\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.launchmystore.io#website\",\"name\":\"LaunchMyStore Developers\",\"url\":\"https://docs.launchmystore.io\",\"publisher\":{\"@id\":\"https://docs.launchmystore.io/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.launchmystore.io/api-reference/webhooks/create#webpage\",\"url\":\"https://docs.launchmystore.io/api-reference/webhooks/create\",\"name\":\"Create Webhook Subscription\",\"description\":\"Subscribe your app to a webhook topic on the installed store\",\"dateModified\":\"2026-11-03T20:46:19.315Z\",\"isPartOf\":{\"@id\":\"https://docs.launchmystore.io#website\"},\"breadcrumb\":{\"@id\":\"https://docs.launchmystore.io/api-reference/webhooks/create#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.launchmystore.io/api-reference/webhooks/create#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Webhooks\",\"item\":\"https://docs.launchmystore.io/api-reference/webhooks/overview\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Create Webhook Subscription\",\"item\":\"https://docs.launchmystore.io/api-reference/webhooks/create\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.launchmystore.io/api-reference/webhooks/create#apireference\",\"headline\":\"Create Webhook Subscription\",\"name\":\"Create Webhook Subscription\",\"description\":\"Subscribe your app to a webhook topic on the installed store\",\"url\":\"https://docs.launchmystore.io/api-reference/webhooks/create\",\"mainEntityOfPage\":{\"@id\":\"https://docs.launchmystore.io/api-reference/webhooks/create#webpage\"},\"dateModified\":\"2026-11-03T20:46:19.315Z\",\"publisher\":{\"@id\":\"https://docs.launchmystore.io/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.launchmystore.io#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"LaunchMyStore Developers\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"LaunchMyStore Developers","nav":{"global":{"anchors":[{"anchor":"GitHub","icon":"github","href":"https://github.com/launchmystore"},{"anchor":"Community","icon":"discord","href":"https://discord.gg/launchmystore"},{"anchor":"App Store","icon":"grid-2","href":"https://app.launchmystore.io/marketplace"}]},"tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":"/introduction"}]},{"tab":"Theme Development","pages":[{"title":"Theme Development","href":"/aqua/overview"}]},{"tab":"API Reference","groups":[{"group":"API Reference","pages":[{"title":"API Overview","href":"/api-reference/overview"},{"title":"API Authentication","href":"/api-reference/authentication"},{"title":"API Rate Limits","href":"/api-reference/rate-limits"}]},{"group":"OAuth","pages":[{"title":"Authorize","api":"GET https://api.launchmystore.io/apps/oauth/authorize","href":"/api-reference/oauth/authorize"},{"title":"Token Exchange","api":"POST https://api.launchmystore.io/apps/oauth/token","href":"/api-reference/oauth/token"},{"title":"Revoke Token","api":"POST https://api.launchmystore.io/apps/oauth/revoke","href":"/api-reference/oauth/revoke"},{"title":"Scopes","href":"/api-reference/oauth/scopes"}]},{"group":"Apps","pages":[{"title":"App Versions","api":"GET https://api.launchmystore.io/apps/developer/{appId}/versions","href":"/api-reference/apps/versions"},{"title":"Installation Rollback","api":"POST https://api.launchmystore.io/apps/store/installations/{installationId}/rollback","href":"/api-reference/apps/rollback"},{"title":"App Installations","api":"GET https://api.launchmystore.io/apps/store/installed","href":"/api-reference/apps/installations"},{"title":"Test a Function","api":"POST https://api.launchmystore.io/apps/functions/test","href":"/api-reference/apps/function-test"},{"title":"Function runs","href":"/api-reference/apps/function-runs"}]},{"group":"App Billing","pages":[{"title":"App Subscriptions","api":"POST https://api.launchmystore.io/apps/billing/subscribe","href":"/api-reference/app-billing/subscriptions"},{"title":"App Billing Transactions","api":"GET https://api.launchmystore.io/apps/billing/transactions","href":"/api-reference/app-billing/transactions"},{"title":"Usage Records","api":"POST https://api.launchmystore.io/api/v1/billing/usage","href":"/api-reference/app-billing/usage-records"},{"title":"Get Usage","api":"GET https://api.launchmystore.io/api/v1/billing/usage","href":"/api-reference/app-billing/get-usage"},{"title":"Update Usage Cap","api":"POST https://api.launchmystore.io/api/v1/billing/usage/cap","href":"/api-reference/app-billing/update-usage-cap"}]},{"group":"App Analytics","pages":[{"title":"App Analytics","api":"GET https://api.launchmystore.io/apps/developer/analytics","href":"/api-reference/app-analytics/overview"}]},{"group":"App Settings","pages":[{"title":"Get App Settings","api":"GET https://api.launchmystore.io/apps/installations/{installationId}/settings","href":"/api-reference/app-settings/get"},{"title":"Update App Settings","api":"PUT https://api.launchmystore.io/apps/installations/{installationId}/settings","href":"/api-reference/app-settings/update"}]},{"group":"Developer","pages":[{"title":"Developer Payouts","api":"GET https://api.launchmystore.io/apps/developer/payouts","href":"/api-reference/developer/payouts"},{"title":"Payout Methods","api":"GET https://api.launchmystore.io/apps/developer/payout-method","href":"/api-reference/developer/payout-methods"}]},{"group":"Products","pages":[{"title":"List Products","api":"GET https://api.launchmystore.io/api/v1/products.json","href":"/api-reference/products/list"},{"title":"Get Product","api":"GET https://api.launchmystore.io/api/v1/products/:id.json","href":"/api-reference/products/get"},{"title":"Create Product","api":"POST https://api.launchmystore.io/api/v1/products.json","href":"/api-reference/products/create"},{"title":"Update Product","api":"PUT https://api.launchmystore.io/api/v1/products/:id.json","href":"/api-reference/products/update"},{"title":"Delete Product","api":"DELETE https://api.launchmystore.io/api/v1/products/:id.json","href":"/api-reference/products/delete"}]},{"group":"Orders","pages":[{"title":"List Orders","api":"GET https://api.launchmystore.io/api/v1/orders.json","href":"/api-reference/orders/list"},{"title":"Get Order","api":"GET https://api.launchmystore.io/api/v1/orders/:id.json","href":"/api-reference/orders/get"},{"title":"Create Order","api":"POST https://api.launchmystore.io/api/v1/orders.json","href":"/api-reference/orders/create"},{"title":"Update Order","api":"PATCH https://api.launchmystore.io/orders/update-signle-order/:orderId","href":"/api-reference/orders/update"},{"title":"Fulfill Order","api":"POST https://api.launchmystore.io/api/v1/orders/:orderId/fulfillments.json","href":"/api-reference/orders/fulfill"},{"title":"Refund Order","api":"POST https://api.launchmystore.io/api/v1/orders/:id/refunds.json","href":"/api-reference/orders/refund"}]},{"group":"Customers","pages":[{"title":"List Customers","api":"GET https://api.launchmystore.io/api/v1/customers.json","href":"/api-reference/customers/list"},{"title":"Get Customer","api":"GET https://api.launchmystore.io/api/v1/customers/{id}.json","href":"/api-reference/customers/get"},{"title":"Create Customer","api":"POST https://api.launchmystore.io/api/v1/customers.json","href":"/api-reference/customers/create"},{"title":"Update Customer","api":"PUT https://api.launchmystore.io/api/v1/customers/{id}.json","href":"/api-reference/customers/update"},{"title":"Delete Customer","api":"DELETE https://api.launchmystore.io/api/v1/customers/{id}.json","href":"/api-reference/customers/delete"}]},{"group":"Inventory","pages":[{"title":"List Inventory Levels","api":"GET https://api.launchmystore.io/api/v1/inventory_levels.json","href":"/api-reference/inventory/list"},{"title":"Adjust Inventory","api":"POST https://api.launchmystore.io/api/v1/inventory_levels/adjust.json","href":"/api-reference/inventory/adjust"},{"title":"Set Inventory Level","api":"POST https://api.launchmystore.io/api/v1/inventory_levels/set.json","href":"/api-reference/inventory/set"}]},{"group":"Webhooks","pages":[{"title":"Webhooks Overview","href":"/api-reference/webhooks/overview"},{"title":"Webhook Topics","href":"/api-reference/webhooks/topics"},{"title":"List Webhook Subscriptions","api":"GET https://api.launchmystore.io/api/v1/webhooks.json","description":"List your app's webhook subscriptions on the installed store","href":"/api-reference/webhooks/list"},{"title":"Create Webhook Subscription","api":"POST https://api.launchmystore.io/api/v1/webhooks.json","href":"/api-reference/webhooks/create"},{"title":"Delete Webhook Subscription","api":"DELETE https://api.launchmystore.io/api/v1/webhooks/:id.json","description":"Remove one of your webhook subscriptions","href":"/api-reference/webhooks/delete"},{"title":"Webhook Verification","href":"/api-reference/webhooks/verification"},{"title":"GDPR Webhooks","href":"/api-reference/webhooks/gdpr"},{"title":"Webhook Delivery Logs","api":"GET https://api.launchmystore.io/apps/store/webhook-logs","href":"/api-reference/webhooks/delivery-logs"}]},{"group":"Collections","pages":[{"title":"List Collections","api":"GET https://api.launchmystore.io/api/v1/collections.json","href":"/api-reference/collections/list"},{"title":"Get Collection","api":"GET https://api.launchmystore.io/api/v1/collections/{id}.json","href":"/api-reference/collections/get"},{"title":"Create Collection","api":"POST https://api.launchmystore.io/api/v1/collections.json","href":"/api-reference/collections/create"},{"title":"Update Collection","api":"PUT https://api.launchmystore.io/api/v1/collections/{id}.json","href":"/api-reference/collections/update"},{"title":"Delete Collection","api":"DELETE https://api.launchmystore.io/api/v1/collections/{id}.json","href":"/api-reference/collections/delete"}]},{"group":"Blogs","pages":[{"title":"List Blogs","api":"GET https://api.launchmystore.io/api/v1/blogs.json","href":"/api-reference/blogs/list"},{"title":"Get Blog","api":"GET https://api.launchmystore.io/api/v1/blogs/:id.json","href":"/api-reference/blogs/get"},{"title":"Create Blog","api":"POST https://api.launchmystore.io/api/v1/blogs.json","href":"/api-reference/blogs/create"},{"title":"Update Blog","api":"PUT https://api.launchmystore.io/api/v1/blogs/:id.json","href":"/api-reference/blogs/update"},{"title":"Delete Blog","api":"DELETE https://api.launchmystore.io/api/v1/blogs/:id.json","href":"/api-reference/blogs/delete"},{"title":"List Articles","api":"GET https://api.launchmystore.io/api/v1/blogs/:blog_id/articles.json","href":"/api-reference/blogs/articles/list"},{"title":"Get Article","api":"GET https://api.launchmystore.io/api/v1/articles/:id.json","href":"/api-reference/blogs/articles/get"},{"title":"Create Article","api":"POST https://api.launchmystore.io/api/v1/blogs/:blog_id/articles.json","href":"/api-reference/blogs/articles/create"},{"title":"Update Article","api":"PUT https://api.launchmystore.io/api/v1/articles/:id.json","href":"/api-reference/blogs/articles/update"},{"title":"Delete Article","api":"DELETE https://api.launchmystore.io/api/v1/articles/:id.json","href":"/api-reference/blogs/articles/delete"}]},{"group":"Pages","pages":[{"title":"List Pages","api":"GET https://api.launchmystore.io/api/v1/pages.json","href":"/api-reference/pages/list"},{"title":"Get Page","api":"GET https://api.launchmystore.io/api/v1/pages/:id.json","href":"/api-reference/pages/get"},{"title":"Create Page","api":"POST https://api.launchmystore.io/api/v1/pages.json","href":"/api-reference/pages/create"},{"title":"Update Page","api":"PUT https://api.launchmystore.io/api/v1/pages/:id.json","href":"/api-reference/pages/update"},{"title":"Delete Page","api":"DELETE https://api.launchmystore.io/api/v1/pages/:id.json","href":"/api-reference/pages/delete"}]},{"group":"Menus","pages":[{"title":"List Menus","api":"GET https://api.launchmystore.io/api/v1/menus.json","href":"/api-reference/menus/list"},{"title":"Get Menu","api":"GET https://api.launchmystore.io/api/v1/menus/:id.json","href":"/api-reference/menus/get"},{"title":"Create Menu","api":"POST https://api.launchmystore.io/api/v1/menus.json","href":"/api-reference/menus/create"},{"title":"Update Menu","api":"PUT https://api.launchmystore.io/api/v1/menus/:id.json","href":"/api-reference/menus/update"},{"title":"Delete Menu","api":"DELETE https://api.launchmystore.io/api/v1/menus/:id.json","href":"/api-reference/menus/delete"}]},{"group":"Themes","pages":[{"title":"List Themes","api":"GET https://api.launchmystore.io/api/v1/themes.json","href":"/api-reference/themes/list"},{"title":"Get Theme","api":"GET https://api.launchmystore.io/api/v1/themes/{id}.json","href":"/api-reference/themes/get"},{"title":"Theme Assets","api":"GET https://api.launchmystore.io/api/v1/themes/{theme_id}/assets.json","href":"/api-reference/themes/assets"},{"title":"Create or Update Theme Asset","api":"PUT https://api.launchmystore.io/api/v1/themes/{theme_id}/assets.json","href":"/api-reference/themes/asset-update"},{"title":"Delete Theme Asset","api":"DELETE https://api.launchmystore.io/api/v1/themes/{theme_id}/assets.json","href":"/api-reference/themes/asset-delete"},{"title":"Theme Settings","api":"GET https://api.launchmystore.io/api/v1/themes/{theme_id}/settings.json","href":"/api-reference/themes/settings"},{"title":"Update Theme Settings","api":"PUT https://api.launchmystore.io/api/v1/themes/{theme_id}/settings.json","href":"/api-reference/themes/settings-update"},{"title":"Template Sections","api":"GET https://api.launchmystore.io/api/v1/themes/{theme_id}/templates/{template}/sections.json","href":"/api-reference/themes/sections"},{"title":"Update Section Settings","api":"PUT https://api.launchmystore.io/api/v1/themes/{theme_id}/sections/{section_id}/settings.json","href":"/api-reference/themes/section-settings-update"},{"title":"Add Section","api":"POST https://api.launchmystore.io/api/v1/themes/{theme_id}/templates/{template}/sections.json","href":"/api-reference/themes/section-add"},{"title":"Delete Section","api":"DELETE https://api.launchmystore.io/api/v1/themes/{theme_id}/sections/{section_id}.json","href":"/api-reference/themes/section-delete"}]},{"group":"Shipping Zones","pages":[{"title":"List Shipping Zones","api":"GET https://api.launchmystore.io/api/v1/shipping_zones.json","href":"/api-reference/shipping-zones/list"},{"title":"Get Shipping Zone","api":"GET https://api.launchmystore.io/api/v1/shipping_zones/{zone_id}.json","href":"/api-reference/shipping-zones/get"},{"title":"Create Shipping Zone","api":"POST https://api.launchmystore.io/api/v1/shipping_zones.json","href":"/api-reference/shipping-zones/create"},{"title":"Update Shipping Zone","api":"PUT https://api.launchmystore.io/api/v1/shipping_zones/{zone_id}.json","href":"/api-reference/shipping-zones/update"},{"title":"Delete Shipping Zone","api":"DELETE https://api.launchmystore.io/api/v1/shipping_zones/{zone_id}.json","href":"/api-reference/shipping-zones/delete"}]},{"group":"Gift Cards","pages":[{"title":"List Gift Cards","api":"GET https://api.launchmystore.io/api/v1/gift_cards.json","href":"/api-reference/gift-cards/list"},{"title":"Get Gift Card","api":"GET https://api.launchmystore.io/api/v1/gift_cards/{gift_card_id}.json","href":"/api-reference/gift-cards/get"},{"title":"Create Gift Card","api":"POST https://api.launchmystore.io/api/v1/gift_cards.json","href":"/api-reference/gift-cards/create"},{"title":"Disable Gift Card","api":"POST https://api.launchmystore.io/api/v1/gift_cards/{gift_card_id}/disable.json","href":"/api-reference/gift-cards/disable"}]},{"group":"Email Templates","pages":[{"title":"List Email Templates","api":"GET https://api.launchmystore.io/api/v1/email-templates.json","href":"/api-reference/email-templates/list"},{"title":"Create / Update Email Template","api":"POST https://api.launchmystore.io/api/v1/email-templates.json","href":"/api-reference/email-templates/create"},{"title":"Delete Email Template","api":"DELETE https://api.launchmystore.io/api/v1/email-templates/{id}.json","href":"/api-reference/email-templates/delete"},{"title":"Send Email","api":"POST https://api.launchmystore.io/api/v1/emails/send.json","href":"/api-reference/email-templates/send"}]},{"group":"Sales Channels","pages":[{"title":"Create Sales Channel","api":"POST https://api.launchmystore.io/api/v1/sales_channels.json","href":"/api-reference/sales-channels/create"},{"title":"List Product Listings","api":"GET https://api.launchmystore.io/api/v1/product_listings.json","href":"/api-reference/product-listings/list"},{"title":"Create Product Listing","api":"POST https://api.launchmystore.io/api/v1/product_listings.json","href":"/api-reference/product-listings/create"}]},{"group":"Discounts","pages":[{"title":"List Discounts","api":"GET https://api.launchmystore.io/api/v1/discounts.json","href":"/api-reference/discounts/list"},{"title":"Get Discount","api":"GET https://api.launchmystore.io/api/v1/discounts/{id}.json","href":"/api-reference/discounts/get"},{"title":"Create Discount","api":"POST https://api.launchmystore.io/api/v1/discounts.json","href":"/api-reference/discounts/create"},{"title":"Update Discount","api":"PUT https://api.launchmystore.io/api/v1/discounts/{id}.json","href":"/api-reference/discounts/update"},{"title":"Delete Discount","api":"DELETE https://api.launchmystore.io/api/v1/discounts/{id}.json","href":"/api-reference/discounts/delete"}]},{"group":"Metafields","pages":[{"title":"Metafields Overview","href":"/api-reference/metafields/overview"},{"title":"List Metafields","api":"GET https://api.launchmystore.io/api/v1/metafields.json","href":"/api-reference/metafields/list"},{"title":"Get Metafield by ID (Admin API only)","href":"/api-reference/metafields/get"},{"title":"Create or Upsert Metafield","api":"POST https://api.launchmystore.io/api/v1/metafields.json","href":"/api-reference/metafields/create"},{"title":"Update Metafield","api":"PUT https://api.launchmystore.io/api/v1/metafields/:id.json","href":"/api-reference/metafields/update"},{"title":"Delete Metafield","api":"DELETE https://api.launchmystore.io/api/v1/metafields/:id.json","href":"/api-reference/metafields/delete"},{"title":"Bulk Upsert Metafields (Admin API only)","href":"/api-reference/metafields/bulk"},{"group":"Definitions","pages":[{"title":"Metafield Definitions Overview","href":"/api-reference/metafields/definitions/overview"},{"title":"List Metafield Definitions","api":"GET https://api.launchmystore.io/metafield-definitions","href":"/api-reference/metafields/definitions/list"},{"title":"Get Metafield Definition","api":"GET https://api.launchmystore.io/metafield-definitions/:id","href":"/api-reference/metafields/definitions/get"},{"title":"Create Metafield Definition","api":"POST https://api.launchmystore.io/metafield-definitions","href":"/api-reference/metafields/definitions/create"},{"title":"Update Metafield Definition","api":"PUT https://api.launchmystore.io/metafield-definitions/:id","href":"/api-reference/metafields/definitions/update"},{"title":"Delete Metafield Definition","api":"DELETE https://api.launchmystore.io/metafield-definitions/:id","href":"/api-reference/metafields/definitions/delete"}]}]},{"group":"Fulfillments","pages":[{"title":"List Fulfillments","api":"GET https://api.launchmystore.io/api/v1/fulfillments.json","href":"/api-reference/fulfillments/list"},{"title":"Get Fulfillment","api":"GET https://api.launchmystore.io/api/v1/fulfillments/{fulfillment_id}.json","href":"/api-reference/fulfillments/get"},{"title":"Create Fulfillment","api":"POST https://api.launchmystore.io/api/v1/orders/{order_id}/fulfillments.json","href":"/api-reference/fulfillments/create"},{"title":"Update Fulfillment","api":"PUT https://api.launchmystore.io/api/v1/fulfillments/{fulfillment_id}.json","href":"/api-reference/fulfillments/update"},{"title":"Delete Fulfillment","api":"DELETE https://api.launchmystore.io/api/v1/fulfillments/{fulfillment_id}.json","href":"/api-reference/fulfillments/delete"},{"title":"Fulfillment Services","href":"/api-reference/fulfillments/services"},{"title":"Create Fulfillment Service","api":"POST https://api.launchmystore.io/api/v1/fulfillment_services.json","href":"/api-reference/fulfillments/service-create"},{"title":"List Fulfillment Services","api":"GET https://api.launchmystore.io/api/v1/fulfillment_services.json","href":"/api-reference/fulfillments/service-list"}]},{"group":"Analytics","pages":[{"title":"Dashboard Summary","api":"GET https://api.launchmystore.io/api/v1/analytics/summary","href":"/api-reference/analytics/overview"},{"title":"Sales Analytics","api":"GET https://api.launchmystore.io/api/v1/analytics/sales","href":"/api-reference/analytics/sales"},{"title":"Top Products","api":"GET https://api.launchmystore.io/api/v1/analytics/products/top","href":"/api-reference/analytics/products"}]},{"group":"Billing","pages":[{"title":"Get Billing Summary","api":"GET https://api.launchmystore.io/api/v1/billing","href":"/api-reference/billing/summary"},{"title":"List Subscriptions","api":"GET https://api.launchmystore.io/api/v1/billing/subscriptions","href":"/api-reference/billing/subscriptions"},{"title":"List Invoices","api":"GET https://api.launchmystore.io/api/v1/billing/invoices","href":"/api-reference/billing/invoices"}]},{"group":"Settings","pages":[{"title":"Get Store Settings","api":"GET https://api.launchmystore.io/api/v1/settings","href":"/api-reference/settings/get"},{"title":"Update Store Settings","api":"PUT https://api.launchmystore.io/api/v1/settings","href":"/api-reference/settings/update"},{"title":"List Shipping Zones","api":"GET https://api.launchmystore.io/api/v1/settings/shipping","href":"/api-reference/settings/shipping"},{"title":"List Payment Providers","api":"GET https://api.launchmystore.io/api/v1/settings/payments","href":"/api-reference/settings/payments"},{"title":"Get Tax Settings","api":"GET https://api.launchmystore.io/api/v1/settings/taxes","href":"/api-reference/settings/taxes"}]},{"group":"Cart","pages":[{"title":"Get Cart","api":"GET https://your-store.launchmystore.io/cart.js","href":"/api-reference/cart/get"},{"title":"Add to Cart","api":"POST https://your-store.launchmystore.io/cart/add.js","href":"/api-reference/cart/add"},{"title":"Update Cart","api":"POST https://your-store.launchmystore.io/cart/update.js","href":"/api-reference/cart/update"},{"title":"Remove from Cart","api":"POST https://your-store.launchmystore.io/cart/change.js","href":"/api-reference/cart/remove"},{"title":"Clear Cart","api":"POST https://{shop-domain}/cart/clear.js","href":"/api-reference/cart/clear"}]},{"group":"Variants","pages":[{"title":"List Variants","api":"GET https://api.launchmystore.io/api/v1/products/{id}.json","href":"/api-reference/variants/list"},{"title":"Get Variant","api":"GET https://api.launchmystore.io/variants/get-single-variant/{id}","href":"/api-reference/variants/get"},{"title":"Create Variant","api":"POST https://api.launchmystore.io/variants/bulk-add-variant/{product_id}","href":"/api-reference/variants/create"},{"title":"Update Variant","api":"PATCH https://api.launchmystore.io/variants/update-single-variant/{id}","href":"/api-reference/variants/update"},{"title":"Delete Variant","api":"DELETE https://api.launchmystore.io/variants/delete-single-variant/{id}","href":"/api-reference/variants/delete"}]},{"group":"Locations","pages":[{"title":"List Locations","api":"GET https://api.launchmystore.io/api/v1/locations.json","href":"/api-reference/locations/list"},{"title":"Get Location","api":"GET https://api.launchmystore.io/api/v1/locations/{id}.json","href":"/api-reference/locations/get"},{"title":"Create Location","api":"POST https://api.launchmystore.io/warehouse/add-warehouse","href":"/api-reference/locations/create"}]},{"group":"Shop","pages":[{"title":"Get Shop","api":"GET https://api.launchmystore.io/api/v1/shop.json","href":"/api-reference/shop/get"},{"title":"Update Shop","api":"PUT https://api.launchmystore.io/accounts/add-business-detail","href":"/api-reference/shop/update"}]},{"group":"Policies","pages":[{"title":"List Policies","api":"GET https://api.launchmystore.io/policies/get-all-policies","href":"/api-reference/policies/list"},{"title":"Update Policy","api":"PATCH https://api.launchmystore.io/policies/update-policies/{policyId}","href":"/api-reference/policies/update"}]},{"group":"Search","pages":[{"title":"Search Products","api":"GET https://{store-domain}/search/suggest.json","href":"/api-reference/search/products"},{"title":"Search Collections","api":"GET https://{store-domain}/search/suggest.json","href":"/api-reference/search/collections"},{"title":"Search Autocomplete","api":"GET https://{store-domain}/search/suggest.json","href":"/api-reference/search/autocomplete"}]},{"group":"Files","pages":[{"title":"List Files","api":"GET https://api.launchmystore.io/api/v1/files.json","href":"/api-reference/files/list"},{"title":"Upload File","api":"POST https://api.launchmystore.io/api/v1/files.json","href":"/api-reference/files/upload"},{"title":"Delete File","api":"DELETE https://api.launchmystore.io/api/v1/files/{file_id}.json","href":"/api-reference/files/delete"}]},{"group":"App Data","pages":[{"title":"Set App Data","api":"POST https://api.launchmystore.io/api/v1/app-data","href":"/api-reference/app-data/set"},{"title":"Get App Data","api":"GET https://api.launchmystore.io/api/v1/app-data","href":"/api-reference/app-data/get"},{"title":"Delete App Data","api":"DELETE https://api.launchmystore.io/api/v1/app-data","href":"/api-reference/app-data/delete"},{"title":"Sweep Expired App Data","api":"POST https://api.launchmystore.io/api/v1/app-data/sweep-expired","href":"/api-reference/app-data/sweep-expired"}]}]}]},"basePath":"","title":"Create Webhook Subscription - LaunchMyStore Developers","buildId":"dpl_345ReqzYaAjzS9QpeJemsKdb7KDj","deploymentId":"dpl_345ReqzYaAjzS9QpeJemsKdb7KDj","dynamics":["c2aa737661","2b790eda92","b0f84f53ff"],"chunks":["OpenApiReferenceProvider-C8RPHPxo.js","utils-0BK-9q6z.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-DfjzsUJT.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-B4v9psJ4.js","snippetPresets-CpTQv-Ez.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-BNP-Fvr0.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BSgu6h1D.js","shallow-Biv1i9Gs.js","getApiPlaygroundDisplay-BoGOXhtF.js","CodeSnippet-DvQoT18_.js","CodeSnippets-Dnpa15xT.js","Page-Buji1S4J.js","getPastedJson-xAIyhUFE.js","icon-S6FBih11.js","MethodPill-SaYeUZyk.js","DuplicateIcon-Cs-p3v2Q.js","createIcon-DjCFEoHq.js","DynamicMarkdown-BcnBltEQ.js","SectionHeading-BUBl0eEF.js","axios-vUo_bRtp.js"]}