Webhooks provide a powerful tool for real-time notifications regarding changes in your Wingback account. They facilitate automated communication between Wingback and your services, enabling you to keep your system in sync with your Wingback data.Webhooks are an essential tool for extending the functionality of your Wingback integration. They allow you to listen for specific events and trigger actions within your application based on these events. This could be anything from sending a welcome email when a new customer signs up, to updating a customer’s account status when a payment is successful.
You can create and manage webhooks via the Webhook Interface, which can be accessed from the settings menu in the Wingback application. The interface provides an endpoints overview, an event log, and a copy of the event catalog.When creating a new endpoint, you’ll have the option to select the specific events it should subscribe to.
Keep in mind that events can be triggered by a variety of actions, either from the customer using the self-serve billing portal, changes to customers and plans in the customer portal by your sales, accounting, and customer success teams, or plan changes triggered through the API.
{"docsConfig":{"$schema":"https://mintlify.com/docs.json","theme":"mint","name":"Wingback","colors":{"primary":"#EF3B4D","light":"#FF7886","dark":"#D81D38"},"favicon":"/media/favicon.png","logo":{"light":"https://mintcdn.com/wingback/GadBRdJt85xVxME0/media/logo/light.svg?fit=max\u0026auto=format\u0026n=GadBRdJt85xVxME0\u0026q=85\u0026s=93b61d8945910151ec8df39c2b469c8e","dark":"https://mintcdn.com/wingback/GadBRdJt85xVxME0/media/logo/dark.svg?fit=max\u0026auto=format\u0026n=GadBRdJt85xVxME0\u0026q=85\u0026s=ba6722dedd801b55082f19792ea3b441"},"api":{"mdx":{"server":"https://api.wingback.com"}},"navbar":{"links":[],"primary":{"type":"button","label":"Go to Dashboard","href":"https://app.wingback.com/"}},"footer":{"socials":{"website":"https://wingback.com","twitter":"https://twitter.com/wingbackapp","linkedin":"https://www.linkedin.com/company/wingbackapp/"}},"integrations":{"posthog":{"apiKey":"phc_9zg8YkIBr0SuofRjG6TujIu9Q6I2deAFFat4U3DpbrV","apiHost":"https://i.wingback.com"}},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"wingback","hasAudioNarration":false,"actualSubdomain":"wingback","customDomains":["docs-int.wingback.com"],"gitSource":{"type":"github","owner":"wingbackapp","repo":"mintlify-docs","deployBranch":"main","contentDirectory":"docs","mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6a20c343cf0492c7637e2ac2","collectionId":"df9c82e5-67e0-472b-acfa-7306b676d252","schemaVersion":"v2"},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6ae913eaf00457754795603e:success","clientVersion":"0.0.4054","searchFilterCounts":[{"language":"default","tag":"Developer Documentation","count":41},{"language":"default","tag":"API Reference","count":31},{"language":"default","tag":"SGI Fundamentals","count":19},{"language":"default","tag":"Pricing Model Guides","count":16},{"language":"default","tag":"User Guides","count":13},{"language":"default","tag":"User Manuals","count":10},{"language":"default","tag":"Customer","count":8},{"language":"default","tag":"Payment","count":6},{"language":"default","tag":"Guides","count":6},{"language":"default","tag":"Feature Overview","count":6}]},"assistantConfig":{},"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":"dev/guides/webhooks","slug":"/dev/guides/webhooks","pageMetadata":{"title":"Webhooks","description":"Connecting Wingback to your application","href":"/dev/guides/webhooks"},"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: \"Connecting Wingback to your application\"\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];const IntRedir=()=>{if(typeof document===`undefined`){return null}else{setTimeout(()=>{const currentUrl=new URL(window.location.href);if(currentUrl.hostname===`docs-int.wingback.com`){currentUrl.hostname=`docs.wingback.com`;window.location.replace(currentUrl.toString())}},1);return _jsx(_Fragment,{})}};function _createMdxContent(props){const _components={a:`a`,code:`code`,p:`p`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,..._provideComponents(),...props.components},{Heading,Note,OptimizedImage,Table,Warning,_MdxComponentBoundary}=_components;if(!Heading)_missingMdxReference(`Heading`,true);if(!Note)_missingMdxReference(`Note`,true);if(!OptimizedImage)_missingMdxReference(`OptimizedImage`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Warning)_missingMdxReference(`Warning`,true);if(!_MdxComponentBoundary)_missingMdxReference(`_MdxComponentBoundary`,true);return _jsxs(_Fragment,{children:[_jsx(_MdxComponentBoundary,{name:`IntRedir`,children:_jsx(IntRedir,{})}),`\n`,_jsx(_components.p,{children:`Webhooks provide a powerful tool for real-time notifications regarding changes in your Wingback account. They facilitate automated communication between Wingback and your services, enabling you to keep your system in sync with your Wingback data.`}),`\n`,_jsx(_components.p,{children:`Webhooks are an essential tool for extending the functionality of your Wingback integration. They allow you to listen for specific events and trigger actions within your application based on these events. This could be anything from sending a welcome email when a new customer signs up, to updating a customer’s account status when a payment is successful.`}),`\n`,_jsx(Heading,{level:`2`,id:`creating-a-new-webhook`,children:`Creating a New Webhook`}),`\n`,_jsx(_components.p,{children:`You can create and manage webhooks via the Webhook Interface, which can be accessed from the settings menu in the Wingback application. The interface provides an endpoints overview, an event log, and a copy of the event catalog.`}),`\n`,_jsx(OptimizedImage,{src:`https://mintcdn.com/wingback/GadBRdJt85xVxME0/media/dev/guides/webhooks/endpoint_interface.png?fit=max\u0026auto=format\u0026n=GadBRdJt85xVxME0\u0026q=85\u0026s=9b0a79599d2c93b39fc85012483ec546`,alt:``,\"data-og-width\":`2173`,width:`2173`,\"data-og-height\":`1603`,height:`1603`,\"data-path\":`media/dev/guides/webhooks/endpoint_interface.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/wingback/GadBRdJt85xVxME0/media/dev/guides/webhooks/endpoint_interface.png?w=280\u0026fit=max\u0026auto=format\u0026n=GadBRdJt85xVxME0\u0026q=85\u0026s=627b3cfa7aeeba5236fd96e1337ecf98 280w, https://mintcdn.com/wingback/GadBRdJt85xVxME0/media/dev/guides/webhooks/endpoint_interface.png?w=560\u0026fit=max\u0026auto=format\u0026n=GadBRdJt85xVxME0\u0026q=85\u0026s=cd009c8d05da75bcb01b390d1ff8b20c 560w, https://mintcdn.com/wingback/GadBRdJt85xVxME0/media/dev/guides/webhooks/endpoint_interface.png?w=840\u0026fit=max\u0026auto=format\u0026n=GadBRdJt85xVxME0\u0026q=85\u0026s=3947c318994e567adb44657a254a62b1 840w, https://mintcdn.com/wingback/GadBRdJt85xVxME0/media/dev/guides/webhooks/endpoint_interface.png?w=1100\u0026fit=max\u0026auto=format\u0026n=GadBRdJt85xVxME0\u0026q=85\u0026s=fdbebe0a090d25b9c47e801775104ec4 1100w, https://mintcdn.com/wingback/GadBRdJt85xVxME0/media/dev/guides/webhooks/endpoint_interface.png?w=1650\u0026fit=max\u0026auto=format\u0026n=GadBRdJt85xVxME0\u0026q=85\u0026s=25c1f561591de49e8095f2b5b56ed958 1650w, https://mintcdn.com/wingback/GadBRdJt85xVxME0/media/dev/guides/webhooks/endpoint_interface.png?w=2500\u0026fit=max\u0026auto=format\u0026n=GadBRdJt85xVxME0\u0026q=85\u0026s=29beffd9d72d785629cdc56777afc62a 2500w`}),`\n`,_jsx(_components.p,{children:`When creating a new endpoint, you’ll have the option to select the specific events it should subscribe to.`}),`\n`,_jsx(Note,{children:`Keep in mind that events can be triggered by a variety of actions, either from the customer using the self-serve billing portal, changes to customers and plans in the customer portal by your sales, accounting, and customer success teams, or plan changes triggered through the API.`}),`\n`,_jsx(Heading,{level:`2`,id:`event-catalog`,children:`Event Catalog`}),`\n`,_jsx(Warning,{children:`We’re constantly expanding the event catalog. If you need a specific event that’s not listed, don’t hesitate to reach out!`}),`\n`,_jsx(_components.p,{children:`The following table provides a list of events currently supported:`}),`\n`,_jsx(Heading,{level:`3`,id:`customer`,children:`Customer`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Name`}),_jsx(_components.th,{children:`Description`}),_jsx(_components.th,{children:`Event`}),_jsx(_components.th,{children:`Payload`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Customer`})}),_jsx(_components.td,{}),_jsx(_components.td,{}),_jsx(_components.td,{})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Customer created`}),_jsx(_components.td,{children:`A new customer has been created in Wingback (useful if you are signup customers via Wingback signup links and then create an account on your side)`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`v1.customer.created`})}),_jsx(_components.td,{children:_jsx(_components.a,{href:`/dev/api-reference/customer/get_c_customer_customerid`,children:`Customer ID`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Customer updated`}),_jsx(_components.td,{children:`The customer’s information on file has been updated (e.g. billing address).`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`v1.customer.updated`})}),_jsx(_components.td,{children:_jsx(_components.a,{href:`/dev/api-reference/customer/get_c_customer_customerid`,children:`Customer ID`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Invoice`})}),_jsx(_components.td,{}),_jsx(_components.td,{}),_jsx(_components.td,{})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Invoice Created`}),_jsx(_components.td,{children:`A new invoice has been created.`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`v1.invoice.created`})}),_jsx(_components.td,{children:_jsx(_components.a,{href:`/dev/api-reference/invoice/get_c_invoice_invoiceid`,children:`Invoice ID`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Plan Changes`})}),_jsx(_components.td,{}),_jsx(_components.td,{}),_jsx(_components.td,{})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Plan assigned (future start date)`}),_jsx(_components.td,{children:`A customer is scheduled to start a (new) plan at a future date.`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`v1.contract.signature.scheduled`})}),_jsx(_components.td,{children:_jsx(_components.a,{href:`/dev/api-reference/contract/get_c_contract_contractid`,children:`Contract ID`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Plan assigned (starts now)`}),_jsx(_components.td,{children:`A customer has started or switched plans.`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`v1.contract.signature.completed`})}),_jsx(_components.td,{children:_jsx(_components.a,{href:`/dev/api-reference/contract/get_c_contract_contractid`,children:`Contract ID`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Plan cancellation scheduled`}),_jsx(_components.td,{children:`A customer has canceled a plan renewal, or a plan cancellation has been scheduled.`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`v1.contract.cancellation.scheduled`})}),_jsx(_components.td,{children:_jsx(_components.a,{href:`/dev/api-reference/contract/get_c_contract_contractid`,children:`Contract ID`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Plan terminated/ended`}),_jsx(_components.td,{children:`The customer is no longer assigned to the plan.`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`v1.contract.cancellation.completed`})}),_jsx(_components.td,{children:_jsx(_components.a,{href:`/dev/api-reference/contract/get_c_contract_contractid`,children:`Contract ID`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Payments`})}),_jsx(_components.td,{}),_jsx(_components.td,{}),_jsx(_components.td,{})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Transaction started`}),_jsx(_components.td,{children:`An attempt is being made to charge an automatic payment method.`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`v1.payment.started`})}),_jsx(_components.td,{children:_jsx(_components.a,{href:`/dev/api-reference/customer/get_c_customer_customerid`,children:`Customer_ID`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Transaction error`}),_jsx(_components.td,{children:`The payment method could not be charged (triggers on every failure when set to retry).`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`v1.payment.failed`})}),_jsx(_components.td,{children:_jsx(_components.a,{href:`/dev/api-reference/customer/get_c_customer_customerid`,children:`Customer ID`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Transaction successful`}),_jsx(_components.td,{children:`A customer was successfully charged via the payment method.`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`v1.payment.succeeded`})}),_jsx(_components.td,{children:_jsx(_components.a,{href:`/dev/api-reference/customer/get_c_customer_customerid`,children:`Customer ID`})})]})]})]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{IntRedir,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":"Webhooks","description":"Connecting Wingback to your application","href":"/dev/guides/webhooks"}}},"mdxSourceWithNoJs":null,"noJsSplices":[[147,447,"null;function _creat"]]},"mdxExtracts":{"tableOfContents":[{"title":"Creating a New Webhook","slug":"creating-a-new-webhook","depth":2,"children":[]},{"title":"Event Catalog","slug":"event-catalog","depth":2,"children":[{"title":"Customer","slug":"customer","depth":3,"children":[]}]}],"codeExamples":{}},"jsLinks":["/_mintlify/custom/wingback/bbb25f53a15d63f9/int-redir.js"],"subdomain":"wingback","siteName":"Wingback","title":"Webhooks - Wingback","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-01-06T22:42:19.094Z","originalFileLocation":"dev/guides/webhooks.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=\"Connecting Wingback to your application\">\u003cmeta data-mint-head name=\"application-name\" content=\"Wingback\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/wingback/UnON2ZxPucVjTp_q/_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/wingback/UnON2ZxPucVjTp_q/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/wingback/UnON2ZxPucVjTp_q/_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/wingback/UnON2ZxPucVjTp_q/_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/wingback/UnON2ZxPucVjTp_q/_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/wingback/UnON2ZxPucVjTp_q/_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/wingback/UnON2ZxPucVjTp_q/_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/wingback/UnON2ZxPucVjTp_q/_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/wingback/UnON2ZxPucVjTp_q/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Webhooks - Wingback\">\u003cmeta data-mint-head property=\"og:description\" content=\"Connecting Wingback to your application\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Wingback\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs-int.wingback.com/dev/guides/webhooks\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://wingback.mintlify.app/_mintlify/api/og/v2?division=Guides\u0026amp;title=Webhooks\u0026amp;description=Connecting+Wingback+to+your+application\u0026amp;theme=b99535fc2fd6236ca0523fc2\u0026amp;signature=16cc4f75ceed73cda4f23a950a41f99556648b382e849209ef69593ea1d582ef\">\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=\"Webhooks - Wingback\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Connecting Wingback to your application\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://wingback.mintlify.app/_mintlify/api/og/v2?division=Guides\u0026amp;title=Webhooks\u0026amp;description=Connecting+Wingback+to+your+application\u0026amp;theme=b99535fc2fd6236ca0523fc2\u0026amp;signature=16cc4f75ceed73cda4f23a950a41f99556648b382e849209ef69593ea1d582ef\">\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/wingback/UnON2ZxPucVjTp_q/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Wingback\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#EF3B4D\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs-int.wingback.com/dev/guides/webhooks\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/dev/guides/webhooks.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs-int.wingback.com/#organization\",\"name\":\"Wingback\",\"url\":\"https://docs-int.wingback.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/wingback/GadBRdJt85xVxME0/media/logo/light.svg?fit=max\u0026auto=format\u0026n=GadBRdJt85xVxME0\u0026q=85\u0026s=93b61d8945910151ec8df39c2b469c8e\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs-int.wingback.com#website\",\"name\":\"Wingback\",\"url\":\"https://docs-int.wingback.com\",\"publisher\":{\"@id\":\"https://docs-int.wingback.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs-int.wingback.com/dev/guides/webhooks#webpage\",\"url\":\"https://docs-int.wingback.com/dev/guides/webhooks\",\"name\":\"Webhooks\",\"description\":\"Connecting Wingback to your application\",\"dateModified\":\"2026-01-06T22:42:19.094Z\",\"isPartOf\":{\"@id\":\"https://docs-int.wingback.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs-int.wingback.com/dev/guides/webhooks#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs-int.wingback.com/dev/guides/webhooks#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Guides\",\"item\":\"https://docs-int.wingback.com/dev/guides/features-entitlements\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Webhooks\",\"item\":\"https://docs-int.wingback.com/dev/guides/webhooks\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs-int.wingback.com/dev/guides/webhooks#article\",\"headline\":\"Webhooks\",\"name\":\"Webhooks\",\"description\":\"Connecting Wingback to your application\",\"url\":\"https://docs-int.wingback.com/dev/guides/webhooks\",\"mainEntityOfPage\":{\"@id\":\"https://docs-int.wingback.com/dev/guides/webhooks#webpage\"},\"dateModified\":\"2026-01-06T22:42:19.094Z\",\"publisher\":{\"@id\":\"https://docs-int.wingback.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs-int.wingback.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Wingback\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Wingback","nav":{"global":null,"tabs":[{"tab":"User Guides","pages":[{"title":"User Guides","href":"/user/welcome"}]},{"tab":"User Manuals","pages":[{"title":"User Manuals","href":"/manual/introduction"}]},{"tab":"SGI Fundamentals","pages":[{"title":"SGI Fundamentals","href":"/fundamentals/vocab/introduction"}]},{"tab":"Developer Documentation","groups":[{"group":"Welcome","pages":[{"title":"Introduction","href":"/dev/welcome"}]},{"group":"Guides","pages":[{"title":"Working with Features and Entitlements","href":"/dev/guides/features-entitlements"},{"title":"Integrating Wingback into your Signup Flow","href":"/dev/guides/integrate-wingback-signup-flow"},{"title":"Billing Portal Integration","href":"/dev/guides/billing-portal"},{"title":"Adding a Dynamic Pricing Page to Your Website","href":"/dev/guides/pricing-page"},{"title":"Metering Usage","description":"Introduction to Usage-based Pricing and Billing","href":"/dev/guides/metering"},{"title":"Webhooks","href":"/dev/guides/webhooks"}]},{"group":"Wingback.js","pages":[{"title":"Introduction","description":null,"href":"/dev/wingback-js/introduction"},{"title":"Pricing Pages","href":"/dev/wingback-js/pricing"}]},{"group":"Advanced","pages":[{"title":"Variable Invoicing Schedules","href":"/dev/advanced/variable-invoicing-schedules"}]},{"group":"API Reference","pages":[{"title":"Introduction","href":"/dev/api-reference/introduction"},{"group":"Customer","pages":[{"title":"Create New Customer","openapi":"POST /v1/c/customer","href":"/dev/api-reference/customer/post_c_customer"},{"title":"Get Customer","openapi":"GET /v1/c/customer/{customer_id}","href":"/dev/api-reference/customer/get_c_customer_customerid"},{"title":"Search for Customers","openapi":"GET /v1/c/customer","href":"/dev/api-reference/customer/get_c_customer"},{"title":"Activate Customer","openapi":"POST /v1/c/customer/{customer_id}/activate","href":"/dev/api-reference/customer/post_c_customer_customerid_activate"},{"title":"Freeze/Inactivate Customer","openapi":"POST /v1/c/customer/{customer_id}/inactivate","href":"/dev/api-reference/customer/post_c_customer_customerid_inactivate"},{"title":"Add Address","openapi":"POST /v1/c/customer/{customer_id}/address","href":"/dev/api-reference/customer/post_c_customer_customerid_address"},{"title":"Get Address","openapi":"GET /v1/c/customer/{customer_id}/address","href":"/dev/api-reference/customer/get_c_customer_customerid_address"},{"title":"Delete Address","openapi":"DELETE /v1/c/customer/{customer_id}/address","href":"/dev/api-reference/customer/delete_c_customer_customerid_address"}]},{"group":"Contract","pages":[{"title":"Subscribe Customer to a Plan","openapi":"POST /v1/c/contract","href":"/dev/api-reference/contract/post_c_contract"},{"title":"Retrieve Contract Details","openapi":"GET /v1/c/contract/{contract_id}","href":"/dev/api-reference/contract/get_c_contract_contractid"},{"title":"Upgrade/Change Plan","openapi":"POST /v1/c/contract/{contract_id}/upgrade","href":"/dev/api-reference/contract/post_c_contract_contractid_upgrade"},{"title":"Estimate Upgrade Costss","openapi":"POST /v1/c/contract/{contract_id}/upgrade_estimate","href":"/dev/api-reference/contract/post_c_contract_contractid_upgrade_estimate"}]},{"group":"Billing Portal","pages":[{"title":"Login a Customer to the Self-Serve Portal","openapi":"POST /v1/c/customer/authenticate","href":"/dev/api-reference/billing-portal/post_c_customer_authenticate"}]},{"group":"Entitlements","pages":[{"title":"Get Access Entitlements","openapi":"GET /v1/c/entitlement/{customer_id}/access","href":"/dev/api-reference/entitlement/get_c_entitlement_customerid_access"},{"title":"Get Billing Entitlements","openapi":"GET /v1/c/entitlement/{customer_id}/billing","href":"/dev/api-reference/entitlement/get_c_entitlement_customerid_billing"}]},{"group":"Usage","pages":[{"title":"Report Single Event","openapi":"POST /v1/c/usage","href":"/dev/api-reference/usage/post_c_usage"},{"title":"Bulk Usage Upload","openapi":"POST /v1/c/usage/bulk","href":"/dev/api-reference/usage/post_c_usage_bulk"}]},{"group":"Payment","pages":[{"title":"Create Payment Session","openapi":"POST /v1/c/customer/{customer_id}/payment/session","href":"/dev/api-reference/payment/post_c_customer_customerid_payment_session"},{"title":"Add Payment Method","openapi":"POST /v1/c/customer/{customer_id}/payment/method","href":"/dev/api-reference/payment/post_c_customer_customerid_payment_method"},{"title":"List saved Payment Methods","openapi":"GET /v1/c/customer/{customer_id}/payment/method","href":"/dev/api-reference/payment/get_c_customer_customerid_payment_method"},{"title":"Get Saved Payment Method","openapi":"GET /v1/c/customer/{customer_id}/payment/method/{method_id}","href":"/dev/api-reference/payment/get_c_customer_customerid_payment_method_methodid"},{"title":"List saved Payment Methods","openapi":"GET /v1/c/customer/{customer_id}/payment/method","href":"/dev/api-reference/payment/get_c_customer_customerid_payment_method_selection"},{"title":"Set Default Payment Method","openapi":"POST /v1/c/customer/{customer_id}/payment/method_selection","href":"/dev/api-reference/payment/post_c_customer_customerid_payment_method_selection"}]},{"group":"Balance","pages":[{"title":"Get Current Customer Balance","openapi":"GET /v1/c/customer/{customer_id}/balance","href":"/dev/api-reference/balance/get_c_customer_customerid_balance"}]},{"group":"Virtual Wallets (Credits)","pages":[{"title":"Get Virtual Balances","openapi":"GET /v1/c/customer/{customer_id}/virtual-wallet/","href":"/dev/api-reference/virtual-wallet/get_c_customer_customerid_virtual-wallet"},{"title":"Add Virtual Credits","openapi":"POST /v1/c/virtual-wallet-transaction","href":"/dev/api-reference/virtual-wallet/post_c_virtual-wallet-transaction"}]},{"group":"Invoices","pages":[{"title":"List Invoices","openapi":"GET /v1/c/invoice","href":"/dev/api-reference/invoice/get_c_invoice"},{"title":"Get Invoice","openapi":"GET /v1/c/invoice/{invoice_id}","href":"/dev/api-reference/invoice/get_c_invoice_invoiceid"},{"title":"Configure Global Invoicing Preferences","openapi":"POST /v1/c/preferences/invoicing","href":"/dev/api-reference/invoice/post_c_preferences_invoicing"},{"title":"Manually Trigger Invoice Generation","openapi":"POST /v1/c/invoice","href":"/dev/api-reference/invoice/post_c_invoice"}]}]}]}]},"basePath":"","title":"Webhooks - Wingback","buildId":"dpl_345ReqzYaAjzS9QpeJemsKdb7KDj","deploymentId":"dpl_345ReqzYaAjzS9QpeJemsKdb7KDj","dynamics":["a74be98ba7"],"chunks":["zoom-image-lightbox-B4-wUcHm.js","lightbox-handle-r17bVUz3.js"]}