Change the name, delivery target or event filter of an existing subscription.
On the subscription page, open the kebab menu and choose Edit.The dialog is the creation form with the current values in it, minus the type step — the delivery type is fixed for the life of the subscription. To deliver the same events somewhere else in a different way, create a second subscription.
Type
What you can change
Webhook
Name, HTTPS endpoint, event filter
Azure Storage Queue
Name, connection string and queue name, event filter
Azure Service Bus
Name, connection string and entity name, event filter
The stored connection string is never returned, so its field opens blank. Leave it and the queue or entity name untouched and the stored configuration stays as it is.Start replacing it and both fields become required together: a new connection string needs the queue or entity name that goes with it, and for Service Bus an EntityPath= in the connection string still has to match the entity name.
Click Save changes. Cancel discards everything, including changes to the filter.Changing only the name or filter preserves the subscription’s status and delivery starting point. The new filter is used when Occtoo next selects events for delivery. Events published before you save but still waiting to be processed can therefore match the new filter. Deliveries already selected keep their existing status and are not re-evaluated against it. Changing the filter does not replay events already processed.
Changing a webhook’s endpoint cancels pending deliveries and returns it to Pending verification. Verify the new endpoint to start delivery again. Events from before that verification point are not replayed.
Replacing Azure connection details cancels pending deliveries. For an active subscription, delivery starts again from the current event head. This also applies when you replace credentials for the same queue or entity, so credential replacement does not preserve the delivery backlog.
A request already in progress when you save may still complete.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Occtoo Documentation","colors":{"primary":"#E36103","light":"#FA9A17","dark":"#EB8F38"},"logo":{"light":"https://mintcdn.com/occtoo/-gNJJgSF3T9V_IbQ/logo/occtoo-light.svg?fit=max\u0026auto=format\u0026n=-gNJJgSF3T9V_IbQ\u0026q=85\u0026s=21e485640a50820820a663446d883d87","dark":"https://mintcdn.com/occtoo/-gNJJgSF3T9V_IbQ/logo/occtoo-dark.svg?fit=max\u0026auto=format\u0026n=-gNJJgSF3T9V_IbQ\u0026q=85\u0026s=d127d743e86586f660c4432069ac6e7f"},"favicon":"https://mintcdn.com/occtoo/wBeHKCIOR2NPRpYE/favicon.ico?fit=max\u0026auto=format\u0026n=wBeHKCIOR2NPRpYE\u0026q=85\u0026s=2ef86d93e26a6f82f9947f1881a0e8e8","navbar":{"links":[{"href":"https://www.occtoo.com","label":"occtoo.com"}]},"footer":{"socials":{"github":"https://github.com/Occtoo","linkedin":"https://www.linkedin.com/company/occtoo"}},"contextual":{"options":["copy","view","chatgpt","claude"],"display":"header"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"occtoo","hasAudioNarration":false,"actualSubdomain":"occtoo","customDomains":["docs.occtoo.com"],"gitSource":{"type":"github","owner":"occtoo","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"chroma":{"latestBuiltDeploymentHistoryId":"6adb5f3cb256aa4200f8bb43","collectionId":"9fb5ceeb-bec7-4a13-8fd7-bd3f632e547b","liveDeploymentHistoryId":"6adb5f3cb256aa4200f8bb43","schemaVersion":"v3"},"feedback":{"thumbs":true,"edits":true,"issues":true},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6adb5f3cb256aa4200f8bb43","clientVersion":"0.0.3990","searchFilterCounts":[{"language":"default","tag":"Documentation","count":131},{"language":"default","tag":"Guides","count":112},{"language":"default","tag":"Occtoo Studio","count":99},{"language":"default","tag":"API Reference","count":44},{"language":"default","tag":"Sources","count":33},{"language":"default","tag":"Configuration API","count":26},{"language":"default","tag":"Destinations","count":18},{"language":"default","tag":"Partner Zone","count":13},{"language":"default","tag":"Cards","count":13},{"language":"default","tag":"Get started","count":11}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-v7-file-tree","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"pause-universal-search-reconcile","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":"per-site-search-delta","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":"editor-private-page-search","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":"editor-nav-generations","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":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-agent-model-picker","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"isAtlas":false,"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":"table td:first-child>code:only-child{white-space:nowrap}.occ-hero h1,.occ-home{margin:0 auto;color:var(--occ-ink)}.occ-home{--occ-accent:rgb(var(--primary));--occ-accent-text:color-mix(in srgb, rgb(var(--primary)) 82%, #1d1916);--occ-ink:#1d1916;--occ-strong:#2c2825;--occ-muted:#565250;--occ-border:rgb(3 7 18 / 0.1);--occ-card:#ffffff;--occ-tile:rgb(var(--primary) / 0.09);--occ-panel:rgb(var(--primary) / 0.06);--occ-hover-border:rgb(var(--primary) / 0.45);--occ-on-accent:#ffffff;--occ-shadow:rgba(29, 25, 22, 0.22);max-width:72rem;padding:0 1.5rem 5rem;font-size:15px;line-height:1.55}.dark .occ-home{--occ-accent:rgb(var(--primary-light));--occ-accent-text:rgb(var(--primary-light));--occ-ink:#e5e1de;--occ-strong:#ffffff;--occ-muted:#a39d97;--occ-border:rgb(255 255 255 / 0.1);--occ-card:rgb(var(--background-dark));--occ-tile:rgb(var(--primary-light) / 0.14);--occ-panel:rgb(var(--primary-light) / 0.07);--occ-hover-border:rgb(var(--primary-light) / 0.45);--occ-on-accent:rgb(var(--background-dark));--occ-shadow:rgba(0, 0, 0, 0.55)}.occ-home a{text-decoration:none}.occ-arrow{flex:none;width:15px;height:15px}.occ-hero{text-align:center;padding:3.75rem 0 2.5rem}.occ-eyebrow{font-size:11px;font-weight:700;letter-spacing:.14em;text-transform:uppercase;color:var(--occ-accent-text);margin:0 0 1.25rem}.occ-hero h1{max-width:18ch;font-size:clamp(2.25rem,5.2vw,3.4rem);font-weight:800;letter-spacing:-.03em;line-height:1.07}.occ-dot,.occ-pill svg{color:var(--occ-accent)}.occ-hl{color:var(--occ-accent-text)}.occ-lede{max-width:44ch;margin:1.15rem auto 0;color:var(--occ-muted)}.occ-popular{display:flex;flex-wrap:wrap;align-items:center;justify-content:center;gap:.5rem;margin-top:1.65rem}.occ-pill,.occ-popular-label{font-size:12px;font-weight:600}.occ-popular-label{margin-right:.25rem;color:var(--occ-muted)}.occ-pill{display:inline-flex;align-items:center;gap:.4rem;padding:.35rem .8rem;border:1px solid var(--occ-border);border-radius:999px;background:var(--occ-card);color:var(--occ-ink);transition:border-color .15s ease,transform .15s ease}.occ-pill:hover{border-color:var(--occ-accent);transform:translateY(-1px)}.occ-pill svg{flex:none}.occ-section-head{display:flex;align-items:baseline;justify-content:space-between;gap:1rem;margin:1.1rem 0}.occ-card h3,.occ-panel-head h2,.occ-section-head h2{font-weight:700;letter-spacing:-.02em;color:var(--occ-ink)}.occ-section-head h2{margin:0;font-size:1.35rem}.occ-section-link{display:inline-flex;align-items:center;gap:.35rem;font-size:13px;font-weight:600;white-space:nowrap;color:var(--occ-accent);transition:opacity .15s ease}.occ-section-link:hover{opacity:.75}.occ-grid{display:grid;grid-template-columns:repeat(3,minmax(0,1fr));gap:1rem}.occ-card{display:flex;flex-direction:column;padding:1.5rem;border:1px solid var(--occ-border);border-radius:14px;background:var(--occ-card);transition:border-color .15s ease,box-shadow .15s ease}.occ-card:hover{border-color:var(--occ-hover-border);box-shadow:0 8px 22px -14px var(--occ-shadow)}.occ-tile{--occ-tile-size:34px;display:inline-flex;align-items:center;justify-content:center;flex:none;width:var(--occ-tile-size);height:var(--occ-tile-size);border-radius:10px;background:var(--occ-tile);color:var(--occ-accent)}.occ-card .occ-tile{--occ-tile-size:44px;border-radius:12px;margin-bottom:1.25rem}.occ-card .occ-tile svg{width:22px;height:22px}.occ-card h3{margin:0 0 .5rem;font-size:17px;letter-spacing:-.01em;color:var(--occ-strong)}.occ-card p{margin:0 0 1.35rem;font-size:13.5px;line-height:1.55;color:var(--occ-muted)}.occ-card-links{margin-top:auto}.occ-sub{display:flex;align-items:center;justify-content:space-between;gap:.5rem;padding:.6rem 0;border-top:1px solid var(--occ-border);font-size:13px;font-weight:500;color:var(--occ-accent-text);transition:color .15s ease}.occ-sub .occ-arrow{opacity:.55}.occ-sub:hover{color:var(--occ-accent)}.occ-sub:hover .occ-arrow{opacity:1}.occ-panel{margin-top:1.75rem;padding:1.5rem;border:1px solid var(--occ-border);border-radius:16px;background:var(--occ-panel)}.occ-panel-head{display:flex;flex-wrap:wrap;align-items:center;justify-content:space-between;gap:1rem;margin-bottom:1.25rem}.occ-panel-head h2{margin:.35rem 0 0;font-size:1.3rem}.occ-button{display:inline-flex;align-items:center;gap:.4rem;padding:.5rem 1rem;border-radius:8px;background:var(--occ-accent);color:var(--occ-on-accent);font-size:12.5px;font-weight:700;white-space:nowrap;transition:filter .15s ease,transform .15s ease}.occ-button:hover{filter:brightness(1.07);transform:translateY(-1px)}.occ-steps{display:grid;grid-template-columns:repeat(4,minmax(0,1fr));gap:.85rem}.occ-step{padding:.9rem;border:1px solid var(--occ-border);border-radius:12px;background:var(--occ-card)}.occ-step-num{display:inline-flex;align-items:center;justify-content:center;width:20px;height:20px;margin-bottom:.85rem;border-radius:999px;background:var(--occ-accent);color:var(--occ-on-accent);font-size:11px;font-weight:700}.occ-footer-card h3,.occ-step h4{margin:0 0 .25rem;font-size:12.5px;font-weight:700;color:var(--occ-strong)}.occ-footer-card p,.occ-step p{margin:0;font-size:11.5px;line-height:1.45;color:var(--occ-muted)}.occ-footer-grid{display:grid;grid-template-columns:repeat(2,minmax(0,1fr));gap:1rem;margin-top:1.75rem}.occ-footer-card{display:flex;align-items:flex-start;gap:.75rem;padding:1rem 1.1rem;border:1px solid var(--occ-border);border-radius:14px;background:var(--occ-card);transition:border-color .15s ease}.occ-footer-card:hover{border-color:var(--occ-hover-border)}.occ-footer-card h3{margin:0 0 .15rem;font-size:13.5px}.occ-footer-card p{font-size:12px}.occ-footer-arrow{margin-left:auto;color:var(--occ-muted)}@media (max-width:900px){.occ-grid,.occ-steps{grid-template-columns:repeat(2,minmax(0,1fr))}}@media (max-width:620px){.occ-footer-grid,.occ-grid,.occ-steps{grid-template-columns:minmax(0,1fr)}.occ-hero{padding-top:2.5rem}}"}],"page":{"pagePath":"guides/studio/events/edit-a-subscription","slug":"/guides/studio/events/edit-a-subscription","pageMetadata":{"title":"Edit a subscription","description":"Change the name, delivery target or event filter of an existing subscription.","href":"/guides/studio/events/edit-a-subscription"},"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: \"Change the name, delivery target or event filter of an existing subscription.\"\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`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,..._provideComponents(),...props.components},{Heading,OptimizedImage,Table,Warning}=_components;if(!Heading)_missingMdxReference(`Heading`,true);if(!OptimizedImage)_missingMdxReference(`OptimizedImage`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`On the subscription page, open the kebab menu and choose `,_jsx(_components.strong,{children:`Edit`}),`.`]}),`\n`,_jsx(OptimizedImage,{src:`https://mintcdn.com/occtoo/QBYMHKVxFRfbTQTY/images/guides/studio/events/edit-subscription.png?fit=max\u0026auto=format\u0026n=QBYMHKVxFRfbTQTY\u0026q=85\u0026s=c170bea156fa2d85780660524e214392`,alt:`The edit subscription dialog`,\"data-og-width\":`672`,width:`672`,\"data-og-height\":`558`,height:`558`,\"data-path\":`images/guides/studio/events/edit-subscription.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/occtoo/QBYMHKVxFRfbTQTY/images/guides/studio/events/edit-subscription.png?w=280\u0026fit=max\u0026auto=format\u0026n=QBYMHKVxFRfbTQTY\u0026q=85\u0026s=08243a50ae87dbb3a322b27d01e9ff99 280w, https://mintcdn.com/occtoo/QBYMHKVxFRfbTQTY/images/guides/studio/events/edit-subscription.png?w=560\u0026fit=max\u0026auto=format\u0026n=QBYMHKVxFRfbTQTY\u0026q=85\u0026s=2873f583df6f6f45072afbda3feff3a1 560w, https://mintcdn.com/occtoo/QBYMHKVxFRfbTQTY/images/guides/studio/events/edit-subscription.png?w=840\u0026fit=max\u0026auto=format\u0026n=QBYMHKVxFRfbTQTY\u0026q=85\u0026s=df2e6f3fc4d2aa122ac8ec544933d475 840w, https://mintcdn.com/occtoo/QBYMHKVxFRfbTQTY/images/guides/studio/events/edit-subscription.png?w=1100\u0026fit=max\u0026auto=format\u0026n=QBYMHKVxFRfbTQTY\u0026q=85\u0026s=4acbf23a7f57db374b7317a6f6d89a91 1100w, https://mintcdn.com/occtoo/QBYMHKVxFRfbTQTY/images/guides/studio/events/edit-subscription.png?w=1650\u0026fit=max\u0026auto=format\u0026n=QBYMHKVxFRfbTQTY\u0026q=85\u0026s=527f18bb0ad8e7687c4e2e5bc4abc9cd 1650w, https://mintcdn.com/occtoo/QBYMHKVxFRfbTQTY/images/guides/studio/events/edit-subscription.png?w=2500\u0026fit=max\u0026auto=format\u0026n=QBYMHKVxFRfbTQTY\u0026q=85\u0026s=57682cad4a18c4192f9894019730ac4c 2500w`}),`\n`,_jsx(_components.p,{children:`The dialog is the creation form with the current values in it, minus the type step — the delivery type is fixed for the life of the subscription. To deliver the same events somewhere else in a different way, create a second subscription.`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Type`}),_jsx(_components.th,{children:`What you can change`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Webhook`})}),_jsx(_components.td,{children:`Name, HTTPS endpoint, event filter`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Azure Storage Queue`})}),_jsx(_components.td,{children:`Name, connection string and queue name, event filter`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Azure Service Bus`})}),_jsx(_components.td,{children:`Name, connection string and entity name, event filter`})]})]})]}),`\n`,_jsxs(_components.p,{children:[`Editing the filter works exactly as it does at creation — see `,_jsx(_components.a,{href:`/guides/studio/events/event-filter`,children:`Build the event filter`}),`.`]}),`\n`,_jsx(Heading,{level:`2`,id:`azure-credentials`,children:`Azure credentials`}),`\n`,_jsx(_components.p,{children:`The stored connection string is never returned, so its field opens blank. Leave it and the queue or entity name untouched and the stored configuration stays as it is.`}),`\n`,_jsxs(_components.p,{children:[`Start replacing it and both fields become required together: a new connection string needs the queue or entity name that goes with it, and for Service Bus an `,_jsx(_components.code,{children:`EntityPath=`}),` in the connection string still has to match the entity name.`]}),`\n`,_jsx(Heading,{level:`2`,id:`what-changes-when-you-save`,children:`What changes when you save`}),`\n`,_jsxs(_components.p,{children:[`Click `,_jsx(_components.strong,{children:`Save changes`}),`. `,_jsx(_components.strong,{children:`Cancel`}),` discards everything, including changes to the filter.`]}),`\n`,_jsx(_components.p,{children:`Changing only the name or filter preserves the subscription’s status and delivery starting point. The new filter is used when Occtoo next selects events for delivery. Events published before you save but still waiting to be processed can therefore match the new filter. Deliveries already selected keep their existing status and are not re-evaluated against it. Changing the filter does not replay events already processed.`}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[`Changing a webhook’s endpoint cancels pending deliveries and returns it to `,_jsx(_components.strong,{children:`Pending verification`}),`. `,_jsx(_components.a,{href:`/guides/studio/events/verify-an-endpoint`,children:`Verify the new endpoint`}),` to start delivery again. Events from before that verification point are not replayed.`]})}),`\n`,_jsx(Warning,{children:_jsx(_components.p,{children:`Replacing Azure connection details cancels pending deliveries. For an active subscription, delivery starts again from the current event head. This also applies when you replace credentials for the same queue or entity, so credential replacement does not preserve the delivery backlog.`})}),`\n`,_jsx(_components.p,{children:`A request already in progress when you save may still complete.`})]})}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":"Edit a subscription","description":"Change the name, delivery target or event filter of an existing subscription.","href":"/guides/studio/events/edit-a-subscription"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Azure credentials","slug":"azure-credentials","depth":2,"children":[]},{"title":"What changes when you save","slug":"what-changes-when-you-save","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"occtoo","siteName":"Occtoo Documentation","title":"Edit a subscription - Occtoo Documentation","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-09-12T12:58:04.898Z","originalFileLocation":"guides/studio/events/edit-a-subscription.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=\"Change the name, delivery target or event filter of an existing subscription.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Occtoo Documentation\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/occtoo/7xHmPomztRvrPxPl/_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/occtoo/7xHmPomztRvrPxPl/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/occtoo/7xHmPomztRvrPxPl/_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/occtoo/7xHmPomztRvrPxPl/_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/occtoo/7xHmPomztRvrPxPl/_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/occtoo/7xHmPomztRvrPxPl/_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/occtoo/7xHmPomztRvrPxPl/_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/occtoo/7xHmPomztRvrPxPl/_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/occtoo/7xHmPomztRvrPxPl/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Edit a subscription - Occtoo Documentation\">\u003cmeta data-mint-head property=\"og:description\" content=\"Change the name, delivery target or event filter of an existing subscription.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Occtoo Documentation\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.occtoo.com/guides/studio/events/edit-a-subscription\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://occtoo.mintlify.app/_mintlify/api/og/v2?division=Events\u0026amp;title=Edit+a+subscription\u0026amp;description=Change+the+name%2C+delivery+target+or+event+filter+of+an+existing+subscription.\u0026amp;theme=088d609b25a5d30f2fe21826\u0026amp;signature=d7e772316ed24dc3410ae263c917f3de0e2804cd7e27d6c951dfdc61b0aedfec\">\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=\"Edit a subscription - Occtoo Documentation\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Change the name, delivery target or event filter of an existing subscription.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://occtoo.mintlify.app/_mintlify/api/og/v2?division=Events\u0026amp;title=Edit+a+subscription\u0026amp;description=Change+the+name%2C+delivery+target+or+event+filter+of+an+existing+subscription.\u0026amp;theme=088d609b25a5d30f2fe21826\u0026amp;signature=d7e772316ed24dc3410ae263c917f3de0e2804cd7e27d6c951dfdc61b0aedfec\">\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/occtoo/7xHmPomztRvrPxPl/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Occtoo Documentation\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#E36103\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.occtoo.com/guides/studio/events/edit-a-subscription\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/guides/studio/events/edit-a-subscription.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.occtoo.com/#organization\",\"name\":\"Occtoo Documentation\",\"url\":\"https://docs.occtoo.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/occtoo/-gNJJgSF3T9V_IbQ/logo/occtoo-light.svg?fit=max\u0026auto=format\u0026n=-gNJJgSF3T9V_IbQ\u0026q=85\u0026s=21e485640a50820820a663446d883d87\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.occtoo.com#website\",\"name\":\"Occtoo Documentation\",\"url\":\"https://docs.occtoo.com\",\"publisher\":{\"@id\":\"https://docs.occtoo.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.occtoo.com/guides/studio/events/edit-a-subscription#webpage\",\"url\":\"https://docs.occtoo.com/guides/studio/events/edit-a-subscription\",\"name\":\"Edit a subscription\",\"description\":\"Change the name, delivery target or event filter of an existing subscription.\",\"dateModified\":\"2026-09-12T12:58:04.898Z\",\"isPartOf\":{\"@id\":\"https://docs.occtoo.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.occtoo.com/guides/studio/events/edit-a-subscription#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.occtoo.com/guides/studio/events/edit-a-subscription#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Guides\",\"item\":\"https://docs.occtoo.com/guides/studio/overview\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Occtoo Studio\",\"item\":\"https://docs.occtoo.com/guides/studio/overview\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Events\",\"item\":\"https://docs.occtoo.com/guides/studio/events/find-subscriptions\"},{\"@type\":\"ListItem\",\"position\":4,\"name\":\"Edit a subscription\",\"item\":\"https://docs.occtoo.com/guides/studio/events/edit-a-subscription\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.occtoo.com/guides/studio/events/edit-a-subscription#article\",\"headline\":\"Edit a subscription\",\"name\":\"Edit a subscription\",\"description\":\"Change the name, delivery target or event filter of an existing subscription.\",\"url\":\"https://docs.occtoo.com/guides/studio/events/edit-a-subscription\",\"mainEntityOfPage\":{\"@id\":\"https://docs.occtoo.com/guides/studio/events/edit-a-subscription#webpage\"},\"dateModified\":\"2026-09-12T12:58:04.898Z\",\"publisher\":{\"@id\":\"https://docs.occtoo.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.occtoo.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Occtoo Documentation\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Occtoo Documentation","nav":{"global":null,"tabs":[{"tab":"Documentation","icon":"book-open","groups":[{"group":"Get started","pages":[{"title":"Start","mode":"custom","hidden":true,"href":"/index"},{"title":"Introducing Occtoo","href":"/get-started/introduction"},{"title":"Start here","href":"/get-started/overview"},{"title":"Your first Occtoo experience","href":"/get-started/my-first-occtoo-experience"},{"title":"Get data into Occtoo","href":"/get-started/get-data-into-occtoo"},{"title":"Call a destination API","href":"/get-started/call-a-destination-api"},{"title":"Occtoo MCP server","href":"/get-started/occtoo-mcp"},{"title":"Multifactor authentication","href":"/get-started/multifactor-authentication"},{"group":"Occtoo Start 1-2-3","pages":[{"title":"Occtoo Start 1–2–3","href":"/get-started/occtoo-start/overview"},{"title":"Data Activation","href":"/get-started/occtoo-start/data-activation"},{"title":"Hyper-intelligent Products","href":"/get-started/occtoo-start/hyper-intelligent-products"},{"title":"Process \u0026 New Roles","href":"/get-started/occtoo-start/process-and-roles"}]}]},{"group":"Core concepts","pages":[{"title":"Product Orchestration Engine","href":"/concepts/overview"},{"title":"Catalog","href":"/concepts/catalog"},{"title":"Card","href":"/concepts/card"},{"title":"Source","href":"/concepts/source"},{"title":"Segment","href":"/concepts/segment"},{"title":"Destination","href":"/concepts/destination"},{"title":"Destination Types","href":"/concepts/destination-types"},{"title":"Applications","sidebarTitle":"Applications","href":"/concepts/applications"}]},{"group":"Guides","pages":[{"group":"Occtoo Studio","pages":[{"title":"Introduction to Occtoo Studio","href":"/guides/studio/overview"},{"title":"Key concepts","href":"/guides/studio/key-concepts"},{"group":"Dashboard","pages":[{"title":"The Dashboard","href":"/guides/studio/dashboard/overview"},{"title":"Star a block as a favorite","href":"/guides/studio/dashboard/favorites"},{"title":"Track imports and exports","href":"/guides/studio/dashboard/notifications"},{"title":"Your profile","href":"/guides/studio/dashboard/profile"},{"title":"Switch environment","href":"/guides/studio/dashboard/switch-environments"}]},{"group":"Analytics","pages":[{"title":"The Analytics page","href":"/guides/studio/analytics/analytics-page"},{"title":"CDN usage","href":"/guides/studio/analytics/cdn-usage"},{"title":"Source and provider updates","href":"/guides/studio/analytics/source-and-provider-updates"}]},{"group":"Sources","pages":[{"title":"What is a data source \u0026 data provider?","href":"/guides/studio/sources/data-sources-and-providers"},{"title":"Find sources","href":"/guides/studio/sources/find-sources"},{"title":"The source page","href":"/guides/studio/sources/source-page"},{"title":"Create a source","href":"/guides/studio/sources/add-a-data-source"},{"title":"Edit a source","href":"/guides/studio/sources/edit-a-source"},{"title":"Purge a source","href":"/guides/studio/sources/purge-a-source"},{"title":"Delete a source","href":"/guides/studio/sources/delete-a-data-source"},{"title":"Source properties","href":"/guides/studio/sources/source-properties"},{"title":"Add or edit a property","href":"/guides/studio/sources/add-and-edit-a-property"},{"title":"Property capabilities","href":"/guides/studio/sources/property-capabilities"},{"title":"Display sections and order","href":"/guides/studio/sources/order-and-sections"},{"title":"Delete a property","href":"/guides/studio/sources/delete-a-property"},{"title":"Browse and search entries","href":"/guides/studio/sources/browse-entries"},{"title":"View an entry","href":"/guides/studio/sources/view-an-entry"},{"title":"Delete an entry","href":"/guides/studio/sources/delete-an-entry"},{"title":"Import data","href":"/guides/studio/sources/import-data"},{"title":"Import data from a CSV file","href":"/guides/studio/sources/manual-import"},{"title":"Monitor onboarding","href":"/guides/studio/sources/monitor-ingest"},{"title":"Track usage of source data","href":"/guides/studio/sources/track-usage"},{"title":"Add a data provider","href":"/guides/studio/sources/add-a-data-provider"},{"title":"Edit a data provider","href":"/guides/studio/sources/edit-a-data-provider"},{"title":"Reset a provider secret","href":"/guides/studio/sources/reset-a-client-secret"},{"title":"View code examples","href":"/guides/studio/sources/code-examples"},{"title":"Remove a data provider","href":"/guides/studio/sources/remove-a-data-provider"}]},{"group":"Cards","pages":[{"title":"Find cards","href":"/guides/studio/cards/find-cards"},{"title":"Create a card","href":"/guides/studio/cards/create-a-card"},{"title":"Card details","href":"/guides/studio/cards/card-page"},{"title":"Add a property to a card","href":"/guides/studio/cards/add-a-property"},{"title":"Update a property","href":"/guides/studio/cards/update-a-property"},{"title":"Remove a property","href":"/guides/studio/cards/remove-a-property"},{"title":"Display sections and display options","href":"/guides/studio/cards/display-sections-and-options"},{"title":"Pending changes","href":"/guides/studio/cards/pending-changes"},{"title":"Card relations","href":"/guides/studio/cards/card-relations"},{"title":"Track usage of a card","href":"/guides/studio/cards/track-usage"},{"title":"Copy a card","href":"/guides/studio/cards/copy-a-card"},{"title":"Archive and restore a card","href":"/guides/studio/cards/archive-and-restore-a-card"},{"title":"Delete a card","href":"/guides/studio/cards/delete-a-card"}]},{"group":"Segments","pages":[{"title":"Find a segment","href":"/guides/studio/segments/find-segments"},{"title":"Create a segment","href":"/guides/studio/segments/create-a-segment"},{"title":"Filter segment entries","href":"/guides/studio/segments/filter-segment-entries"},{"title":"Schedule a segment","href":"/guides/studio/segments/schedule-a-segment"},{"title":"Upload a fixed segment","href":"/guides/studio/segments/upload-a-fixed-segment"},{"title":"Create a segment category","href":"/guides/studio/segments/create-a-segment-category"},{"title":"Manage segment categories","href":"/guides/studio/segments/manage-segment-categories"},{"title":"Edit a segment","href":"/guides/studio/segments/edit-a-segment"},{"title":"Search within a segment","href":"/guides/studio/segments/search-within-a-segment"},{"title":"Export, copy, archive and delete a segment","href":"/guides/studio/segments/segment-actions"},{"title":"Track data usage of segments","href":"/guides/studio/segments/track-usage"}]},{"group":"Catalog","pages":[{"title":"Find entries","href":"/guides/studio/catalog/find-entries"},{"title":"Filter entries","href":"/guides/studio/catalog/filter-entries"},{"title":"Select entries","href":"/guides/studio/catalog/select-entries"},{"title":"The entry page","href":"/guides/studio/catalog/entry-page"},{"title":"Enrich an entry","href":"/guides/studio/catalog/enrich-an-entry"},{"title":"Entry relations","href":"/guides/studio/catalog/entry-relations"},{"title":"Change log","href":"/guides/studio/catalog/change-log"},{"title":"Used by","href":"/guides/studio/catalog/used-by"},{"title":"Add an entry","href":"/guides/studio/catalog/add-an-entry"},{"title":"Import entries","href":"/guides/studio/catalog/import-entries"},{"title":"Export entries","href":"/guides/studio/catalog/export-entries"}]},{"group":"Media","pages":[{"title":"Upload media","href":"/guides/studio/media/upload-media"}]},{"group":"Destinations","pages":[{"title":"Find destinations","href":"/guides/studio/destinations/find-destinations"},{"title":"Create a destination","href":"/guides/studio/destinations/create-a-destination"},{"title":"The destination page","href":"/guides/studio/destinations/destination-page"},{"title":"Create an endpoint","href":"/guides/studio/destinations/create-an-endpoint"},{"title":"Endpoint details","href":"/guides/studio/destinations/endpoint-content"},{"title":"Filter an endpoint with segments","href":"/guides/studio/destinations/endpoint-segments"},{"title":"Add relations to an endpoint","href":"/guides/studio/destinations/endpoint-relations"},{"title":"Delete an endpoint","href":"/guides/studio/destinations/delete-an-endpoint"},{"title":"Manage languages","href":"/guides/studio/destinations/add-languages"},{"title":"Publish a destination","href":"/guides/studio/destinations/publish-a-destination"},{"title":"Pending changes","href":"/guides/studio/destinations/pending-changes"},{"title":"Create a version","href":"/guides/studio/destinations/create-a-version"},{"title":"Delete a version","href":"/guides/studio/destinations/delete-a-version"},{"title":"See what a destination is built on","href":"/guides/studio/destinations/used-by"},{"title":"Register an application","href":"/guides/studio/destinations/register-an-application"},{"title":"Remove an application","href":"/guides/studio/destinations/remove-an-application"},{"title":"Reset a client secret","href":"/guides/studio/destinations/reset-a-client-secret"},{"title":"API documentation","href":"/guides/studio/destinations/generate-documentation"}]},{"group":"Events","pages":[{"title":"Find event subscriptions","href":"/guides/studio/events/find-subscriptions"},{"title":"Create a subscription","href":"/guides/studio/events/create-a-subscription"},{"title":"Build the event filter","href":"/guides/studio/events/event-filter"},{"title":"Signing secrets","href":"/guides/studio/events/signing-secrets"},{"title":"Verify an endpoint","href":"/guides/studio/events/verify-an-endpoint"},{"title":"The subscription page","href":"/guides/studio/events/subscription-page"},{"title":"Monitor deliveries","description":"Read the delivery chart and delivery history on a subscription, and understand what each status means.","href":"/guides/studio/events/monitor-deliveries"},{"title":"Edit a subscription","href":"/guides/studio/events/edit-a-subscription"},{"title":"Pause, resume and delete","description":"Stop a subscription temporarily or for good, and understand what each does to the events in between.","href":"/guides/studio/events/pause-resume-and-delete"}]},{"group":"Settings","pages":[{"title":"Users and roles","href":"/guides/studio/settings/users-and-roles"},{"title":"Managed tags","href":"/guides/studio/settings/managed-tags"}]}]},{"group":"Partner Zone","pages":[{"title":"Partner Zone","href":"/guides/partner-zone/overview"},{"group":"Use Partner Zone","pages":[{"title":"Navigate the Product page","href":"/guides/partner-zone/navigate-the-product-page"},{"title":"Navigate the Media page","href":"/guides/partner-zone/navigate-the-media-page"},{"title":"Use the cart","href":"/guides/partner-zone/use-the-cart"},{"title":"Use the multi search function","href":"/guides/partner-zone/multi-search"},{"title":"Use the dynamic filter","href":"/guides/partner-zone/dynamic-filters"}]},{"group":"Manage partners and users","pages":[{"title":"Handle incoming user requests","href":"/guides/partner-zone/manage/incoming-requests"},{"title":"Create \u0026 remove user","href":"/guides/partner-zone/manage/users"},{"title":"Export users to CSV","href":"/guides/partner-zone/manage/export-users"},{"title":"Create a new partner","href":"/guides/partner-zone/manage/create-a-partner"},{"title":"Update partner","href":"/guides/partner-zone/manage/update-a-partner"},{"title":"Add partner attributes","href":"/guides/partner-zone/manage/partner-attributes"},{"title":"Store partner information","href":"/guides/partner-zone/manage/partner-information"}]}]}]}]},{"tab":"API Reference","icon":"square-terminal","pages":[{"title":"API Reference","href":"/api-reference/overview"}]},{"tab":"Integrations","icon":"plug","hidden":true,"pages":[{"title":"Integrations","href":"/integrations/providers/overview"}]},{"tab":"Changelog","icon":"list-check","pages":[{"title":"Changelog","href":"/changelog"}]},{"tab":"Announcements","icon":"bullhorn","pages":[{"title":"Announcements","href":"/announcements/overview"}]}]},"title":"Edit a subscription - Occtoo Documentation","buildId":"dpl_2oYXwqkEXirXBPk8wV1FtM5USFWi","deploymentId":"dpl_2oYXwqkEXirXBPk8wV1FtM5USFWi","dynamics":["a74be98ba7"],"chunks":["zoom-image-lightbox-D7yRe3On.js","lightbox-handle-r17bVUz3.js"]}