Creates an app in draft status, owned by the calling account. The app stays
visible only to your account until the Vambe team approves it; once approved it
becomes installable by any account. The response includes the signing_secret
used to sign webhook payloads โ store it securely, it is shown only on create
and on rotate.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Welcome ๐","colors":{"primary":"#2563EB","light":"#93C5FD","dark":"#1E3A8A"},"logo":"https://mintcdn.com/vambe-f69d5806/_YFOlf0qgMJ8Che1/images/fb1a23e-small-Vambe_Logo_Panda-White4x.png?fit=max\u0026auto=format\u0026n=_YFOlf0qgMJ8Che1\u0026q=85\u0026s=c84b8be7abfa14dd8e1674a247b9cc0b","favicon":"https://mintcdn.com/vambe-f69d5806/_YFOlf0qgMJ8Che1/df9628f-small-2NorthAm_Ops.png?fit=max\u0026auto=format\u0026n=_YFOlf0qgMJ8Che1\u0026q=85\u0026s=5d02cd83d033a951fa6d8bce17f58e33","api":{"playground":{"display":"interactive"},"examples":{"defaults":"required","languages":["curl","javascript","python"]}},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"vambe-f69d5806","hasAudioNarration":false,"actualSubdomain":"vambe-f69d5806","customDomains":["docs.vambe.me"],"gitSource":{"type":"github","owner":"vambeai","repo":"vambeai-backend","deployBranch":"main","contentDirectory":"public/documentation","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6ad9414d50b990b1d34cd94c","collectionId":"3212a895-ce74-46d1-acad-6010636aa2bd","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ad9414d50b990b1d34cd94c"},"feedback":{"thumbs":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6ae3908af981635292af10a8","clientVersion":"0.0.4021","searchFilterCounts":[{"language":"default","tag":"Messaging API","count":44},{"language":"default","tag":"CRM \u0026 Contacts","count":24},{"language":"default","tag":"Custom Ecommerce Apps","count":22},{"language":"default","tag":"Contact Management","count":16},{"language":"default","tag":"Webhooks","count":16},{"language":"default","tag":"Guides","count":12},{"language":"default","tag":"App management API","count":11},{"language":"default","tag":"Instagram Comment Automations","count":9},{"language":"default","tag":"Appointments","count":8},{"language":"default","tag":"Booking API","count":8}]},"assistantConfig":{},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"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":"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":"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}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":"img.sidebar-group-icon[src$=\"/icons/notepad-text-dashed.svg\"]{background-color:currentColor!important;object-position:-9999px 0;-webkit-mask:url(/images/icons/notepad-text-dashed.svg) center/contain no-repeat;mask:url(/images/icons/notepad-text-dashed.svg) center/contain no-repeat}"}],"page":{"pagePath":"reference/app-platform/create-app","slug":"/reference/app-platform/create-app","pageMetadata":{"title":"Create an app","openapi":"post /api/ecommerce-app","description":"Creates an app in draft status, owned by the calling account. Only visible to the account until approved by the Vambe team.","href":"/reference/app-platform/create-app"},"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: \"Creates an app in draft status, owned by the calling account. Only visible to the account until approved by the Vambe team.\"\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{jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,p:`p`,..._provideComponents(),...props.components};return _jsxs(_components.p,{children:[`Creates an app in `,_jsx(_components.code,{children:`draft`}),` status, owned by the calling account. The app stays\nvisible only to your account until the Vambe team approves it; once approved it\nbecomes installable by any account. The response includes the `,_jsx(_components.code,{children:`signing_secret`}),`\nused to sign webhook payloads โ store it securely, it is shown only on create\nand on `,_jsx(_components.a,{href:`/reference/app-platform/rotate-secret`,children:`rotate`}),`.`]})}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 an app","openapi":"post /api/ecommerce-app","description":"Creates an app in draft status, owned by the calling account. Only visible to the account until approved by the Vambe team.","href":"/reference/app-platform/create-app"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"operationId":"EcommerceAppController_create","summary":"Create an app","description":"Creates an app in draft status, owned by the calling account. Only visible to the account until approved by the Vambe team.","parameters":[],"requestBody":"4f4fe18f-505e-458b-8705-1b52adbf4fbd","responses":{"201":"91d5e771-74ca-4fc0-ae6f-bc2167b74d0a"},"tags":["Custom Ecommerce Apps ยท Management"],"method":"post","type":"path","servers":["abaa9908-61aa-4d34-a710-743319019f66"],"security":[],"path":"/api/ecommerce-app","baseUrlOptions":["https://api.vambe.me"],"title":"Create an app","codeSamples":[],"requestExampleLanguages":["bash","javascript","python"],"requiredOnlyExamples":true,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":2,"isRequired":true,"uniqueKey":"name","typeLabel":"string"},"description":{"type":"string","minLength":1,"isRequired":true,"uniqueKey":"description","typeLabel":"string"},"logo_url":{"type":"string","format":"uri","isRequired":true,"uniqueKey":"logo_url","typeLabel":"string\u003curi>"},"developer_name":{"type":"string","minLength":1,"isRequired":true,"uniqueKey":"developer_name","typeLabel":"string"},"contact_email":{"type":"string","format":"email","pattern":"^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$","isRequired":true,"uniqueKey":"contact_email","typeLabel":"string\u003cemail>"},"contact_phone":{"type":"string","minLength":5,"isRequired":true,"uniqueKey":"contact_phone","typeLabel":"string"},"slug":{"type":"string","minLength":2,"pattern":"^[a-z0-9-]+$","uniqueKey":"slug","typeLabel":"string"},"website_url":{"type":"string","format":"uri","uniqueKey":"website_url","typeLabel":"string\u003curi>"},"oauth":{"type":"object","properties":{"authorize_url":{"type":"string","format":"uri","uniqueKey":"oauth.authorize_url","typeLabel":"string\u003curi>"},"token_url":{"type":"string","format":"uri","uniqueKey":"oauth.token_url","typeLabel":"string\u003curi>"},"client_id":{"type":"string","minLength":1,"uniqueKey":"oauth.client_id","typeLabel":"string"},"client_secret":{"type":"string","minLength":1,"uniqueKey":"oauth.client_secret","typeLabel":"string"},"scopes":{"default":[],"type":"array","items":{"type":"string","uniqueKey":"oauth.scopes.items.[INDEX]","typeLabel":"string"},"uniqueKey":"oauth.scopes","typeLabel":"string[]"},"account_info_url":{"type":"string","format":"uri","uniqueKey":"oauth.account_info_url","typeLabel":"string\u003curi>"}},"uniqueKey":"oauth","typeLabel":"object"},"capabilities":{"type":"object","properties":{"inbound_events":{"default":[],"type":"array","items":{"type":"string","enum":["order","checkout","fulfillment","product"],"uniqueKey":"capabilities.inbound_events.items.[INDEX]","typeLabel":"enum\u003cstring>"},"uniqueKey":"capabilities.inbound_events","typeLabel":"enum\u003cstring>[]"},"outbound":{"default":{},"type":"object","properties":{"products_list":{"type":"object","properties":{"url":{"type":"string","format":"uri","isRequired":true,"uniqueKey":"capabilities.outbound.products_list.url","typeLabel":"string\u003curi>"}},"required":["url"],"uniqueKey":"capabilities.outbound.products_list","typeLabel":"object"},"order_get":{"type":"object","properties":{"url":{"type":"string","format":"uri","isRequired":true,"uniqueKey":"capabilities.outbound.order_get.url","typeLabel":"string\u003curi>"}},"required":["url"],"uniqueKey":"capabilities.outbound.order_get","typeLabel":"object"},"stock_get":{"type":"object","properties":{"url":{"type":"string","format":"uri","isRequired":true,"uniqueKey":"capabilities.outbound.stock_get.url","typeLabel":"string\u003curi>"}},"required":["url"],"uniqueKey":"capabilities.outbound.stock_get","typeLabel":"object"},"checkout_create":{"type":"object","properties":{"url":{"type":"string","format":"uri","isRequired":true,"uniqueKey":"capabilities.outbound.checkout_create.url","typeLabel":"string\u003curi>"}},"required":["url"],"uniqueKey":"capabilities.outbound.checkout_create","typeLabel":"object"},"customer_get":{"type":"object","properties":{"url":{"type":"string","format":"uri","isRequired":true,"uniqueKey":"capabilities.outbound.customer_get.url","typeLabel":"string\u003curi>"}},"required":["url"],"uniqueKey":"capabilities.outbound.customer_get","typeLabel":"object"}},"uniqueKey":"capabilities.outbound","typeLabel":"object"}},"uniqueKey":"capabilities","typeLabel":"object"}},"required":["name","description","logo_url","developer_name","contact_email","contact_phone"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"name":"\u003cstring>","description":"\u003cstring>","logo_url":"\u003cstring>","developer_name":"\u003cstring>","contact_email":"jsmith@example.com","contact_phone":"\u003cstring>","slug":"\u003cstring>","website_url":"\u003cstring>","oauth":{"authorize_url":"\u003cstring>","token_url":"\u003cstring>","client_id":"\u003cstring>","client_secret":"\u003cstring>","scopes":[],"account_info_url":"\u003cstring>"},"capabilities":{"inbound_events":[],"outbound":{}}}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"91d5e771-74ca-4fc0-ae6f-bc2167b74d0a":{"description":""}},"security":{},"servers":{"abaa9908-61aa-4d34-a710-743319019f66":{"url":"https://api.vambe.me","description":"Production Server"}}},"originalFileLocation":"openapi.json"},"subdomain":"vambe-f69d5806","siteName":"Welcome ๐","title":"Create an app - Welcome ๐","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-06-16T14:45:19.486Z","originalFileLocation":"reference/app-platform/create-app.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=\"Creates an app in draft status, owned by the calling account. Only visible to the account until approved by the Vambe team.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Welcome ๐\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/vambe-f69d5806/FNR-14vKPkm5-pk-/_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/vambe-f69d5806/FNR-14vKPkm5-pk-/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/vambe-f69d5806/FNR-14vKPkm5-pk-/_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/vambe-f69d5806/FNR-14vKPkm5-pk-/_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/vambe-f69d5806/FNR-14vKPkm5-pk-/_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/vambe-f69d5806/FNR-14vKPkm5-pk-/_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/vambe-f69d5806/FNR-14vKPkm5-pk-/_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/vambe-f69d5806/FNR-14vKPkm5-pk-/_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/vambe-f69d5806/FNR-14vKPkm5-pk-/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Create an app - Welcome ๐\">\u003cmeta data-mint-head property=\"og:description\" content=\"Creates an app in draft status, owned by the calling account. Only visible to the account until approved by the Vambe team.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Welcome ๐\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.vambe.me/reference/app-platform/create-app\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://vambe-f69d5806.mintlify.app/_mintlify/api/og/v2?division=App+management+API\u0026amp;title=Create+an+app\u0026amp;description=Creates+an+app+in+draft+status%2C+owned+by+the+calling+account.+Only+visible+to+the+account+until+approved+by+the+Vambe+team.\u0026amp;theme=a9686f96850bea0982ba3441\u0026amp;signature=a7828c51391bef42267e6191e048a8442776b0da04221e5ffd679f4be0c34167\">\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 an app - Welcome ๐\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Creates an app in draft status, owned by the calling account. Only visible to the account until approved by the Vambe team.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://vambe-f69d5806.mintlify.app/_mintlify/api/og/v2?division=App+management+API\u0026amp;title=Create+an+app\u0026amp;description=Creates+an+app+in+draft+status%2C+owned+by+the+calling+account.+Only+visible+to+the+account+until+approved+by+the+Vambe+team.\u0026amp;theme=a9686f96850bea0982ba3441\u0026amp;signature=a7828c51391bef42267e6191e048a8442776b0da04221e5ffd679f4be0c34167\">\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/vambe-f69d5806/FNR-14vKPkm5-pk-/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Welcome ๐\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#2563EB\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.vambe.me/reference/app-platform/create-app\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/reference/app-platform/create-app.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.vambe.me/#organization\",\"name\":\"Welcome ๐\",\"url\":\"https://docs.vambe.me\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/vambe-f69d5806/_YFOlf0qgMJ8Che1/images/fb1a23e-small-Vambe_Logo_Panda-White4x.png?fit=max\u0026auto=format\u0026n=_YFOlf0qgMJ8Che1\u0026q=85\u0026s=c84b8be7abfa14dd8e1674a247b9cc0b\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.vambe.me#website\",\"name\":\"Welcome ๐\",\"url\":\"https://docs.vambe.me\",\"publisher\":{\"@id\":\"https://docs.vambe.me/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.vambe.me/reference/app-platform/create-app#webpage\",\"url\":\"https://docs.vambe.me/reference/app-platform/create-app\",\"name\":\"Create an app\",\"description\":\"Creates an app in draft status, owned by the calling account. Only visible to the account until approved by the Vambe team.\",\"dateModified\":\"2026-06-16T14:45:19.486Z\",\"isPartOf\":{\"@id\":\"https://docs.vambe.me#website\"},\"breadcrumb\":{\"@id\":\"https://docs.vambe.me/reference/app-platform/create-app#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.vambe.me/reference/app-platform/create-app#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"App management API\",\"item\":\"https://docs.vambe.me/reference/app-platform/list-apps\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Create an app\",\"item\":\"https://docs.vambe.me/reference/app-platform/create-app\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.vambe.me/reference/app-platform/create-app#apireference\",\"headline\":\"Create an app\",\"name\":\"Create an app\",\"description\":\"Creates an app in draft status, owned by the calling account. Only visible to the account until approved by the Vambe team.\",\"url\":\"https://docs.vambe.me/reference/app-platform/create-app\",\"mainEntityOfPage\":{\"@id\":\"https://docs.vambe.me/reference/app-platform/create-app#webpage\"},\"dateModified\":\"2026-06-16T14:45:19.486Z\",\"publisher\":{\"@id\":\"https://docs.vambe.me/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.vambe.me#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Welcome ๐\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Welcome ๐","nav":{"global":null,"tabs":[{"tab":"Guides","icon":"book-open","pages":[{"title":"Guides","href":"/docs/quickstart"}]},{"tab":"Messaging API","icon":"messages","pages":[{"title":"Messaging API","href":"/reference/campaigns/create-campaign"}]},{"tab":"CRM \u0026 Contacts","icon":"users","pages":[{"title":"CRM \u0026 Contacts","href":"/reference/contact/get-contacts-by-days"}]},{"tab":"Analytics \u0026 Reports","icon":"chart-line","pages":[{"title":"Analytics \u0026 Reports","href":"/reference/utm-events/create-custom-utm-event"}]},{"tab":"Knowledge Base","icon":"book-open","pages":[{"title":"Knowledge Base","href":"/reference/knowledge-base/get-folders"}]},{"tab":"Ecommerce","icon":"box","pages":[{"title":"Ecommerce","href":"/reference/product/get-product-blocks"}]},{"tab":"Appointments","icon":"calendar","pages":[{"title":"Appointments","href":"/reference/booking-url/get-api-public-booking-url-urlname"}]},{"tab":"Events","icon":"bolt","pages":[{"title":"Events","href":"/reference/events-api/ingest-a-customer-event"}]},{"tab":"Webhooks","icon":"webhook","pages":[{"title":"Webhooks","href":"/reference/webhooks/get-all-webhooks-for-the-authenticated-user"}]},{"tab":"Tasks","icon":"list-check","pages":[{"title":"Tasks","href":"/reference/tasks/get-tasks"}]},{"tab":"Custom Ecommerce Apps","icon":"puzzle-piece","groups":[{"group":"Get started","icon":"rocket","expanded":true,"pages":[{"title":"Custom Ecommerce Apps Overview","href":"/docs/app-platform/introduction"},{"title":"Create Your App","href":"/docs/app-platform/create-your-app"},{"title":"OAuth Connection","href":"/docs/app-platform/oauth-connection"}]},{"group":"Integration contract","icon":"plug","expanded":true,"pages":[{"title":"Inbound Webhooks","href":"/docs/app-platform/inbound-webhooks"},{"title":"Outbound Capabilities","href":"/docs/app-platform/outbound-capabilities"},{"title":"Reference","href":"/docs/app-platform/reference"}]},{"group":"App management API","icon":"sliders","expanded":false,"pages":[{"title":"List your apps","openapi":"get /api/ecommerce-app","href":"/reference/app-platform/list-apps"},{"title":"List installable apps","openapi":"get /api/ecommerce-app/available","description":"Apps the account can install: approved apps only. A developer connects their own draft from the app checklist.","href":"/reference/app-platform/list-installable-apps"},{"title":"Create an app","openapi":"post /api/ecommerce-app","href":"/reference/app-platform/create-app"},{"title":"Get an app","openapi":"get /api/ecommerce-app/{id}","description":null,"href":"/reference/app-platform/get-app"},{"title":"List capability checks","openapi":"get /api/ecommerce-app/{id}/checks","href":"/reference/custom-ecommerce-apps-management/list-capability-checks"},{"title":"Start OAuth connection","openapi":"post /api/ecommerce-app/{id}/connect","href":"/reference/app-platform/connect-app"},{"title":"Rotate the signing secret","openapi":"post /api/ecommerce-app/{id}/rotate-secret","href":"/reference/app-platform/rotate-secret"},{"title":"Submit an app for review","openapi":"post /api/ecommerce-app/{id}/submit","href":"/reference/app-platform/submit-app"},{"title":"Update an app","openapi":"patch /api/ecommerce-app/{id}","href":"/reference/app-platform/update-app"},{"title":"Delete an app","openapi":"delete /api/ecommerce-app/{id}","href":"/reference/app-platform/delete-app"},{"title":"Test an outbound capability","openapi":"post /api/ecommerce-app/{id}/checks/capability/{capability}","href":"/reference/custom-ecommerce-apps-management/test-an-outbound-capability"}]},{"group":"Webhook API","icon":"bolt","expanded":false,"pages":[{"title":"Checkout event","openapi":"post /api/public/apps/{appId}/events/checkout","href":"/reference/app-platform/webhook-checkout"},{"title":"Fulfillment event","openapi":"post /api/public/apps/{appId}/events/fulfillment","href":"/reference/app-platform/webhook-fulfillment"},{"title":"Order event","openapi":"post /api/public/apps/{appId}/events/order","href":"/reference/app-platform/webhook-order"},{"title":"Product upsert event","openapi":"post /api/public/apps/{appId}/events/product","href":"/reference/app-platform/webhook-product"},{"title":"Product delete event","openapi":"post /api/public/apps/{appId}/events/product/delete","href":"/reference/app-platform/webhook-product-delete"}]}]}]},"title":"Create an app - Welcome ๐","buildId":"dpl_EnxDqhjaNc9a8MVa833TGULPd9uJ","deploymentId":"dpl_EnxDqhjaNc9a8MVa833TGULPd9uJ","dynamics":["c2aa737661","2b790eda92","b0f84f53ff"],"chunks":["OpenApiReferenceProvider-26-lDe7V.js","utils-CWQmgYtH.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-4-Aw3rSD.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-C2zjXYA5.js","snippetPresets-DFmpFA7C.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-FJpQavWq.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-D_GvPF7k.js","shallow-Bs2ZB0NO.js","getApiPlaygroundDisplay-DCcqJJk-.js","CodeSnippet-DzDxawVe.js","CodeSnippets-aUr7fU-7.js","Page-CT9uE8Ip.js","getPastedJson-Y1fKsj_I.js","icon-DI4zTsDr.js","MethodPill-C0nDlmSQ.js","DuplicateIcon-NUXbx2nQ.js","createIcon-BdTHrPAi.js","DynamicMarkdown-CtpgKJwj.js","SectionHeading-B3x35tOt.js","axios-vUo_bRtp.js"]}