We use webhooks to notify you when certain events/actions happen on your integration. They are essential for you to take necessary actions when certain events happen. You can set up your webhooks here
It is important that you validate the webhooks to ensure that they are indeed coming from us. You can validate webhooks using the Webhook Secret from your dashboard here
{"docsConfig":{"$schema":"https://mintlify.com/docs.json","theme":"mint","name":"Tribease Documentation","colors":{"primary":"#10435D","light":"#2ea6e3","dark":"#10435D"},"favicon":"/favimg.png","logo":{"light":"https://mintcdn.com/tribeaseltd/HLtvg4HaT9UUUaSP/logo/dark.png?fit=max\u0026auto=format\u0026n=HLtvg4HaT9UUUaSP\u0026q=85\u0026s=8fb03a39527fb9422ca72a19a57a3000","dark":"https://mintcdn.com/tribeaseltd/HLtvg4HaT9UUUaSP/logo/white.png?fit=max\u0026auto=format\u0026n=HLtvg4HaT9UUUaSP\u0026q=85\u0026s=74b5555d5fde7445cb4e713332fc5d54"},"api":{"mdx":{"server":"https://staging.api.tribease.com/v2","auth":{"method":"bearer","name":null}}},"navbar":{"links":[{"label":"Support","href":"mailto:hello@tribease.com"}],"primary":{"type":"button","label":"Dashboard","href":"https://dashboard.tribease.com"}},"footer":{"socials":{"x":"https://x.com/tribease1","instagram":"https://instagram.com/tribease","linkedin":"https://linkedin.com/company/tribease"}},"navigation":{"global":{"anchors":[{"anchor":"Website","href":"https://tribease.com","icon":"globe"},{"anchor":"Dev Community","href":"https://tribease.slack.com","icon":"slack"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"tribeaseltd","hasAudioNarration":false,"actualSubdomain":"tribeaseltd","customDomains":["docs.tribease.com"],"gitSource":{"type":"github","owner":"tribease","repo":"docs.tribease.com","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6a20c68494c2a4904ac398e8","collectionId":"d1641281-f473-4b23-ab06-b13fb58add4c","schemaVersion":"v2"},"entitlements":{},"buildId":"6a20c68494c2a4904ac398e8:success","clientVersion":"0.0.4043","searchFilterCounts":[{"language":"default","tag":"API Reference","count":8},{"language":"default","tag":"Endpoints","count":6},{"language":"default","tag":"Payment Intent","count":6},{"language":"default","tag":"Documentation","count":3},{"language":"default","tag":"API Documentation","count":2},{"language":"default","tag":"Get Started","count":2},{"language":"default","tag":"Docs","count":1}]},"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}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"docs/webhooks","slug":"/docs/webhooks","pageMetadata":{"title":"Webhooks","description":"Understand how webhooks work","icon":"bell","href":"/docs/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: \"Understand how webhooks work\"\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`,p:`p`,..._provideComponents(),...props.components},{Heading}=_components;if(!Heading)_missingMdxReference(`Heading`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`We use webhooks to notify you when certain events/actions happen on your integration. They are essential for you to take necessary actions when certain events happen. You can set up your webhooks `,_jsx(_components.a,{href:`https://dashboard.tribease.com/settings/webhooks`,children:`here`})]}),`\n`,_jsx(Heading,{level:`2`,id:`events-we-notify-you-about`,children:`Events we notify you about`}),`\n`,_jsx(_components.p,{children:`Here is a list of events we notify you about.`}),`\n`,_jsx(Heading,{level:`2`,id:`validate-webhooks`,children:`Validate Webhooks`}),`\n`,_jsxs(_components.p,{children:[`It is important that you validate the webhooks to ensure that they are indeed coming from us. You can validate webhooks using the Webhook Secret from your dashboard `,_jsx(_components.a,{href:`https://dashboard.tribease.com/settings/webhooks#secret`,children:`here`})]})]})}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":"Webhooks","description":"Understand how webhooks work","icon":"bell","href":"/docs/webhooks"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Events we notify you about","slug":"events-we-notify-you-about","depth":2,"children":[]},{"title":"Validate Webhooks","slug":"validate-webhooks","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"tribeaseltd","siteName":"Tribease Documentation","title":"Webhooks - Tribease Documentation","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-01-07T04:56:17.613Z","originalFileLocation":"docs/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=\"Understand how webhooks work\">\u003cmeta data-mint-head name=\"application-name\" content=\"Tribease Documentation\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/tribeaseltd/x5DLeLKz5CkxutBZ/_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/tribeaseltd/x5DLeLKz5CkxutBZ/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/tribeaseltd/x5DLeLKz5CkxutBZ/_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/tribeaseltd/x5DLeLKz5CkxutBZ/_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/tribeaseltd/x5DLeLKz5CkxutBZ/_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/tribeaseltd/x5DLeLKz5CkxutBZ/_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/tribeaseltd/x5DLeLKz5CkxutBZ/_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/tribeaseltd/x5DLeLKz5CkxutBZ/_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/tribeaseltd/x5DLeLKz5CkxutBZ/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Webhooks - Tribease Documentation\">\u003cmeta data-mint-head property=\"og:description\" content=\"Understand how webhooks work\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Tribease Documentation\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.tribease.com/docs/webhooks\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://tribeaseltd.mintlify.app/_mintlify/api/og/v2?division=Docs\u0026amp;title=Webhooks\u0026amp;description=Understand+how+webhooks+work\u0026amp;theme=7c31ca62b067746850edbc31\u0026amp;signature=d56722461e282b9dc18b3cd9eebd12e3db88b3b83587de3cff0ac20d287b533a\">\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 - Tribease Documentation\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Understand how webhooks work\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://tribeaseltd.mintlify.app/_mintlify/api/og/v2?division=Docs\u0026amp;title=Webhooks\u0026amp;description=Understand+how+webhooks+work\u0026amp;theme=7c31ca62b067746850edbc31\u0026amp;signature=d56722461e282b9dc18b3cd9eebd12e3db88b3b83587de3cff0ac20d287b533a\">\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/tribeaseltd/x5DLeLKz5CkxutBZ/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Tribease Documentation\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#10435D\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.tribease.com/docs/webhooks\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/docs/webhooks.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.tribease.com/#organization\",\"name\":\"Tribease Documentation\",\"url\":\"https://docs.tribease.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/tribeaseltd/HLtvg4HaT9UUUaSP/logo/dark.png?fit=max\u0026auto=format\u0026n=HLtvg4HaT9UUUaSP\u0026q=85\u0026s=8fb03a39527fb9422ca72a19a57a3000\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.tribease.com#website\",\"name\":\"Tribease Documentation\",\"url\":\"https://docs.tribease.com\",\"publisher\":{\"@id\":\"https://docs.tribease.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.tribease.com/docs/webhooks#webpage\",\"url\":\"https://docs.tribease.com/docs/webhooks\",\"name\":\"Webhooks\",\"description\":\"Understand how webhooks work\",\"dateModified\":\"2026-01-07T04:56:17.613Z\",\"isPartOf\":{\"@id\":\"https://docs.tribease.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.tribease.com/docs/webhooks#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.tribease.com/docs/webhooks#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Tribease Documentation\",\"item\":\"https://docs.tribease.com\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Webhooks\",\"item\":\"https://docs.tribease.com/docs/webhooks\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.tribease.com/docs/webhooks#article\",\"headline\":\"Webhooks\",\"name\":\"Webhooks\",\"description\":\"Understand how webhooks work\",\"url\":\"https://docs.tribease.com/docs/webhooks\",\"mainEntityOfPage\":{\"@id\":\"https://docs.tribease.com/docs/webhooks#webpage\"},\"dateModified\":\"2026-01-07T04:56:17.613Z\",\"publisher\":{\"@id\":\"https://docs.tribease.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.tribease.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Tribease Documentation\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Tribease Documentation","nav":{"global":{"anchors":[{"anchor":"Website","href":"https://tribease.com","icon":"globe"},{"anchor":"Dev Community","href":"https://tribease.slack.com","icon":"slack"}]},"tabs":[{"tab":"Documentation","groups":[{"group":"Get Started","pages":[{"title":"Introduction","href":"/introduction"},{"title":"Start Here","description":"Quick steps to get you started.","href":"/starthere"}]},{"group":"Docs","pages":[{"title":"Webhooks","icon":"bell","href":"/docs/webhooks"}]}]},{"tab":"API Reference","pages":[{"title":"API Reference","href":"/api-reference/introduction"}]}]},"basePath":"","title":"Webhooks - Tribease Documentation","buildId":"dpl_G9nrg4qeJSZtah1Ziwbc2n6WkLch","deploymentId":"dpl_G9nrg4qeJSZtah1Ziwbc2n6WkLch","dynamics":[],"chunks":[]}
