Create a snippet: a trigger phrase and the text it expands into. Requires snippets:write on a personal key (owk_live_). Returns 403 forbidden for managed users whose organization has turned off cloud backup.
{"docsConfig":{"theme":"maple","$schema":"https://mintlify.com/docs.json","name":"OpenWhispr","colors":{"primary":"#2563EB","light":"#60A5FA","dark":"#3B82F6"},"logo":{"light":"https://mintcdn.com/openwhispr/AruQy2K60UKy6SJT/images/logo.svg?fit=max\u0026auto=format\u0026n=AruQy2K60UKy6SJT\u0026q=85\u0026s=73ef2a1292e4c40bd5bccbabe1b0767a","dark":"https://mintcdn.com/openwhispr/AruQy2K60UKy6SJT/images/logo.svg?fit=max\u0026auto=format\u0026n=AruQy2K60UKy6SJT\u0026q=85\u0026s=73ef2a1292e4c40bd5bccbabe1b0767a","href":"https://openwhispr.com"},"favicon":"https://mintcdn.com/openwhispr/AruQy2K60UKy6SJT/images/logo.svg?fit=max\u0026auto=format\u0026n=AruQy2K60UKy6SJT\u0026q=85\u0026s=73ef2a1292e4c40bd5bccbabe1b0767a","appearance":{"default":"system"},"background":{"color":{"light":"#F7F9FB","dark":"#080C16"}},"navbar":{"links":[{"href":"https://openwhispr.com","label":"Website"},{"href":"https://github.com/OpenWhispr/openwhispr","label":"GitHub"}],"primary":{"type":"button","label":"Contact support","href":"mailto:support@openwhispr.com"}},"footer":{"socials":{"github":"https://github.com/OpenWhispr/openwhispr","x":"https://x.com/openwhispr"}},"fonts":{"family":"Space Grotesk"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"openwhispr","hasAudioNarration":false,"actualSubdomain":"openwhispr","customDomains":["docs.openwhispr.com"],"gitSource":{"type":"github","owner":"openwhispr","repo":"openwhispr-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6ad89592078d5ac10ac9883d","collectionId":"80e0c993-f1ba-4ec6-b2bd-e6b3ada2d45e","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ad89592078d5ac10ac9883d"},"entitlements":{},"buildId":"6ad89592078d5ac10ac9883d","clientVersion":"0.0.4067","searchFilterCounts":[{"language":"default","tag":"Help Center","count":100},{"language":"default","tag":"API Reference","count":29},{"language":"default","tag":"Troubleshooting","count":19},{"language":"default","tag":"Account \u0026 billing","count":17},{"language":"default","tag":"Developers","count":14},{"language":"default","tag":"Dictation","count":10},{"language":"default","tag":"Platforms \u0026 compatibility","count":10},{"language":"default","tag":"Meetings","count":9},{"language":"default","tag":"Dictation problems","count":8},{"language":"default","tag":"Notes, search \u0026 sync","count":7}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":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":"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":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"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":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":true},"customCss":[{"filePath":"style.css","content":"kbd{display:inline-block;white-space:nowrap;min-width:1.75em;text-align:center;line-height:1.5}"}],"page":{"pagePath":"api-reference/snippets/create-snippet","slug":"/api-reference/snippets/create-snippet","pageMetadata":{"title":"Create snippet","description":"Create a snippet: a trigger phrase and the text it expands into. Requires snippets:write on a personal key (owk_live_). Returns 403 forbidden for managed users whose organization has turned off cloud backup.","deprecated":null,"version":null,"openapi":"/openapi.json post /snippets/create","href":"/api-reference/snippets/create-snippet","autogeneratedByOpenApi":true},"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: \"Create a snippet: a trigger phrase and the text it expands into. Requires snippets:write on a personal key (owk_live_). Returns 403 forbidden for managed users whose organization has turned off cloud backup.\"\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}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Create snippet","description":"Create a snippet: a trigger phrase and the text it expands into. Requires snippets:write on a personal key (owk_live_). Returns 403 forbidden for managed users whose organization has turned off cloud backup.","deprecated":null,"version":null,"openapi":"/openapi.json post /snippets/create","href":"/api-reference/snippets/create-snippet","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"summary":"Create snippet","description":"Create a snippet: a trigger phrase and the text it expands into. Requires snippets:write on a personal key (owk_live_). Returns 403 forbidden for managed users whose organization has turned off cloud backup.","operationId":"createSnippet","tags":["Snippets"],"requestBody":"f3200677-5276-4157-8477-d85ca586855d","responses":{"201":"b0575d5b-a085-4b40-a86f-fe5fe995cff5","400":"bae93bd8-30d7-4380-868c-5129af884481","403":"ea4df10e-ff48-4f92-b9b1-d744346a8477","409":"068a3c1d-4da4-4d5d-980f-7f1860bb8715"},"method":"post","type":"path","servers":["21f576fd-328d-419a-a4fb-df4d39242746"],"security":["28779325-6c4b-44b2-8e77-c477df2c3f4e"],"path":"/snippets/create","baseUrlOptions":["https://api.openwhispr.com/api/v1"],"title":"Create snippet","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["trigger","replacement"],"properties":{"trigger":{"type":"string","minLength":1,"maxLength":100,"description":"Phrase that fires the snippet.","isRequired":true,"uniqueKey":"trigger","typeLabel":"string"},"replacement":{"type":"string","description":"Text the trigger becomes.","isRequired":true,"uniqueKey":"replacement","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"trigger":"\u003cstring>","replacement":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"b0575d5b-a085-4b40-a86f-fe5fe995cff5":{"description":"Created snippet.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string","uniqueKey":"data.id","typeLabel":"string"},"trigger":{"type":"string","description":"Phrase that fires the snippet when dictated.","uniqueKey":"data.trigger","typeLabel":"string"},"replacement":{"type":"string","description":"Text the trigger is replaced with.","uniqueKey":"data.replacement","typeLabel":"string"},"created_at":{"type":"string","format":"date-time","uniqueKey":"data.created_at","typeLabel":"string\u003cdate-time>"},"updated_at":{"type":"string","format":"date-time","uniqueKey":"data.updated_at","typeLabel":"string\u003cdate-time>"}},"uniqueKey":"data","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"data":{"id":"\u003cstring>","trigger":"\u003cstring>","replacement":"\u003cstring>","created_at":"2023-11-07T05:31:56Z","updated_at":"2023-11-07T05:31:56Z"}}}},"exampleType":"generated"}},"exampleType":"generated"},"bae93bd8-30d7-4380-868c-5129af884481":{"description":"Validation error — missing field or trigger outside 1-100 characters.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"}},"required":["code","message"],"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"\u003cstring>","message":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"ea4df10e-ff48-4f92-b9b1-d744346a8477":{"description":"Missing snippets:write, a workspace key, or cloud backup turned off by your organization.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"}},"required":["code","message"],"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"\u003cstring>","message":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"068a3c1d-4da4-4d5d-980f-7f1860bb8715":{"description":"A snippet with that trigger already exists.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"}},"required":["code","message"],"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"\u003cstring>","message":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"28779325-6c4b-44b2-8e77-c477df2c3f4e":{"bearerAuth":{"type":"http","scheme":"bearer","description":"API key starting with owk_live_ (personal) or ow_wks_live_ (workspace — see space_id on the Notes/Folders endpoints below)","scopes":[]}}},"servers":{"21f576fd-328d-419a-a4fb-df4d39242746":{"url":"https://api.openwhispr.com/api/v1","description":"Production"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","description":"API key starting with owk_live_ (personal) or ow_wks_live_ (workspace — see space_id on the Notes/Folders endpoints below)","scopes":[]},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"API key starting with owk_live_ (personal) or ow_wks_live_ (workspace — see space_id on the Notes/Folders endpoints below)","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"}]},"originalFileLocation":"openapi.json"},"subdomain":"openwhispr","siteName":"OpenWhispr","title":"Create snippet - OpenWhispr","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-09-13T21:50:19.475Z","originalFileLocation":"api-reference/snippets/create-snippet.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=\"Create a snippet: a trigger phrase and the text it expands into. Requires snippets:write on a personal key (owk_live_). Returns 403 forbidden for managed users whose organization has turned off cloud backup.\">\u003cmeta data-mint-head name=\"application-name\" content=\"OpenWhispr\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/openwhispr/-JbKQO6qzVwxtMKU/_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/openwhispr/-JbKQO6qzVwxtMKU/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/openwhispr/-JbKQO6qzVwxtMKU/_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/openwhispr/-JbKQO6qzVwxtMKU/_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/openwhispr/-JbKQO6qzVwxtMKU/_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/openwhispr/-JbKQO6qzVwxtMKU/_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/openwhispr/-JbKQO6qzVwxtMKU/_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/openwhispr/-JbKQO6qzVwxtMKU/_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/openwhispr/-JbKQO6qzVwxtMKU/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Create snippet - OpenWhispr\">\u003cmeta data-mint-head property=\"og:description\" content=\"Create a snippet: a trigger phrase and the text it expands into. Requires snippets:write on a personal key (owk_live_). Returns 403 forbidden for managed users whose organization has turned off cloud backup.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"OpenWhispr\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.openwhispr.com/api-reference/snippets/create-snippet\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://openwhispr.mintlify.app/_mintlify/api/og/v2?division=Snippets\u0026amp;title=Create+snippet\u0026amp;description=Create+a+snippet%3A+a+trigger+phrase+and+the+text+it+expands+into.+Requires+snippets%3Awrite+on+a+personal+key+%28owk_live_%29.+Returns+403+forbidden+for+managed+users+\u0026amp;theme=6a9eec330f0aa7431277284c\u0026amp;signature=9b9c91738f4dd6fbae119875430ff41b420df4ff9e62b386b559610f1581f004\">\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=\"Create snippet - OpenWhispr\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Create a snippet: a trigger phrase and the text it expands into. Requires snippets:write on a personal key (owk_live_). Returns 403 forbidden for managed users whose organization has turned off cloud backup.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://openwhispr.mintlify.app/_mintlify/api/og/v2?division=Snippets\u0026amp;title=Create+snippet\u0026amp;description=Create+a+snippet%3A+a+trigger+phrase+and+the+text+it+expands+into.+Requires+snippets%3Awrite+on+a+personal+key+%28owk_live_%29.+Returns+403+forbidden+for+managed+users+\u0026amp;theme=6a9eec330f0aa7431277284c\u0026amp;signature=9b9c91738f4dd6fbae119875430ff41b420df4ff9e62b386b559610f1581f004\">\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/openwhispr/-JbKQO6qzVwxtMKU/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"OpenWhispr\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#2563EB\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.openwhispr.com/api-reference/snippets/create-snippet\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/snippets/create-snippet.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.openwhispr.com/#organization\",\"name\":\"OpenWhispr\",\"url\":\"https://docs.openwhispr.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/openwhispr/AruQy2K60UKy6SJT/images/logo.svg?fit=max\u0026auto=format\u0026n=AruQy2K60UKy6SJT\u0026q=85\u0026s=73ef2a1292e4c40bd5bccbabe1b0767a\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.openwhispr.com#website\",\"name\":\"OpenWhispr\",\"url\":\"https://docs.openwhispr.com\",\"publisher\":{\"@id\":\"https://docs.openwhispr.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.openwhispr.com/api-reference/snippets/create-snippet#webpage\",\"url\":\"https://docs.openwhispr.com/api-reference/snippets/create-snippet\",\"name\":\"Create snippet\",\"description\":\"Create a snippet: a trigger phrase and the text it expands into. Requires snippets:write on a personal key (owk_live_). Returns 403 forbidden for managed users whose organization has turned off cloud backup.\",\"dateModified\":\"2026-09-13T21:50:19.475Z\",\"isPartOf\":{\"@id\":\"https://docs.openwhispr.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.openwhispr.com/api-reference/snippets/create-snippet#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.openwhispr.com/api-reference/snippets/create-snippet#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Snippets\",\"item\":\"https://docs.openwhispr.com/api-reference/snippets/list-snippets\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Create snippet\",\"item\":\"https://docs.openwhispr.com/api-reference/snippets/create-snippet\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.openwhispr.com/api-reference/snippets/create-snippet#apireference\",\"headline\":\"Create snippet\",\"name\":\"Create snippet\",\"description\":\"Create a snippet: a trigger phrase and the text it expands into. Requires snippets:write on a personal key (owk_live_). Returns 403 forbidden for managed users whose organization has turned off cloud backup.\",\"url\":\"https://docs.openwhispr.com/api-reference/snippets/create-snippet\",\"mainEntityOfPage\":{\"@id\":\"https://docs.openwhispr.com/api-reference/snippets/create-snippet#webpage\"},\"dateModified\":\"2026-09-13T21:50:19.475Z\",\"publisher\":{\"@id\":\"https://docs.openwhispr.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.openwhispr.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"OpenWhispr\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"OpenWhispr","nav":{"global":null,"tabs":[{"tab":"Help Center","pages":[{"title":"Help Center","href":""}]},{"tab":"Developers","pages":[{"title":"Developers","href":"/api/overview"}]},{"tab":"API Reference","groups":[{"group":"Notes","pages":[{"title":"List notes","deprecated":null,"version":null,"openapi":"/openapi.json get /notes/list","href":"/api-reference/notes/list-notes"},{"title":"Get note","deprecated":null,"version":null,"openapi":"/openapi.json get /notes/{id}","href":"/api-reference/notes/get-note"},{"title":"Create note","deprecated":null,"version":null,"openapi":"/openapi.json post /notes/create","href":"/api-reference/notes/create-note"},{"title":"Update note","deprecated":null,"version":null,"openapi":"/openapi.json patch /notes/{id}","href":"/api-reference/notes/update-note"},{"title":"Delete note","deprecated":null,"version":null,"openapi":"/openapi.json delete /notes/{id}","href":"/api-reference/notes/delete-note"},{"title":"Search notes","deprecated":null,"version":null,"openapi":"/openapi.json post /notes/search","href":"/api-reference/notes/search-notes"}]},{"group":"Folders","pages":[{"title":"List folders","deprecated":null,"version":null,"openapi":"/openapi.json get /folders/list","href":"/api-reference/folders/list-folders"},{"title":"Create folder","deprecated":null,"version":null,"openapi":"/openapi.json post /folders/create","href":"/api-reference/folders/create-folder"}]},{"group":"Transcriptions","pages":[{"title":"Transcribe audio (beta)","deprecated":null,"version":null,"openapi":"/openapi.json post /transcribe","href":"/api-reference/transcriptions/transcribe-audio-beta"},{"title":"List transcriptions","deprecated":null,"version":null,"openapi":"/openapi.json get /transcriptions/list","href":"/api-reference/transcriptions/list-transcriptions"},{"title":"Get transcription","deprecated":null,"version":null,"openapi":"/openapi.json get /transcriptions/{id}","href":"/api-reference/transcriptions/get-transcription"},{"title":"Delete transcription","deprecated":null,"version":null,"openapi":"/openapi.json delete /transcriptions/{id}","href":"/api-reference/transcriptions/delete-transcription"},{"title":"Get note transcript","deprecated":null,"version":null,"openapi":"/openapi.json get /notes/{id}/transcript","href":"/api-reference/transcriptions/get-note-transcript"}]},{"group":"Dictionary","pages":[{"title":"List dictionary words","deprecated":null,"version":null,"openapi":"/openapi.json get /dictionary/list","href":"/api-reference/dictionary/list-dictionary-words"},{"title":"Add dictionary words","deprecated":null,"version":null,"openapi":"/openapi.json post /dictionary/create","href":"/api-reference/dictionary/add-dictionary-words"},{"title":"Update dictionary word","deprecated":null,"version":null,"openapi":"/openapi.json patch /dictionary/{id}","href":"/api-reference/dictionary/update-dictionary-word"},{"title":"Delete dictionary word","deprecated":null,"version":null,"openapi":"/openapi.json delete /dictionary/{id}","href":"/api-reference/dictionary/delete-dictionary-word"}]},{"group":"Snippets","pages":[{"title":"List snippets","description":"List your snippets with cursor pagination. Requires snippets:read on a personal key (owk_live_). Workspace keys (ow_wks_live_) get 403.","deprecated":null,"version":null,"openapi":"/openapi.json get /snippets/list","href":"/api-reference/snippets/list-snippets"},{"title":"Create snippet","deprecated":null,"version":null,"openapi":"/openapi.json post /snippets/create","href":"/api-reference/snippets/create-snippet"},{"title":"Update snippet","description":"Change a snippet's trigger, replacement, or both. At least one field is required. Requires snippets:write on a personal key (owk_live_). Returns 403 forbidden for managed users whose organization has turned off cloud backup.","deprecated":null,"version":null,"openapi":"/openapi.json patch /snippets/{id}","href":"/api-reference/snippets/update-snippet"},{"title":"Delete snippet","deprecated":null,"version":null,"openapi":"/openapi.json delete /snippets/{id}","href":"/api-reference/snippets/delete-snippet"}]},{"group":"Usage","pages":[{"title":"Get usage","deprecated":null,"version":null,"openapi":"/openapi.json get /usage","href":"/api-reference/usage/get-usage"},{"title":"Get the current credential","deprecated":null,"version":null,"openapi":"/openapi.json get /me","href":"/api-reference/usage/get-the-current-credential"}]},{"group":"Auth","pages":[{"title":"Request verification code","deprecated":null,"version":null,"openapi":"/openapi.json post /auth/email-code","href":"/api-reference/auth/request-verification-code"},{"title":"Verify code","deprecated":null,"version":null,"openapi":"/openapi.json post /auth/email-code/verify","href":"/api-reference/auth/verify-code"}]},{"group":"Keys","pages":[{"title":"Create API key","deprecated":null,"version":null,"openapi":"/openapi.json post /keys/create","href":"/api-reference/keys/create-api-key"},{"title":"List API keys","deprecated":null,"version":null,"openapi":"/openapi.json get /keys/list","href":"/api-reference/keys/list-api-keys"},{"title":"Revoke API key","deprecated":null,"version":null,"openapi":"/openapi.json post /keys/{id}/revoke","href":"/api-reference/keys/revoke-api-key"}]},{"group":"Spaces","pages":[{"title":"List spaces","deprecated":null,"version":null,"openapi":"/openapi.json get /spaces/list","href":"/api-reference/spaces/list-spaces"}]}]}]},"basePath":"","title":"Create snippet - OpenWhispr","buildId":"dpl_9VVk5y1P8k1ATeJguVngy9Q3cmbD","deploymentId":"dpl_9VVk5y1P8k1ATeJguVngy9Q3cmbD","dynamics":["c2aa737661","b0f84f53ff","a9bb46feb3","2b790eda92"],"chunks":["OpenApiReferenceProvider-DX1Meug0.js","utils-B_OMIQVC.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-ChxhRPMa.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-CuKvD8Iv.js","snippetPresets-C5d7p2hp.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","Page-BAvA99GL.js","ApiExamples-CfHcE8m4.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-C1zZV314.js","shallow-CmQhqCJn.js","getApiPlaygroundDisplay-YRo9s1O7.js","CodeSnippet-RN1MTdfk.js","CodeSnippets-DKLPHxJA.js","getPastedJson-bz0M41mU.js","icon-CsmhpPrv.js","MethodPill-CNGsVE77.js","DuplicateIcon-DilfU_Z2.js","createIcon-BdsYzQck.js","DynamicMarkdown-CbqEDjbV.js","SectionHeading-O6hXpFCN.js","axios-vUo_bRtp.js","Markdown-nKm-uidQ.js","clsx-ClVdStUn.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-CIQkMg3R.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-ImrFS4Fy.js"]}