Rotates the signing secret for a webhook subscription. A new signingSecret (whsec_...) is generated and returned in full, once. The previous secret stops verifying deliveries immediately.
Path parameters
string
required
The webhook ID to rotate the signing secret for.
Body
No request body.
curl -X POST https://api.vouchmark.com/v1/developers/webhooks/.../rotate-secret \ -H "Authorization: Bearer $TOKEN"
The previous signing secret stops verifying deliveries immediately. Update every
integration that verifies this webhook with the new signingSecret in lockstep. The full
secret is returned only here — store it securely now, it cannot be retrieved later. See
Verifying the signature.
Response fields
boolean
object
Show webhook
string
string
string
One of sandbox or live.
string
One of kyc_widget, verification, trust_monitor, disputes.
string
boolean
Whether the subscription is active and receiving deliveries.
string
The new full signing secret (whsec_...), returned once. Use it to verify the
X-Vouchmark-Signature header on deliveries.
string
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Vouchmark","description":"Verify Nigerian businesses, monitor counterparty risk, and prove trust on the web.","colors":{"primary":"#6466AE","light":"#8B8DC4","dark":"#45478B"},"logo":{"light":"https://mintcdn.com/vouchmark/vyDGY2ihe3oA_T8z/logo/logo.png?fit=max\u0026auto=format\u0026n=vyDGY2ihe3oA_T8z\u0026q=85\u0026s=4b7f5d3a985c0d54dda118e5f3eb7c3c","dark":"https://mintcdn.com/vouchmark/vyDGY2ihe3oA_T8z/logo/logo.png?fit=max\u0026auto=format\u0026n=vyDGY2ihe3oA_T8z\u0026q=85\u0026s=4b7f5d3a985c0d54dda118e5f3eb7c3c","href":"https://vouchmark.com"},"favicon":"https://mintcdn.com/vouchmark/vyDGY2ihe3oA_T8z/favicon.png?fit=max\u0026auto=format\u0026n=vyDGY2ihe3oA_T8z\u0026q=85\u0026s=8ce46c42758c5a8875f8efd3bb924904","appearance":{"default":"light","strict":true},"navbar":{"links":[{"href":"mailto:support@vouchmark.com","label":"Support"}],"primary":{"type":"button","label":"Open Dashboard","href":"https://vouchmark.com"}},"footer":{"socials":{"x":"https://x.com/vouchmark","linkedin":"https://www.linkedin.com/company/vouchmark"}},"styling":{"latex":false},"navigation":{"global":{"anchors":[{"anchor":"Dashboard","icon":"browser","href":"https://vouchmark.com"},{"anchor":"Status","icon":"signal-bars","href":"https://status.vouchmark.com"},{"anchor":"Support","icon":"envelope","href":"mailto:support@vouchmark.com"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"vouchmark","hasAudioNarration":false,"actualSubdomain":"vouchmark","customDomains":["docs.vouchmark.com"],"gitSource":{"type":"github","owner":"vouchmark-org","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6ae43def63718976c0ca212b","clientVersion":"0.0.4205","searchFilterCounts":[{"language":"default","tag":"API Reference","count":83},{"language":"default","tag":"Documentation","count":21},{"language":"default","tag":"Verifications","count":15},{"language":"default","tag":"Onboarding (KYB)","count":13},{"language":"default","tag":"Monitoring","count":9},{"language":"default","tag":"Vouch AI","count":9},{"language":"default","tag":"Core concepts","count":9},{"language":"default","tag":"Compliance","count":7},{"language":"default","tag":"Wallet \u0026 Billing","count":7},{"language":"default","tag":"Developers","count":6}]},"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":[],"page":{"pagePath":"api-reference/developers/rotate-webhook-secret","slug":"/api-reference/developers/rotate-webhook-secret","pageMetadata":{"title":"Rotate webhook secret","api":"POST /v1/developers/webhooks/{id}/rotate-secret","description":"Generate a new signing secret for a webhook. The old secret stops working immediately.","href":"/api-reference/developers/rotate-webhook-secret"},"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: \"Generate a new signing secret for a webhook. The old secret stops working immediately.\"\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`,p:`p`,strong:`strong`,..._provideComponents(),...props.components},{Expandable,Heading,ParamField,ResponseField,Warning}=_components;if(!Expandable)_missingMdxReference(`Expandable`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!ParamField)_missingMdxReference(`ParamField`,true);if(!ResponseField)_missingMdxReference(`ResponseField`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`Rotates the signing secret for a webhook subscription. A new `,_jsx(_components.code,{children:`signingSecret`}),` (`,_jsx(_components.code,{children:`whsec_...`}),`) is generated and returned in full, once. The previous secret stops verifying deliveries immediately.`]}),`\n`,_jsx(Heading,{level:`2`,id:`path-parameters`,children:`Path parameters`}),`\n`,_jsx(ParamField,{path:`id`,type:`string`,required:true,id:`param-id`,children:_jsx(_components.p,{children:`The webhook ID to rotate the signing secret for.`})}),`\n`,_jsx(Heading,{level:`2`,id:`body`,children:`Body`}),`\n`,_jsx(_components.p,{children:`No request body.`}),`\n`,`\n`,`\n`,_jsxs(_components.p,{children:[`Returns `,_jsx(_components.code,{children:`201 Created`}),`.`]}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[`The previous signing secret stops verifying deliveries `,_jsx(_components.strong,{children:`immediately`}),`. Update every\nintegration that verifies this webhook with the new `,_jsx(_components.code,{children:`signingSecret`}),` in lockstep. The full\nsecret is returned only here — store it securely now, it cannot be retrieved later. See\n`,_jsx(_components.a,{href:`/webhooks#verifying-the-signature`,children:`Verifying the signature`}),`.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`response-fields`,children:`Response fields`}),`\n`,_jsx(ResponseField,{name:`success`,type:`boolean`,id:`param-success`}),`\n`,_jsx(ResponseField,{name:`data`,type:`object`,id:`param-data`,children:_jsxs(Expandable,{title:`webhook`,children:[_jsx(ResponseField,{name:`id`,type:`string`,id:`param-id-1`}),_jsx(ResponseField,{name:`appId`,type:`string`,id:`param-app-id`}),_jsx(ResponseField,{name:`environment`,type:`string`,id:`param-environment`,children:_jsxs(_components.p,{children:[`One of `,_jsx(_components.code,{children:`sandbox`}),` or `,_jsx(_components.code,{children:`live`}),`.`]})}),_jsx(ResponseField,{name:`serviceType`,type:`string`,id:`param-service-type`,children:_jsxs(_components.p,{children:[`One of `,_jsx(_components.code,{children:`kyc_widget`}),`, `,_jsx(_components.code,{children:`verification`}),`, `,_jsx(_components.code,{children:`trust_monitor`}),`, `,_jsx(_components.code,{children:`disputes`}),`.`]})}),_jsx(ResponseField,{name:`endpoint`,type:`string`,id:`param-endpoint`}),_jsx(ResponseField,{name:`isActive`,type:`boolean`,id:`param-is-active`,children:_jsx(_components.p,{children:`Whether the subscription is active and receiving deliveries.`})}),_jsx(ResponseField,{name:`signingSecret`,type:`string`,id:`param-signing-secret`,children:_jsxs(_components.p,{children:[`The new full signing secret (`,_jsx(_components.code,{children:`whsec_...`}),`), returned once. Use it to verify the\n`,_jsx(_components.code,{children:`X-Vouchmark-Signature`}),` header on deliveries.`]})}),_jsx(ResponseField,{name:`createdAt`,type:`string`,id:`param-created-at`})]})})]})}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":"Rotate webhook secret","api":"POST /v1/developers/webhooks/{id}/rotate-secret","description":"Generate a new signing secret for a webhook. The old secret stops working immediately.","href":"/api-reference/developers/rotate-webhook-secret"}}},"mdxSourceWithNoJs":{"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`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,..._provideComponents(),...props.components},{CodeBlock,Expandable,Heading,ParamField,RequestExample,ResponseExample,ResponseField,Warning}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Expandable)_missingMdxReference(`Expandable`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!ParamField)_missingMdxReference(`ParamField`,true);if(!RequestExample)_missingMdxReference(`RequestExample`,true);if(!ResponseExample)_missingMdxReference(`ResponseExample`,true);if(!ResponseField)_missingMdxReference(`ResponseField`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`Rotates the signing secret for a webhook subscription. A new `,_jsx(_components.code,{children:`signingSecret`}),` (`,_jsx(_components.code,{children:`whsec_...`}),`) is generated and returned in full, once. The previous secret stops verifying deliveries immediately.`]}),`\n`,_jsx(Heading,{level:`2`,id:`path-parameters`,children:`Path parameters`}),`\n`,_jsx(ParamField,{path:`id`,type:`string`,required:true,id:`param-id`,children:_jsx(_components.p,{children:`The webhook ID to rotate the signing secret for.`})}),`\n`,_jsx(Heading,{level:`2`,id:`body`,children:`Body`}),`\n`,_jsx(_components.p,{children:`No request body.`}),`\n`,_jsx(RequestExample,{children:_jsx(CodeBlock,{filename:`cURL`,numberOfLines:`2`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`2`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -X`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` POST`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` https://api.vouchmark.com/v1/developers/webhooks/.../rotate-secret`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Authorization: Bearer `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`$TOKEN`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"`})]}),`\n`]})})})}),`\n`,_jsx(ResponseExample,{children:_jsx(CodeBlock,{filename:``,numberOfLines:`13`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`13`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"success\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`true`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"data\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"...\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"appId\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"...\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"environment\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"live\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"serviceType\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"kyc_widget\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"endpoint\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"https://...\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"isActive\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`true`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"signingSecret\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"whsec_...\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"createdAt\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"...\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})})}),`\n`,_jsxs(_components.p,{children:[`Returns `,_jsx(_components.code,{children:`201 Created`}),`.`]}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[`The previous signing secret stops verifying deliveries `,_jsx(_components.strong,{children:`immediately`}),`. Update every\nintegration that verifies this webhook with the new `,_jsx(_components.code,{children:`signingSecret`}),` in lockstep. The full\nsecret is returned only here — store it securely now, it cannot be retrieved later. See\n`,_jsx(_components.a,{href:`/webhooks#verifying-the-signature`,children:`Verifying the signature`}),`.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`response-fields`,children:`Response fields`}),`\n`,_jsx(ResponseField,{name:`success`,type:`boolean`,id:`param-success`}),`\n`,_jsx(ResponseField,{name:`data`,type:`object`,id:`param-data`,children:_jsxs(Expandable,{title:`webhook`,children:[_jsx(ResponseField,{name:`id`,type:`string`,id:`param-id-1`}),_jsx(ResponseField,{name:`appId`,type:`string`,id:`param-app-id`}),_jsx(ResponseField,{name:`environment`,type:`string`,id:`param-environment`,children:_jsxs(_components.p,{children:[`One of `,_jsx(_components.code,{children:`sandbox`}),` or `,_jsx(_components.code,{children:`live`}),`.`]})}),_jsx(ResponseField,{name:`serviceType`,type:`string`,id:`param-service-type`,children:_jsxs(_components.p,{children:[`One of `,_jsx(_components.code,{children:`kyc_widget`}),`, `,_jsx(_components.code,{children:`verification`}),`, `,_jsx(_components.code,{children:`trust_monitor`}),`, `,_jsx(_components.code,{children:`disputes`}),`.`]})}),_jsx(ResponseField,{name:`endpoint`,type:`string`,id:`param-endpoint`}),_jsx(ResponseField,{name:`isActive`,type:`boolean`,id:`param-is-active`,children:_jsx(_components.p,{children:`Whether the subscription is active and receiving deliveries.`})}),_jsx(ResponseField,{name:`signingSecret`,type:`string`,id:`param-signing-secret`,children:_jsxs(_components.p,{children:[`The new full signing secret (`,_jsx(_components.code,{children:`whsec_...`}),`), returned once. Use it to verify the\n`,_jsx(_components.code,{children:`X-Vouchmark-Signature`}),` header on deliveries.`]})}),_jsx(ResponseField,{name:`createdAt`,type:`string`,id:`param-created-at`})]})})]})}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":"Rotate webhook secret","api":"POST /v1/developers/webhooks/{id}/rotate-secret","description":"Generate a new signing secret for a webhook. The old secret stops working immediately.","href":"/api-reference/developers/rotate-webhook-secret"}}}},"mdxExtracts":{"tableOfContents":[{"title":"Path parameters","slug":"path-parameters","depth":2,"children":[]},{"title":"Body","slug":"body","depth":2,"children":[]},{"title":"Response fields","slug":"response-fields","depth":2,"children":[]}],"codeExamples":{"request":{"type":"RequestExample","children":[{"filename":"cURL","html":"\u003cpre class=\"shiki shiki-themes github-light-default dark-plus\" style=\"background-color:#ffffff;--shiki-dark-bg:#0B0C0E;color:#1f2328;--shiki-dark:#D4D4D4\" language=\"shellscript\">\u003ccode language=\"shellscript\" numberOfLines=\"2\">\u003cspan class=\"line\">\u003cspan style=\"color:#953800;--shiki-dark:#DCDCAA\">curl\u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\"> -X\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> POST\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> https://api.vouchmark.com/v1/developers/webhooks/.../rotate-secret\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D7BA7D\"> \\\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\"> -H\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"Authorization: Bearer \u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\">$TOKEN\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"}],"attributes":[]},"response":{"type":"ResponseExample","children":[{"filename":"","html":"\u003cpre class=\"shiki shiki-themes github-light-default dark-plus\" style=\"background-color:#ffffff;--shiki-dark-bg:#0B0C0E;color:#1f2328;--shiki-dark:#D4D4D4\" language=\"json\">\u003ccode language=\"json\" numberOfLines=\"13\">\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">{\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"success\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\">true\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"data\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"id\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"...\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"appId\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"...\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"environment\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"live\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"serviceType\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"kyc_widget\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"endpoint\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"https://...\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"isActive\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\">true\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"signingSecret\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"whsec_...\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"createdAt\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"...\"\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> }\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">}\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"}],"attributes":[]}},"endpoint":{"title":"Rotate webhook secret","path":"/v1/developers/webhooks/{id}/rotate-secret","method":"post","request":{"security":[],"parameters":{"query":{},"header":{},"cookie":{},"path":{"id":{"schema":[{"type":"string","description":"The webhook ID to rotate the signing secret for.","required":true}]}}},"body":{}},"response":{"200":{"application/json":{"schemaArray":[{"type":"object","properties":{"success":[{"type":"boolean"}],"data":[{"type":"object","properties":{"id":[{"type":"string"}],"appId":[{"type":"string"}],"environment":[{"type":"string","description":"One of `sandbox` or `live` ."}],"serviceType":[{"type":"string","description":"One of `kyc_widget` , `verification` , `trust_monitor` , `disputes` ."}],"endpoint":[{"type":"string"}],"isActive":[{"type":"boolean","description":"Whether the subscription is active and receiving deliveries."}],"signingSecret":[{"type":"string","description":"The new full signing secret ( `whsec_...` ), returned once. Use it to verify the `X-Vouchmark-Signature` header on deliveries."}],"createdAt":[{"type":"string"}]}}]}}],"examples":{"example":{"value":{"success":true,"data":{"id":"\u003cstring>","appId":"\u003cstring>","environment":"\u003cstring>","serviceType":"\u003cstring>","endpoint":"\u003cstring>","isActive":true,"signingSecret":"\u003cstring>","createdAt":"\u003cstring>"}}}}}}},"deprecated":false}},"jsLinks":[],"subdomain":"vouchmark","siteName":"Vouchmark","title":"Rotate webhook secret - Vouchmark","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-06-28T00:41:39.175Z","originalFileLocation":"api-reference/developers/rotate-webhook-secret.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=\"light\";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=\"light\"}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=\"Generate a new signing secret for a webhook. The old secret stops working immediately.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Vouchmark\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/vouchmark/oiIZI56Q3NT85JaQ/_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/vouchmark/oiIZI56Q3NT85JaQ/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/vouchmark/oiIZI56Q3NT85JaQ/_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/vouchmark/oiIZI56Q3NT85JaQ/_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/vouchmark/oiIZI56Q3NT85JaQ/_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/vouchmark/oiIZI56Q3NT85JaQ/_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/vouchmark/oiIZI56Q3NT85JaQ/_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/vouchmark/oiIZI56Q3NT85JaQ/_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/vouchmark/oiIZI56Q3NT85JaQ/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Rotate webhook secret - Vouchmark\">\u003cmeta data-mint-head property=\"og:description\" content=\"Generate a new signing secret for a webhook. The old secret stops working immediately.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Vouchmark\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.vouchmark.com/api-reference/developers/rotate-webhook-secret\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://vouchmark.mintlify.site/_mintlify/api/og/v2?division=Developers\u0026amp;title=Rotate+webhook+secret\u0026amp;description=Generate+a+new+signing+secret+for+a+webhook.+The+old+secret+stops+working+immediately.\u0026amp;theme=537dc3d63a6ec063e2d1a23f\u0026amp;signature=ab094fbfc9a892a7fee6a0b71ceed73130b9d21c81804ace3470780140f92f0a\">\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=\"Rotate webhook secret - Vouchmark\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Generate a new signing secret for a webhook. The old secret stops working immediately.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://vouchmark.mintlify.site/_mintlify/api/og/v2?division=Developers\u0026amp;title=Rotate+webhook+secret\u0026amp;description=Generate+a+new+signing+secret+for+a+webhook.+The+old+secret+stops+working+immediately.\u0026amp;theme=537dc3d63a6ec063e2d1a23f\u0026amp;signature=ab094fbfc9a892a7fee6a0b71ceed73130b9d21c81804ace3470780140f92f0a\">\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/vouchmark/oiIZI56Q3NT85JaQ/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Vouchmark\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#6466AE\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.vouchmark.com/api-reference/developers/rotate-webhook-secret\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/developers/rotate-webhook-secret.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.vouchmark.com/#organization\",\"name\":\"Vouchmark\",\"url\":\"https://docs.vouchmark.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/vouchmark/vyDGY2ihe3oA_T8z/logo/logo.png?fit=max\u0026auto=format\u0026n=vyDGY2ihe3oA_T8z\u0026q=85\u0026s=4b7f5d3a985c0d54dda118e5f3eb7c3c\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.vouchmark.com#website\",\"name\":\"Vouchmark\",\"url\":\"https://docs.vouchmark.com\",\"publisher\":{\"@id\":\"https://docs.vouchmark.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.vouchmark.com/api-reference/developers/rotate-webhook-secret#webpage\",\"url\":\"https://docs.vouchmark.com/api-reference/developers/rotate-webhook-secret\",\"name\":\"Rotate webhook secret\",\"description\":\"Generate a new signing secret for a webhook. The old secret stops working immediately.\",\"dateModified\":\"2026-06-28T00:41:39.175Z\",\"isPartOf\":{\"@id\":\"https://docs.vouchmark.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.vouchmark.com/api-reference/developers/rotate-webhook-secret#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.vouchmark.com/api-reference/developers/rotate-webhook-secret#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Developers\",\"item\":\"https://docs.vouchmark.com/api-reference/developers/list-api-keys\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Rotate webhook secret\",\"item\":\"https://docs.vouchmark.com/api-reference/developers/rotate-webhook-secret\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.vouchmark.com/api-reference/developers/rotate-webhook-secret#apireference\",\"headline\":\"Rotate webhook secret\",\"name\":\"Rotate webhook secret\",\"description\":\"Generate a new signing secret for a webhook. The old secret stops working immediately.\",\"url\":\"https://docs.vouchmark.com/api-reference/developers/rotate-webhook-secret\",\"mainEntityOfPage\":{\"@id\":\"https://docs.vouchmark.com/api-reference/developers/rotate-webhook-secret#webpage\"},\"dateModified\":\"2026-06-28T00:41:39.175Z\",\"publisher\":{\"@id\":\"https://docs.vouchmark.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.vouchmark.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Vouchmark\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Vouchmark\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/developers/rotate-webhook-secret.md","siteName":"Vouchmark","nav":{"global":{"anchors":[{"anchor":"Dashboard","icon":"browser","href":"https://vouchmark.com"},{"anchor":"Status","icon":"signal-bars","href":"https://status.vouchmark.com"},{"anchor":"Support","icon":"envelope","href":"mailto:support@vouchmark.com"}]},"tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":"/introduction"}]},{"tab":"SDKs","pages":[{"title":"SDKs","href":"/sdks/overview"}]},{"tab":"API Reference","groups":[{"group":"Overview","pages":[{"title":"API overview","href":"/api-reference/introduction"}]},{"group":"Auth","pages":[{"title":"Sign up","api":"POST /v1/signup","href":"/api-reference/auth/signup"},{"title":"Log in","api":"POST /v1/login","href":"/api-reference/auth/login"},{"title":"Refresh token","api":"POST /v1/refresh-token","href":"/api-reference/auth/refresh-token"},{"title":"Log out","api":"POST /v1/logout","href":"/api-reference/auth/logout"}]},{"group":"Companies","pages":[{"title":"List my companies","api":"GET /v1/dashboard/my-companies","href":"/api-reference/companies/list"},{"title":"Get a company","api":"GET /v1/dashboard/company-details?companyId={companyId}","href":"/api-reference/companies/get"},{"title":"Edit a company","api":"POST /v1/edit-company/{companyId}","href":"/api-reference/companies/edit"},{"title":"Resolve FIRS TIN","api":"POST /v1/check-firstin","href":"/api-reference/companies/check-firs-tin"}]},{"group":"Verifications","pages":[{"title":"Verify TIN (upload TCC)","api":"POST /v1/verifyTin","href":"/api-reference/verifications/verify-tin"},{"title":"Verify JTB TIN","api":"POST /v1/verifyJtbTin","href":"/api-reference/verifications/verify-jtb-tin"},{"title":"Verify utility bill","api":"POST /v1/verifyBill","href":"/api-reference/verifications/verify-bill"},{"title":"Verify utility bill (image)","api":"POST /v1/verify-utility-bill/image","href":"/api-reference/verifications/verify-bill-image"},{"title":"Verify utility bill (manual)","api":"POST /v1/verify-utility-bill/manual","href":"/api-reference/verifications/verify-bill-manual"},{"title":"Verify CAC documents","api":"POST /v1/verifyCacAndReport","href":"/api-reference/verifications/verify-cac"},{"title":"Verify one CAC document","api":"POST /v1/verifyCacDocument","href":"/api-reference/verifications/verify-cac-document"},{"title":"Get CAC verification status","api":"GET /v1/cacVerificationStatus/{companyId}","href":"/api-reference/verifications/cac-status"},{"title":"Check verification progress","api":"POST /v1/checkVerificationProgress","href":"/api-reference/verifications/check-progress"},{"title":"Physical address verification","api":"POST /v1/physicalAddress","href":"/api-reference/verifications/physical-address"}]},{"group":"Onboarding (KYB)","pages":[{"title":"Module catalog","api":"GET /v1/kyb/modules","href":"/api-reference/onboarding/module-catalog"},{"title":"List widgets","api":"GET /v1/kyb/widgets","href":"/api-reference/onboarding/list-widgets"},{"title":"Create widget","api":"POST /v1/kyb/widgets","href":"/api-reference/onboarding/create-widget"},{"title":"Get widget","api":"GET /v1/kyb/widgets/{id}","href":"/api-reference/onboarding/get-widget"},{"title":"Update widget","api":"PATCH /v1/kyb/widgets/{id}","href":"/api-reference/onboarding/update-widget"},{"title":"Set widget status","api":"PATCH /v1/kyb/widgets/{id}/status","href":"/api-reference/onboarding/set-widget-status"},{"title":"Delete widget","api":"DELETE /v1/kyb/widgets/{id}","href":"/api-reference/onboarding/delete-widget"},{"title":"Widget cost estimate","api":"GET /v1/kyb/widgets/{id}/estimate","href":"/api-reference/onboarding/cost-estimate"},{"title":"List applicants","api":"GET /v1/kyb/applicants","href":"/api-reference/onboarding/list-applicants"},{"title":"Get applicant","api":"GET /v1/kyb/applicants/{applicantId}","href":"/api-reference/onboarding/get-applicant"},{"title":"Create applicant","api":"POST /v1/kyb/widgets/{id}/applicants","href":"/api-reference/onboarding/create-applicant"},{"title":"Run module","api":"POST /v1/kyb/applicants/{applicantId}/modules/{moduleId}/run","href":"/api-reference/onboarding/run-module"},{"title":"Submit applicant","api":"POST /v1/kyb/applicants/{applicantId}/submit","href":"/api-reference/onboarding/submit-applicant"}]},{"group":"Widget Embed (Runtime)","pages":[{"title":"Get embed config","api":"GET /v1/widget/embed/config","href":"/api-reference/onboarding/embed-config"},{"title":"Create embed session","api":"POST /v1/widget/embed/sessions","href":"/api-reference/onboarding/create-session"},{"title":"Resume embed session","api":"GET /v1/widget/embed/sessions/{sessionId}","href":"/api-reference/onboarding/resume-session"},{"title":"Save session answers","api":"PATCH /v1/widget/embed/sessions/{sessionId}/answers","href":"/api-reference/onboarding/save-answers"},{"title":"Upload session attachment","api":"POST /v1/widget/embed/sessions/{sessionId}/uploads","href":"/api-reference/onboarding/upload-attachment"},{"title":"Submit embed session","api":"POST /v1/widget/embed/sessions/{sessionId}/submit","href":"/api-reference/onboarding/submit-session"}]},{"group":"Trust Badge","pages":[{"title":"Verify a badge token","api":"GET /v1/trust-badge/verify","href":"/api-reference/trust-badge/verify"},{"title":"Get my badge","api":"GET /v1/trust-badge/my-badge","href":"/api-reference/trust-badge/my-badge"}]},{"group":"Monitoring","pages":[{"title":"List monitored vendors","api":"GET /v1/monitoring/vendors","href":"/api-reference/monitoring/list-vendors"},{"title":"Get vendor profile","api":"GET /v1/monitoring/vendors/{vendorId}","href":"/api-reference/monitoring/vendor-profile"},{"title":"List vendor events","api":"GET /v1/monitoring/vendors/{vendorId}/events","href":"/api-reference/monitoring/vendor-events"},{"title":"Vendor score history","api":"GET /v1/monitoring/vendors/{vendorId}/score-history","href":"/api-reference/monitoring/score-history"},{"title":"Media mentions","api":"GET /v1/monitoring/media-mentions","href":"/api-reference/monitoring/media-mentions"},{"title":"List alerts","api":"GET /v1/monitoring/alerts","href":"/api-reference/monitoring/alerts"},{"title":"Add to watchlist","api":"POST /v1/monitoring/vendors/watchlist","href":"/api-reference/monitoring/add-to-watchlist"},{"title":"Remove from watchlist","api":"DELETE /v1/monitoring/vendors/watchlist/{vendorId}","href":"/api-reference/monitoring/remove-from-watchlist"},{"title":"Get watchlist capacity","api":"GET /v1/monitoring/watchlist/capacity","href":"/api-reference/monitoring/watchlist-limits"}]},{"group":"Investigations","pages":[{"title":"List investigation reports","api":"GET /v1/investigation/reports","href":"/api-reference/investigations/list-reports"},{"title":"Get investigation report","api":"GET /v1/investigation/reports/{reportId}","href":"/api-reference/investigations/get-report"}]},{"group":"Disputes","pages":[{"title":"List disputes","api":"GET /v1/disputes","href":"/api-reference/disputes/list-disputes"},{"title":"Submit dispute","api":"POST /v1/disputes","href":"/api-reference/disputes/submit-dispute"},{"title":"Get dispute","api":"GET /v1/disputes/{disputeId}","href":"/api-reference/disputes/get-dispute"}]},{"group":"Vouch AI","pages":[{"title":"Start new chat","api":"POST /v1/chat/new","href":"/api-reference/vouch-ai/new-chat"},{"title":"Send message","api":"POST /v1/chat/{chatId}/message","href":"/api-reference/vouch-ai/send-message"},{"title":"Stream message","api":"POST /v1/chat/{chatId}/stream","href":"/api-reference/vouch-ai/stream-message"},{"title":"Chat history","api":"GET /v1/chat/history","href":"/api-reference/vouch-ai/chat-history"},{"title":"Get chat","api":"GET /v1/chat/{chatId}","href":"/api-reference/vouch-ai/get-chat"},{"title":"Rename chat","api":"PATCH /v1/chat/{chatId}/title","href":"/api-reference/vouch-ai/rename-chat"},{"title":"Delete chat","api":"DELETE /v1/chat/{chatId}","href":"/api-reference/vouch-ai/delete-chat"},{"title":"Quick chat","api":"POST /v1/chat/quick","href":"/api-reference/vouch-ai/quick-chat"},{"title":"AI company overview","api":"POST /v1/company/ai-overview","href":"/api-reference/vouch-ai/ai-overview"}]},{"group":"Compliance","pages":[{"title":"List obligations","api":"GET /v1/compliance/obligations","href":"/api-reference/compliance/list-obligations"},{"title":"Upcoming obligations","api":"GET /v1/compliance/obligations/upcoming","href":"/api-reference/compliance/upcoming"},{"title":"Create obligation","api":"POST /v1/compliance/obligations","href":"/api-reference/compliance/create-obligation"},{"title":"Update obligation","api":"PATCH /v1/compliance/obligations/{obligationId}","href":"/api-reference/compliance/update-obligation"},{"title":"Complete obligation","api":"POST /v1/compliance/obligations/{obligationId}/complete","href":"/api-reference/compliance/complete-obligation"},{"title":"Delete obligation","api":"DELETE /v1/compliance/obligations/{obligationId}","href":"/api-reference/compliance/delete-obligation"},{"title":"Seed obligations","api":"POST /v1/compliance/seed","href":"/api-reference/compliance/seed"}]},{"group":"Wallet \u0026 Billing","pages":[{"title":"Get wallet","api":"GET /v1/wallet","href":"/api-reference/wallet/get-wallet"},{"title":"List transactions","api":"GET /v1/wallet/transactions","href":"/api-reference/wallet/transactions"},{"title":"Top up wallet","api":"POST /v1/wallet/topup","href":"/api-reference/wallet/topup"},{"title":"Verify top-up","api":"GET /v1/wallet/topup/verify","href":"/api-reference/wallet/verify-topup"},{"title":"Update auto top-up","api":"PATCH /v1/wallet/auto-top-up","href":"/api-reference/wallet/auto-topup"},{"title":"Update threshold","api":"PATCH /v1/wallet/threshold","href":"/api-reference/wallet/threshold"},{"title":"Pricing rates","api":"GET /v1/wallet/pricing-rates","href":"/api-reference/wallet/pricing-rates"}]},{"group":"Developers","pages":[{"title":"List API keys","api":"GET /v1/developers/api-keys","href":"/api-reference/developers/list-api-keys"},{"title":"Rotate API key","api":"POST /v1/developers/api-keys/rotate","href":"/api-reference/developers/rotate-api-key"},{"title":"List webhooks","api":"GET /v1/developers/webhooks","href":"/api-reference/developers/list-webhooks"},{"title":"Create webhook","api":"POST /v1/developers/webhooks","description":"Register a webhook subscription for a service.","href":"/api-reference/developers/create-webhook"},{"title":"Rotate webhook secret","api":"POST /v1/developers/webhooks/{id}/rotate-secret","href":"/api-reference/developers/rotate-webhook-secret"},{"title":"Delete webhook","api":"DELETE /v1/developers/webhooks/{id}","description":"Remove a webhook subscription. Deliveries stop immediately.","href":"/api-reference/developers/delete-webhook"}]}]}]},"basePath":"","title":"Rotate webhook secret - Vouchmark","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"]}