Deleting a webhook requires the workspace admin or tech role. readonly keys get 403.
Request
Pass the webhook ID in the path.
string
required
The webhook ID to delete.
The ID is also accepted in a JSON body sent to DELETE /api/webhooks for backwards compatibility:
string
The webhook ID to delete. Used only when the path contains no ID.
Deleting a webhook removes the endpoint. Its delivery history is retained, but you can no longer read it: list deliveries returns 404 once the webhook is gone. Export anything you need first.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/schema.json","name":"Encrata","description":"Turn any email address into structured person and company intelligence - validity, identity, and breach exposure. Built for AI agents and developers.","colors":{"primary":"#DA7756","light":"#DA7756","dark":"#DA7756"},"logo":{"light":"https://mintcdn.com/encrata/MIGYfhts8_CZTVNw/logo/light.svg?fit=max\u0026auto=format\u0026n=MIGYfhts8_CZTVNw\u0026q=85\u0026s=78c13b7e6fada3e98b35abf8413364ef","dark":"https://mintcdn.com/encrata/Ov5bkKx_wmw3x5s5/logo/dark.svg?fit=max\u0026auto=format\u0026n=Ov5bkKx_wmw3x5s5\u0026q=85\u0026s=3fb90fd04c751e77f827720c01e1262b"},"favicon":"https://mintcdn.com/encrata/EN96i1Av07M0QsrB/images/Encrata.png?fit=max\u0026auto=format\u0026n=EN96i1Av07M0QsrB\u0026q=85\u0026s=6f03d9ec8807625331a9e283e07759b3","api":{"examples":{"autogenerate":false},"mdx":{"auth":{"method":"key","name":"Authorization"},"server":"https://developer.encrata.com"}},"appearance":{"default":"system"},"background":{"color":{"light":"#FAF9F7","dark":"#1f1f1d"}},"navbar":{"links":[{"href":"https://status.encrata.com","label":"Status"},{"href":"https://encrata.com/contact","label":"Contact"}],"primary":{"type":"button","label":"Get API key","href":"https://app.encrata.com/signup"}},"fonts":{"family":"Inter","weight":400},"icons":{"library":"fontawesome"},"styling":{"codeblocks":{"theme":{"light":"github-light","dark":"vesper"}},"latex":false},"contextual":{"options":["copy","view","chatgpt","claude","cursor","vscode"],"display":"header"},"markdown":{"instructions":["## Submitting feedback","If you find an error, a missing step, or information that is outdated or misleading on this page — especially if it stopped you from completing your task — report it so the Encrata docs team can fix it.","Send a POST request to https://docs.encrata.com/feedback with a JSON body containing `path` (the full URL of the page, for example `https://docs.encrata.com/quickstart`) and `feedback` (what was wrong and what you expected):","curl -X POST https://docs.encrata.com/feedback -H 'Content-Type: application/json' -d '{\"path\": \"https://docs.encrata.com/quickstart\", \"feedback\": \"Step 3 uses a parameter that the API rejects.\"}'","Do not include API keys, personal data, or other secrets in your feedback."]},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"encrata","hasAudioNarration":false,"actualSubdomain":"encrata","customDomains":["docs.encrata.com"],"gitSource":{"type":"github","owner":"encratahq","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true,"agentFeedback":true},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6afd6b3072017a95b62630bc","clientVersion":"0.0.4205","searchFilterCounts":[{"language":"default","tag":"API Reference","count":31},{"language":"default","tag":"Guides","count":18},{"language":"default","tag":"Get Started","count":9},{"language":"default","tag":"API Keys","count":7},{"language":"default","tag":"Webhooks","count":7},{"language":"default","tag":"Overview","count":7},{"language":"default","tag":"Malware","count":5},{"language":"default","tag":"Email","count":5},{"language":"default","tag":"auth.md","count":5},{"language":"default","tag":"Integrations","count":4}]},"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":"custom-rbac-roles","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":"rbac-expansion","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":"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":"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":"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":"editor-metadata","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":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"treatment","enabled":true,"payload":{"type":"string","value":"treatment"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":".sidebar-title,.sidebar-title *{font-weight:700!important}html.light [class*=\"step-indicator\"][class*=\"rounded-full\"]{background-color:#f0e7e1!important;box-shadow:inset 0 0 0 1px rgba(0, 0, 0, 0.08)!important}"}],"page":{"pagePath":"api-reference/endpoint/delete-webhook","slug":"/api-reference/endpoint/delete-webhook","pageMetadata":{"title":"Delete webhook","api":"DELETE /api/webhooks/{id}","description":"Remove a webhook endpoint and stop its deliveries.","href":"/api-reference/endpoint/delete-webhook"},"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: \"Remove a webhook endpoint and stop its deliveries.\"\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`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{CodeBlock,CodeGroup,Expandable,Heading,Note,ParamField,ResponseField,Table,Warning}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!CodeGroup)_missingMdxReference(`CodeGroup`,true);if(!Expandable)_missingMdxReference(`Expandable`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Note)_missingMdxReference(`Note`,true);if(!ParamField)_missingMdxReference(`ParamField`,true);if(!ResponseField)_missingMdxReference(`ResponseField`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`Deletes a webhook. Encrata stops delivering to it immediately.`}),`\n`,_jsx(Heading,{level:`2`,id:`authentication`,children:`Authentication`}),`\n`,_jsxs(_components.p,{children:[`Send your Encrata API key in the `,_jsx(_components.code,{children:`Authorization`}),` header with the `,_jsx(_components.code,{children:`Bearer`}),` prefix.`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`1`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light vesper`,style:{backgroundColor:`#fff`,\"--shiki-dark-bg\":`#101010`,color:`#24292e`,\"--shiki-dark\":`#FFF`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#6F42C1`,\"--shiki-dark\":`#FFC799`},children:`Authorization:`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#99FFE4`},children:` Bearer`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#99FFE4`},children:` enc_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx`})]}),`\n`]})})}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[`Deleting a webhook requires the workspace `,_jsx(_components.code,{children:`admin`}),` or `,_jsx(_components.code,{children:`tech`}),` role. `,_jsx(_components.code,{children:`readonly`}),` keys get `,_jsx(_components.code,{children:`403`}),`.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`request`,children:`Request`}),`\n`,_jsx(_components.p,{children:`Pass the webhook ID in the path.`}),`\n`,_jsx(ParamField,{path:`id`,type:`string`,required:true,id:`param-id`,children:_jsx(_components.p,{children:`The webhook ID to delete.`})}),`\n`,_jsxs(_components.p,{children:[`The ID is also accepted in a JSON body sent to `,_jsx(_components.code,{children:`DELETE /api/webhooks`}),` for backwards compatibility:`]}),`\n`,_jsx(ParamField,{body:`id`,type:`string`,id:`param-id-1`,children:_jsx(_components.p,{children:`The webhook ID to delete. Used only when the path contains no ID.`})}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`Deleting a webhook removes the endpoint. Its delivery history is retained, but you can no longer read it: `,_jsx(_components.a,{href:`/api-reference/endpoint/webhook-deliveries`,children:`list deliveries`}),` returns `,_jsx(_components.code,{children:`404`}),` once the webhook is gone. Export anything you need first.`]})}),`\n`,_jsx(Heading,{level:`3`,id:`examples`,children:`Examples`}),`\n`,_jsxs(CodeGroup,{children:[_jsx(CodeBlock,{filename:`cURL`,numberOfLines:`2`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light vesper`,style:{backgroundColor:`#fff`,\"--shiki-dark-bg\":`#101010`,color:`#24292e`,\"--shiki-dark\":`#FFF`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`2`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#6F42C1`,\"--shiki-dark\":`#FFC799`},children:`curl`}),_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#99FFE4`},children:` -X`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#99FFE4`},children:` DELETE`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#99FFE4`},children:` \"https://developer.encrata.com/api/webhooks/360cb300-d885-4c18-af2c-d259f936bb38\"`}),_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#A0A0A0`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#99FFE4`},children:` -H`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#99FFE4`},children:` \"Authorization: Bearer enc_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx\"`})]}),`\n`]})})}),_jsx(CodeBlock,{filename:`Python`,numberOfLines:`8`,language:`python`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light vesper`,style:{backgroundColor:`#fff`,\"--shiki-dark-bg\":`#101010`,color:`#24292e`,\"--shiki-dark\":`#FFF`},language:`python`,children:_jsxs(_components.code,{language:`python`,numberOfLines:`8`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#A0A0A0`},children:`import`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#FFF`},children:` requests`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#FFF`},children:`webhook_id `}),_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#A0A0A0`},children:`=`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#99FFE4`},children:` \"360cb300-d885-4c18-af2c-d259f936bb38\"`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#FFF`},children:`requests.delete(`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#A0A0A0`},children:` f`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#99FFE4`},children:`\"https://developer.encrata.com/api/webhooks/`}),_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#FFC799`},children:`{`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#FFF`},children:`webhook_id`}),_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#FFC799`},children:`}`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#99FFE4`},children:`\"`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#FFF`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#E36209`,\"--shiki-dark\":`#FFF`},children:` headers`}),_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#A0A0A0`},children:`=`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#FFF`},children:`{`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#99FFE4`},children:`\"Authorization\"`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#FFF`},children:`: `}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#99FFE4`},children:`\"Bearer enc_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx\"`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#FFF`},children:`},`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#FFF`},children:`)`})}),`\n`]})})}),_jsx(CodeBlock,{filename:`Node.js`,numberOfLines:`6`,language:`javascript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light vesper`,style:{backgroundColor:`#fff`,\"--shiki-dark-bg\":`#101010`,color:`#24292e`,\"--shiki-dark\":`#FFF`},language:`javascript`,children:_jsxs(_components.code,{language:`javascript`,numberOfLines:`6`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#A0A0A0`},children:`const`}),_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#FFF`},children:` webhookId`}),_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#A0A0A0`},children:` =`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#99FFE4`},children:` \"360cb300-d885-4c18-af2c-d259f936bb38\"`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#FFF`},children:`;`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#A0A0A0`},children:`await`}),_jsx(_components.span,{style:{color:`#6F42C1`,\"--shiki-dark\":`#FFC799`},children:` fetch`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#FFF`},children:`(`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#99FFE4`},children:\"`https://developer.encrata.com/api/webhooks/${\"}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#FFF`},children:`webhookId`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#99FFE4`},children:\"}`\"}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#FFF`},children:`, {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#FFF`},children:` method: `}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#99FFE4`},children:`\"DELETE\"`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#FFF`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#FFF`},children:` headers: { Authorization: `}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#99FFE4`},children:`\"Bearer enc_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx\"`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#FFF`},children:` },`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#FFF`},children:`});`})}),`\n`]})})}),_jsx(CodeBlock,{filename:`Body form`,numberOfLines:`4`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light vesper`,style:{backgroundColor:`#fff`,\"--shiki-dark-bg\":`#101010`,color:`#24292e`,\"--shiki-dark\":`#FFF`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`4`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#6F42C1`,\"--shiki-dark\":`#FFC799`},children:`curl`}),_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#99FFE4`},children:` -X`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#99FFE4`},children:` DELETE`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#99FFE4`},children:` \"https://developer.encrata.com/api/webhooks\"`}),_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#A0A0A0`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#99FFE4`},children:` -H`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#99FFE4`},children:` \"Authorization: Bearer enc_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx\"`}),_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#A0A0A0`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#99FFE4`},children:` -H`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#99FFE4`},children:` \"Content-Type: application/json\"`}),_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#A0A0A0`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#99FFE4`},children:` -d`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#99FFE4`},children:` '{\"id\": \"360cb300-d885-4c18-af2c-d259f936bb38\"}'`})]}),`\n`]})})})]}),`\n`,_jsx(Heading,{level:`2`,id:`response`,children:`Response`}),`\n`,_jsxs(_components.p,{children:[`Returns `,_jsx(_components.code,{children:`200 OK`}),`.`]}),`\n`,_jsx(ResponseField,{name:`success`,type:`boolean`,id:`param-success`,children:_jsxs(_components.p,{children:[_jsx(_components.code,{children:`true`}),` when the webhook was deleted.`]})}),`\n`,_jsx(ResponseField,{name:`result`,type:`object`,id:`param-result`,children:_jsx(Expandable,{title:`result`,defaultOpen:true,children:_jsx(ResponseField,{name:`status`,type:`string`,id:`param-status`,children:_jsxs(_components.p,{children:[`Always `,_jsx(_components.code,{children:`deleted`}),`.`]})})})}),`\n`,_jsx(ResponseField,{name:`message`,type:`string`,id:`param-message`,children:_jsx(_components.p,{children:`A human-readable summary.`})}),`\n`,_jsx(CodeBlock,{filename:`Example response`,numberOfLines:`5`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light vesper`,style:{backgroundColor:`#fff`,\"--shiki-dark-bg\":`#101010`,color:`#24292e`,\"--shiki-dark\":`#FFF`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`5`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#FFF`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#FFC799`},children:` \"success\"`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#FFF`},children:`: `}),_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#FFF`},children:`true`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#FFF`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#FFC799`},children:` \"result\"`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#FFF`},children:`: { `}),_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#FFC799`},children:`\"status\"`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#FFF`},children:`: `}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#99FFE4`},children:`\"deleted\"`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#FFF`},children:` },`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#FFC799`},children:` \"message\"`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#FFF`},children:`: `}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#99FFE4`},children:`\"Webhook deleted.\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#FFF`},children:`}`})}),`\n`]})})}),`\n`,_jsx(Heading,{level:`2`,id:`errors`,children:`Errors`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Status`}),_jsx(_components.th,{children:`Code`}),_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:_jsx(_components.code,{children:`bad_request`})}),_jsx(_components.td,{children:`No ID was supplied, or the JSON body could not be parsed.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`401`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`unauthorized`})}),_jsx(_components.td,{children:`The API key is missing, revoked, or disabled.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`403`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`forbidden`})}),_jsxs(_components.td,{children:[`Your role is `,_jsx(_components.code,{children:`readonly`}),`.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`404`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`not_found`})}),_jsxs(_components.td,{children:[`No webhook with that ID exists in your workspace. Deleting twice returns `,_jsx(_components.code,{children:`404`}),` the second time.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`500`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`internal`})}),_jsx(_components.td,{children:`Encrata could not delete the webhook. Retry.`})]})]})]}),`\n`,_jsx(CodeBlock,{filename:`Example error`,numberOfLines:`5`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light vesper`,style:{backgroundColor:`#fff`,\"--shiki-dark-bg\":`#101010`,color:`#24292e`,\"--shiki-dark\":`#FFF`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`5`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#FFF`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#FFC799`},children:` \"success\"`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#FFF`},children:`: `}),_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#FFF`},children:`false`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#FFF`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#FFC799`},children:` \"result\"`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#FFF`},children:`: { `}),_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#FFC799`},children:`\"code\"`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#FFF`},children:`: `}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#99FFE4`},children:`\"not_found\"`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#FFF`},children:` },`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#FFC799`},children:` \"message\"`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#FFF`},children:`: `}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#99FFE4`},children:`\"That webhook no longer exists. It may have been deleted.\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#FFF`},children:`}`})}),`\n`]})})}),`\n`,_jsx(Heading,{level:`2`,id:`next-steps`,children:`Next steps`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.a,{href:`/api-reference/endpoint/update-webhook`,children:`Pause instead of delete`}),`: Set `,_jsx(_components.code,{children:`is_active: false`}),` to stop deliveries reversibly.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.a,{href:`/api-reference/endpoint/create-webhook`,children:`Create a webhook`}),`: Register a replacement endpoint.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.a,{href:`/api-reference/endpoint/webhook`,children:`List webhooks`}),`: Confirm what is left in the workspace.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.a,{href:`/errors`,children:`Error reference`}),`: Every status code the API returns.`]}),`\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":{"codeStyling":{"theme":{"light":"github-light","dark":"vesper"}},"config":{},"pageMetadata":{"title":"Delete webhook","api":"DELETE /api/webhooks/{id}","description":"Remove a webhook endpoint and stop its deliveries.","href":"/api-reference/endpoint/delete-webhook"}}},"mdxSourceWithNoJs":null,"noJsSplices":[[398,403,"questExample,Respons"],[751,768,"questExample)_missingMdxReference(`RequestExample`,true);if(!ResponseField)_miss"],[19504,19932,",`\n`,_jsxs(RequestExample,{children:[_jsx(CodeBlock,{filename:`cURL`,numberOfLines:`2`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light vesper`,style:{backgroundColor:`#fff`,\"--shiki-dark-bg\":`#101010`,color:`#24292e`,\"--shiki-dark\":`#FFF`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`2`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#6F42C1`,\"--shiki-dark\":`#FFC799`},children:`curl`}),_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#99FFE4`},children:` -X`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#99FFE4`},children:` DELETE`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#99FFE4`},children:` \"https://developer.encrata.com/api/webhooks/360cb300-d885-4c18-af2c-d259f936bb38\"`}),_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#A0A0A0`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#99FFE4`},children:` -H`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#99FFE4`},children:` \"Authorization: Bearer enc_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx\"`})]}),`\n`]})})}),_jsx(CodeBlock,{filename:`Python`,numberOfLines:`8`,language:`python`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light vesper`,style:{backgroundColor:`#fff`,\"--shiki-dark-bg\":`#101010`,color:`#24292e`,\"--shiki-dark\":`#FFF`},language:`python`,children:_jsxs(_components.code,{language:`python`,numberOfLines:`8`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#A0A0A0`},children:`import`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#FFF`},children:` requests`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#FFF`},children:`webhook_id `}),_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#A0A0A0`},children:`=`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#99FFE4`},children:` \"360cb300-d885-4c18-af2c-d259f936bb38\"`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#FFF`},children:`requests.delete(`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#A0A0A0`},children:` f`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#99FFE4`},children:`\"https://developer.encrata.com/api/webhooks/`}),_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#FFC799`},children:`{`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#FFF`},children:`webhook_id`}),_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#FFC799`},children:`}`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#99FFE4`},children:`\"`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#FFF`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#E36209`,\"--shiki-dark\":`#FFF`},children:` headers`}),_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#A0A0A0`},children:`=`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#FFF`},children:`{`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#99FFE4`},children:`\"Authorization\"`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#FFF`},children:`: `}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#99FFE4`},children:`\"Bearer enc_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx\"`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#FFF`},children:`},`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#FFF`},children:`)`})}),`\n`]})})}),_jsx(CodeBlock,{filename:`Node.js`,numberOfLines:`6`,language:`javascript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light vesper`,style:{backgroundColor:`#fff`,\"--shiki-dark-bg\":`#101010`,color:`#24292e`,\"--shiki-dark\":`#FFF`},language:`javascript`,children:_jsxs(_components.code,{language:`javascript`,numberOfLines:`6`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#A0A0A0`},children:`const`}),_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#FFF`},children:` webhookId`}),_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#A0A0A0`},children:` =`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#99FFE4`},children:` \"360cb300-d885-4c18-af2c-d259f936bb38\"`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#FFF`},children:`;`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#A0A0A0`},children:`await`}),_jsx(_components.span,{style:{color:`#6F42C1`,\"--shiki-dark\":`#FFC799`},children:` fetch`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#FFF`},children:`(`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#99FFE4`},children:\"`https://developer.encrata.com/api/webhooks/${\"}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#FFF`},children:`webhookId`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#99FFE4`},children:\"}`\"}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#FFF`},children:`, {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#FFF`},children:` method: `}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#99FFE4`},children:`\"DELETE\"`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#FFF`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#FFF`},children:` headers: { Authorization: `}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#99FFE4`},children:`\"Bearer enc_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx\"`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#FFF`},children:` },`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#FFF`},children:`});`})}),`\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.\")}"]]},"mdxExtracts":{"tableOfContents":[{"title":"Authentication","slug":"authentication","depth":2,"children":[]},{"title":"Request","slug":"request","depth":2,"children":[{"title":"Examples","slug":"examples","depth":3,"children":[]}]},{"title":"Response","slug":"response","depth":2,"children":[]},{"title":"Errors","slug":"errors","depth":2,"children":[]},{"title":"Next steps","slug":"next-steps","depth":2,"children":[]}],"codeExamples":{"request":{"type":"RequestExample","children":[{"filename":"cURL","html":"\u003cpre class=\"shiki shiki-themes github-light vesper\" style=\"background-color:#fff;--shiki-dark-bg:#101010;color:#24292e;--shiki-dark:#FFF\" language=\"shellscript\">\u003ccode language=\"shellscript\" numberOfLines=\"2\">\u003cspan class=\"line\">\u003cspan style=\"color:#6F42C1;--shiki-dark:#FFC799\">curl\u003c/span>\u003cspan style=\"color:#005CC5;--shiki-dark:#99FFE4\"> -X\u003c/span>\u003cspan style=\"color:#032F62;--shiki-dark:#99FFE4\"> DELETE\u003c/span>\u003cspan style=\"color:#032F62;--shiki-dark:#99FFE4\"> \"https://developer.encrata.com/api/webhooks/360cb300-d885-4c18-af2c-d259f936bb38\"\u003c/span>\u003cspan style=\"color:#005CC5;--shiki-dark:#A0A0A0\"> \\\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#005CC5;--shiki-dark:#99FFE4\"> -H\u003c/span>\u003cspan style=\"color:#032F62;--shiki-dark:#99FFE4\"> \"Authorization: Bearer enc_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx\"\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"},{"filename":"Python","html":"\u003cpre class=\"shiki shiki-themes github-light vesper\" style=\"background-color:#fff;--shiki-dark-bg:#101010;color:#24292e;--shiki-dark:#FFF\" language=\"python\">\u003ccode language=\"python\" numberOfLines=\"8\">\u003cspan class=\"line\">\u003cspan style=\"color:#D73A49;--shiki-dark:#A0A0A0\">import\u003c/span>\u003cspan style=\"color:#24292E;--shiki-dark:#FFF\"> requests\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#24292E;--shiki-dark:#FFF\">webhook_id \u003c/span>\u003cspan style=\"color:#D73A49;--shiki-dark:#A0A0A0\">=\u003c/span>\u003cspan style=\"color:#032F62;--shiki-dark:#99FFE4\"> \"360cb300-d885-4c18-af2c-d259f936bb38\"\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#24292E;--shiki-dark:#FFF\">requests.delete(\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#D73A49;--shiki-dark:#A0A0A0\"> f\u003c/span>\u003cspan style=\"color:#032F62;--shiki-dark:#99FFE4\">\"https://developer.encrata.com/api/webhooks/\u003c/span>\u003cspan style=\"color:#005CC5;--shiki-dark:#FFC799\">{\u003c/span>\u003cspan style=\"color:#24292E;--shiki-dark:#FFF\">webhook_id\u003c/span>\u003cspan style=\"color:#005CC5;--shiki-dark:#FFC799\">}\u003c/span>\u003cspan style=\"color:#032F62;--shiki-dark:#99FFE4\">\"\u003c/span>\u003cspan style=\"color:#24292E;--shiki-dark:#FFF\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#E36209;--shiki-dark:#FFF\"> headers\u003c/span>\u003cspan style=\"color:#D73A49;--shiki-dark:#A0A0A0\">=\u003c/span>\u003cspan style=\"color:#24292E;--shiki-dark:#FFF\">{\u003c/span>\u003cspan style=\"color:#032F62;--shiki-dark:#99FFE4\">\"Authorization\"\u003c/span>\u003cspan style=\"color:#24292E;--shiki-dark:#FFF\">: \u003c/span>\u003cspan style=\"color:#032F62;--shiki-dark:#99FFE4\">\"Bearer enc_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx\"\u003c/span>\u003cspan style=\"color:#24292E;--shiki-dark:#FFF\">},\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#24292E;--shiki-dark:#FFF\">)\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"},{"filename":"Node.js","html":"\u003cpre class=\"shiki shiki-themes github-light vesper\" style=\"background-color:#fff;--shiki-dark-bg:#101010;color:#24292e;--shiki-dark:#FFF\" language=\"javascript\">\u003ccode language=\"javascript\" numberOfLines=\"6\">\u003cspan class=\"line\">\u003cspan style=\"color:#D73A49;--shiki-dark:#A0A0A0\">const\u003c/span>\u003cspan style=\"color:#005CC5;--shiki-dark:#FFF\"> webhookId\u003c/span>\u003cspan style=\"color:#D73A49;--shiki-dark:#A0A0A0\"> =\u003c/span>\u003cspan style=\"color:#032F62;--shiki-dark:#99FFE4\"> \"360cb300-d885-4c18-af2c-d259f936bb38\"\u003c/span>\u003cspan style=\"color:#24292E;--shiki-dark:#FFF\">;\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#D73A49;--shiki-dark:#A0A0A0\">await\u003c/span>\u003cspan style=\"color:#6F42C1;--shiki-dark:#FFC799\"> fetch\u003c/span>\u003cspan style=\"color:#24292E;--shiki-dark:#FFF\">(\u003c/span>\u003cspan style=\"color:#032F62;--shiki-dark:#99FFE4\">`https://developer.encrata.com/api/webhooks/${\u003c/span>\u003cspan style=\"color:#24292E;--shiki-dark:#FFF\">webhookId\u003c/span>\u003cspan style=\"color:#032F62;--shiki-dark:#99FFE4\">}`\u003c/span>\u003cspan style=\"color:#24292E;--shiki-dark:#FFF\">, {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#24292E;--shiki-dark:#FFF\"> method: \u003c/span>\u003cspan style=\"color:#032F62;--shiki-dark:#99FFE4\">\"DELETE\"\u003c/span>\u003cspan style=\"color:#24292E;--shiki-dark:#FFF\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#24292E;--shiki-dark:#FFF\"> headers: { Authorization: \u003c/span>\u003cspan style=\"color:#032F62;--shiki-dark:#99FFE4\">\"Bearer enc_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx\"\u003c/span>\u003cspan style=\"color:#24292E;--shiki-dark:#FFF\"> },\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#24292E;--shiki-dark:#FFF\">});\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"}],"attributes":[]}},"endpoint":{"title":"Delete webhook","path":"/api/webhooks/{id}","method":"delete","request":{"security":[],"parameters":{"query":{},"header":{},"cookie":{},"path":{"id":{"schema":[{"type":"string","description":"The webhook ID to delete.","required":true}]}}},"body":{"application/json":{"schemaArray":[{"type":"object","properties":{"id":[{"type":"string","description":"The webhook ID to delete. Used only when the path contains no ID."}]}}],"examples":{"example":{"value":{"id":"\u003cstring>"}}}}}},"response":{"200":{"application/json":{"schemaArray":[{"type":"object","properties":{"success":[{"type":"boolean","description":"`true` when the webhook was deleted."}],"result":[{"type":"object","properties":{"status":[{"type":"string","description":"Always `deleted` ."}]}}],"message":[{"type":"string","description":"A human-readable summary."}]}}],"examples":{"example":{"value":{"success":true,"result":{"status":"\u003cstring>"},"message":"\u003cstring>"}}}}}},"deprecated":false}},"jsLinks":[],"subdomain":"encrata","siteName":"Encrata","title":"Delete webhook - Encrata","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-13T13:43:13.030Z","originalFileLocation":"api-reference/endpoint/delete-webhook.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=\"Remove a webhook endpoint and stop its deliveries.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Encrata\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/encrata/eoAHG9XPuf6Amhi3/_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/encrata/eoAHG9XPuf6Amhi3/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/encrata/eoAHG9XPuf6Amhi3/_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/encrata/eoAHG9XPuf6Amhi3/_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/encrata/eoAHG9XPuf6Amhi3/_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/encrata/eoAHG9XPuf6Amhi3/_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/encrata/eoAHG9XPuf6Amhi3/_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/encrata/eoAHG9XPuf6Amhi3/_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/encrata/eoAHG9XPuf6Amhi3/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Delete webhook - Encrata\">\u003cmeta data-mint-head property=\"og:description\" content=\"Remove a webhook endpoint and stop its deliveries.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Encrata\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.encrata.com/api-reference/endpoint/delete-webhook\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://encrata.mintlify.site/_mintlify/api/og/v2?division=Webhooks\u0026amp;title=Delete+webhook\u0026amp;description=Remove+a+webhook+endpoint+and+stop+its+deliveries.\u0026amp;theme=f1dd8a68c493427f5d548a11\u0026amp;signature=589713ba32322e450dd28430c86abbcf415bf4e60847b37ff6b8a8d566f411f7\">\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=\"Delete webhook - Encrata\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Remove a webhook endpoint and stop its deliveries.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://encrata.mintlify.site/_mintlify/api/og/v2?division=Webhooks\u0026amp;title=Delete+webhook\u0026amp;description=Remove+a+webhook+endpoint+and+stop+its+deliveries.\u0026amp;theme=f1dd8a68c493427f5d548a11\u0026amp;signature=589713ba32322e450dd28430c86abbcf415bf4e60847b37ff6b8a8d566f411f7\">\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/encrata/eoAHG9XPuf6Amhi3/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Encrata\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#DA7756\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.encrata.com/api-reference/endpoint/delete-webhook\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/endpoint/delete-webhook.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.encrata.com/#organization\",\"name\":\"Encrata\",\"url\":\"https://docs.encrata.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/encrata/MIGYfhts8_CZTVNw/logo/light.svg?fit=max\u0026auto=format\u0026n=MIGYfhts8_CZTVNw\u0026q=85\u0026s=78c13b7e6fada3e98b35abf8413364ef\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.encrata.com#website\",\"name\":\"Encrata\",\"url\":\"https://docs.encrata.com\",\"publisher\":{\"@id\":\"https://docs.encrata.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.encrata.com/api-reference/endpoint/delete-webhook#webpage\",\"url\":\"https://docs.encrata.com/api-reference/endpoint/delete-webhook\",\"name\":\"Delete webhook\",\"description\":\"Remove a webhook endpoint and stop its deliveries.\",\"dateModified\":\"2026-10-13T13:43:13.030Z\",\"isPartOf\":{\"@id\":\"https://docs.encrata.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.encrata.com/api-reference/endpoint/delete-webhook#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.encrata.com/api-reference/endpoint/delete-webhook#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Webhooks\",\"item\":\"https://docs.encrata.com/api-reference/endpoint/webhook\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Delete webhook\",\"item\":\"https://docs.encrata.com/api-reference/endpoint/delete-webhook\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.encrata.com/api-reference/endpoint/delete-webhook#apireference\",\"headline\":\"Delete webhook\",\"name\":\"Delete webhook\",\"description\":\"Remove a webhook endpoint and stop its deliveries.\",\"url\":\"https://docs.encrata.com/api-reference/endpoint/delete-webhook\",\"mainEntityOfPage\":{\"@id\":\"https://docs.encrata.com/api-reference/endpoint/delete-webhook#webpage\"},\"dateModified\":\"2026-10-13T13:43:13.030Z\",\"publisher\":{\"@id\":\"https://docs.encrata.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.encrata.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Encrata\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Encrata\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/endpoint/delete-webhook.md","siteName":"Encrata","nav":{"global":null,"tabs":[{"tab":"Get Started","icon":"rocket","pages":[{"title":"Get Started","href":"/introduction"}]},{"tab":"Guides","icon":"book-open","pages":[{"title":"Guides","href":"/guides/workspaces"}]},{"tab":"API Reference","icon":"code","groups":[{"group":"Overview","icon":"book-open","pages":[{"title":"API Overview","href":"/api-reference/overview"},{"title":"Response Fields","href":"/api-reference/fields"}]},{"group":"Email","icon":"envelope","pages":[{"title":"Email Validity","api":"POST /api/lookup/email/validity","href":"/api-reference/endpoint/validate-email"},{"title":"Email Identity","api":"POST /api/lookup/email/identity","href":"/api-reference/endpoint/email-identity"},{"title":"Email Gender","api":"POST /api/lookup/email/gender","href":"/api-reference/endpoint/email-gender"},{"title":"Email Breaches","api":"POST /api/lookup/email/breaches","href":"/api-reference/endpoint/check-breaches"},{"title":"Email Compliance","api":"POST /api/lookup/email/compliance","href":"/api-reference/endpoint/email-compliance"}]},{"group":"Breaches","icon":"shield-halved","pages":[{"title":"Password Breaches","api":"POST /api/lookup/email/password/breaches","href":"/api-reference/endpoint/password-breaches"},{"title":"GitHub Leaks","api":"POST /api/lookup/breaches/github","href":"/api-reference/endpoint/github-leaks"},{"title":"Exposed API Keys","api":"POST /api/lookup/breaches/exposed-keys","href":"/api-reference/endpoint/exposed-api-keys"}]},{"group":"Malware","icon":"bug","pages":[{"title":"URL Scan","sidebarTitle":"URL Scan","api":"POST /api/lookup/malware/scan","href":"/api-reference/endpoint/url-scan"},{"title":"QR Code Scan","sidebarTitle":"QR Code Scan","api":"POST /api/lookup/malware/scan","href":"/api-reference/endpoint/qr-code-scan"},{"title":"Barcode Scan","sidebarTitle":"Barcode Scan","api":"POST /api/lookup/malware/scan","href":"/api-reference/endpoint/barcode-scan"},{"title":"Image Scan","sidebarTitle":"Image Scan","api":"POST /api/lookup/malware/scan","href":"/api-reference/endpoint/image-scan"},{"title":"File Scan","sidebarTitle":"File Scan","api":"POST /api/lookup/malware/scan","href":"/api-reference/endpoint/file-scan"}]},{"group":"API Keys","icon":"key","pages":[{"title":"List API Keys","api":"GET /api/account/keys","href":"/api-reference/endpoint/list-keys"},{"title":"Create API Key","api":"POST /api/account/keys","href":"/api-reference/endpoint/create-key"},{"title":"Reveal API Key","api":"GET /api/account/keys/reveal","href":"/api-reference/endpoint/reveal-key"},{"title":"Rename API Key","api":"PUT /api/account/keys","href":"/api-reference/endpoint/rename-key"},{"title":"Enable or Disable API Key","api":"PATCH /api/account/keys","href":"/api-reference/endpoint/toggle-key"},{"title":"Set API Key Credit Limit","api":"POST /api/account/keys/limit","href":"/api-reference/endpoint/set-key-limit"},{"title":"Revoke or Delete API Key","api":"DELETE /api/account/keys","href":"/api-reference/endpoint/revoke-key"}]},{"group":"Webhooks","icon":"webhook","pages":[{"title":"List webhooks","api":"GET /api/webhooks","href":"/api-reference/endpoint/webhook"},{"title":"Get webhook","api":"GET /api/webhooks/{id}","href":"/api-reference/endpoint/get-webhook"},{"title":"Create webhook","api":"POST /api/webhooks","href":"/api-reference/endpoint/create-webhook"},{"title":"Update webhook","api":"PUT /api/webhooks","description":"Change a webhook's URL, events, description, or active status.","href":"/api-reference/endpoint/update-webhook"},{"title":"Delete webhook","api":"DELETE /api/webhooks/{id}","href":"/api-reference/endpoint/delete-webhook"},{"title":"Test webhook","api":"POST /api/webhooks/test","description":"Send a synthetic event to a webhook and see how your endpoint replies.","href":"/api-reference/endpoint/test-webhook"},{"title":"List deliveries","api":"GET /api/webhooks/deliveries","href":"/api-reference/endpoint/webhook-deliveries"}]},{"group":"Account","icon":"gauge","pages":[{"title":"Credits","api":"GET /api/account/credits","href":"/api-reference/endpoint/credits"},{"title":"Health Check","api":"GET /api/health","href":"/api-reference/endpoint/health"}]}]},{"tab":"Changelog","icon":"clock-rotate-left","pages":[{"title":"Changelog","href":"/changelog"}]}]},"basePath":"","title":"Delete webhook - Encrata","deploymentId":"dpl_FZMKUpaaKiVETbfqhoUe4sPFDTmY","buildId":"dpl_FZMKUpaaKiVETbfqhoUe4sPFDTmY","dynamics":["c2aa737661","2b790eda92","b0f84f53ff"],"chunks":["OpenApiReferenceProvider-B6WFFOBL.js","utils-BN5um1KA.js","cloneDeep-C3md22mN.js","_Uint8Array-DLlL8L26.js","isObject-FP1Yky1u.js","utils-BSmbkXJR.js","addUniqueKeysToSchema-2tqcVnUE.js","snippetPresets-CtWfvr2J.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-DkKHBy30.js","isEqual-O3q7y6pq.js","usePlaygroundInputsStore-Brc5H9UJ.js","shallow-C4L4xvbs.js","getApiPlaygroundDisplay-2bxyq_aI.js","CodeSnippet-BJu8ddd5.js","CodeSnippets-dazWmoqB.js","Page-CnLhKuUV.js","getPastedJson-Chy3Qa1S.js","icon-CyO7h3jh.js","MethodPill-Dle0_91v.js","DuplicateIcon-CVvWAf4a.js","createIcon-Di07A27B.js","DynamicMarkdown-C4w9kavL.js","SectionHeading-XiBebVYC.js","axios-vUo_bRtp.js"]}