CreateOrganisation creates a new Organisation with the current user as the owner. A user can create as many Organisations as they like, but each has their own billing profile and must be on a paid plan to use certain features.
Slug is a unique, lower-cased, human-readable identifier for this Organisation. It may only contain alphanumeric characters and hyphens, and must start with a letter.
SystemServiceAccountClientID is the client ID of the system service account for this Organisation. This is automatically created when the Organisation is created and is used by internal services which must authenticate on behalf of the Organisation. It cannot be deleted.
{"docsConfig":{"theme":"almond","$schema":"https://mintlify.com/docs.json","name":"Versori User Documentation","colors":{"primary":"#6EB0D8","light":"#6EB0D8","dark":"#6EB0D8"},"logo":{"light":"https://mintcdn.com/versori/PWNCaMS5nGiiWoff/logo/versori-logo-wordmark.svg?fit=max\u0026auto=format\u0026n=PWNCaMS5nGiiWoff\u0026q=85\u0026s=be10819ca139d000a6edaef35334c0af","dark":"https://mintcdn.com/versori/PWNCaMS5nGiiWoff/logo/versori-logo-wordmark-white.svg?fit=max\u0026auto=format\u0026n=PWNCaMS5nGiiWoff\u0026q=85\u0026s=1568a99dadb6fa8dfc83009eba877497"},"favicon":"https://mintcdn.com/versori/PWNCaMS5nGiiWoff/logo/versori-logo.svg?fit=max\u0026auto=format\u0026n=PWNCaMS5nGiiWoff\u0026q=85\u0026s=1765cb3e4363526dd85cf7c576a8f68f","api":{"openapi":["openapi/connect-api-v1.yaml","openapi/embedded-api-v1.yaml","openapi/organisations-api-v1.yaml","openapi/switchboard-api-v1alpha1.yaml","openapi/platform-api.yaml"],"playground":{"display":"interactive","proxy":false},"mdx":{"auth":{"method":"bearer","name":"Authorization"},"server":["https://platform.versori.com/api"]}},"background":{"decoration":"gradient","color":{"light":"#ffffff","dark":"#151919"}},"search":{"prompt":"Search the docs..."},"interaction":{"drilldown":false},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"versori","hasAudioNarration":false,"actualSubdomain":"versori","customDomains":["docs.versori.com"],"gitSource":{"type":"github","owner":"versori","repo":"user-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6ad09d9413e5d952c6a7407c","collectionId":"314b2d25-0631-41c2-aeae-fdf8104d942c","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ad09d9413e5d952c6a7407c"},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6ad09d9413e5d952c6a7407c","clientVersion":"0.0.3965","searchFilterCounts":[{"language":"default","tag":"API Reference","count":525},{"language":"default","tag":"Platform API","count":115},{"language":"default","tag":"Switchboard API","count":82},{"language":"default","tag":"Endpoints","count":62},{"language":"default","tag":"Connect API","count":41},{"language":"default","tag":"Organisations API","count":38},{"language":"default","tag":"Documentation","count":32},{"language":"default","tag":"projects","count":32},{"language":"default","tag":"User Guide","count":31},{"language":"default","tag":"CLI","count":27}]},"assistantConfig":{},"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":"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":"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}],"isAtlas":false,"googleFontsInlined":true},"customCss":[{"filePath":"style.css","content":"#content-area.max-w-xl{max-width:64rem}.whitespace-pre-line{white-space:unset}"}],"page":{"pagePath":"api-reference/organisations-api/create-organisation","slug":"/api-reference/organisations-api/create-organisation","pageMetadata":{"title":"Create Organisation","description":"CreateOrganisation creates a new Organisation with the current user as the owner. A user can create as many Organisations as they like, but each has their own billing profile and must be on a paid plan to use certain features.","deprecated":null,"version":null,"openapi":"/openapi/organisations-api-v1.yaml post /organisations","href":"/api-reference/organisations-api/create-organisation","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: \"CreateOrganisation creates a new Organisation with the current user as the owner. A user can create as many Organisations as they like, but each has their own billing profile and must be on a paid plan to use certain features.\"\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 Organisation","description":"CreateOrganisation creates a new Organisation with the current user as the owner. A user can create as many Organisations as they like, but each has their own billing profile and must be on a paid plan to use certain features.","deprecated":null,"version":null,"openapi":"/openapi/organisations-api-v1.yaml post /organisations","href":"/api-reference/organisations-api/create-organisation","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"operationId":"CreateOrganisation","summary":"Create Organisation","description":"CreateOrganisation creates a new Organisation with the current user as the owner. A user can create as many Organisations as they like, but each has their own billing profile and must be on a paid plan to use certain features.","requestBody":"58ff2c77-c9f2-49f7-b321-55c1df5d268b","responses":{"201":"4e4a8db3-fd49-40ac-a69a-c6d699e48ec0","default":"7fd3ea14-3c30-465a-944d-7d9e4cb43cba"},"method":"post","type":"path","servers":["2100a169-b143-4bd5-a1b5-259cb73d8f4d","9efcf180-79f6-4875-8d92-dc0cc8fe8b07"],"security":[],"path":"/organisations","baseUrlOptions":["https://platform.versori.com/api/organisations/v1","http://localhost:8081/v1"],"title":"Create Organisation","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated","disableProxy":true},"dependencies":{"parameters":{},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"slug":{"description":"Slug is a unique, lower-cased, human-readable identifier for this Organisation. It may only contain alphanumeric characters and hyphens, and must start with a letter.","type":"string","regex":"^[a-z][a-z0-9-]{2}$","isRequired":true,"uniqueKey":"slug","typeLabel":"string"},"displayName":{"type":"string","isRequired":true,"uniqueKey":"displayName","typeLabel":"string"}},"required":["slug","displayName"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"slug":"\u003cstring>","displayName":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"4e4a8db3-fd49-40ac-a69a-c6d699e48ec0":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","format":"ulid","x-go-name":"ID","x-go-type":"ulid.ULID","x-go-type-import":{"path":"versori.dev/vergo/ulid"},"isRequired":true,"uniqueKey":"id","typeLabel":"string\u003culid>"},"slug":{"type":"string","isRequired":true,"uniqueKey":"slug","typeLabel":"string"},"displayName":{"type":"string","isRequired":true,"uniqueKey":"displayName","typeLabel":"string"},"owner":{"type":"string","isRequired":true,"uniqueKey":"owner","typeLabel":"string"},"billing":{"description":"Billing contains information about the billing status of an Organisation.","type":"object","properties":{"platformId":{"description":"PlatformID is an internal identifier to link the Billing profile to Versori's underlying billing platform.","type":"string","isRequired":true,"uniqueKey":"billing.platformId","typeLabel":"string"},"customerId":{"description":"CustomerID is the identifier for the customer in the billing platform.","type":"string","isRequired":true,"uniqueKey":"billing.customerId","typeLabel":"string"},"billingEmail":{"description":"BillingEmail is the email address used for billing purposes, i.e. sending invoices. This does not take up a seat in the Organisation plan.","type":"string","isRequired":true,"uniqueKey":"billing.billingEmail","typeLabel":"string"},"isSubscriptionActive":{"description":"IsSubscriptionActive is true if the Organisation has an active subscription, otherwise false. An active subscription is a valid subscription on a free trial or one that has up-to-date payment methods. A value of 1 means the subscription is active.","type":"integer","x-go-type":"int8","isRequired":true,"uniqueKey":"billing.isSubscriptionActive","typeLabel":"integer"},"billingPeriodStart":{"description":"BillingPeriodStart is the start date of the current billing period. This is the date at which the current billing period started. This time should always be in UTC.","type":"string","format":"date","isRequired":true,"uniqueKey":"billing.billingPeriodStart","typeLabel":"string\u003cdate>"},"billingPeriodEnd":{"description":"BillingPeriodEnd is the end date of the current billing period. This is the date at which the current billing period ends. This time should always be in UTC.","type":"string","format":"date","isRequired":true,"uniqueKey":"billing.billingPeriodEnd","typeLabel":"string\u003cdate>"},"platformType":{"type":"string","description":"PlatformType denotes which billing platform is used for this billing profile. Currently only \"stripe\" is supported, and can be used to infer data type of other objects which are not documented as part of this API.\nSee Subscription#raw for an example.","uniqueKey":"billing.platformType","typeLabel":"string"},"subscriptionId":{"description":"SubscriptionID is the identifier for the subscription in the billing platform. This is used to manage the subscription, i.e. update the subscription, cancel the subscription, etc.","type":"string","uniqueKey":"billing.subscriptionId","typeLabel":"string"},"recentSubscriptions":{"description":"RecentSubscriptions is a list of subscriptions for the Organisation. This will only include the first 10 subscriptions, if there are more then the GetSubscriptions operation (to be implemented) should be used.","type":"array","items":{"description":"Subscription contains information of the actual subscription in Versori's internal billing platform.","type":"object","properties":{"id":{"type":"string","uniqueKey":"billing.recentSubscriptions.items.[INDEX].id","typeLabel":"string"},"status":{"description":"Status is the current status of the subscription, i.e. \"active\".","type":"string","enum":["active","unpaid","trialing","cancelled"],"uniqueKey":"billing.recentSubscriptions.items.[INDEX].status","typeLabel":"enum\u003cstring>"},"rawData":{"description":"RawData is the underlying subscription object from the billing platform. This will typically be a Stripe [Subscription](https://stripe.com/docs/api/subscriptions/object) but is implied from the `Billing#platformType` property.","uniqueKey":"billing.recentSubscriptions.items.[INDEX].rawData","typeLabel":"any"}},"uniqueKey":"billing.recentSubscriptions.items.[INDEX]","typeLabel":"object"},"uniqueKey":"billing.recentSubscriptions","typeLabel":"object[]"},"hasMoreSubscriptions":{"description":"HasMoreSubscriptions is true if there are more subscriptions than the ones returned in RecentSubscriptions. These may only be retrieved using the GetSubscriptions operation (to be implemented).","type":"boolean","uniqueKey":"billing.hasMoreSubscriptions","typeLabel":"boolean"},"freeTrialEndDate":{"description":"FreeTrialEndDate is the date at which the Organisation's free trial will end. This is only populated if the Organisation is currently on the free trial. This time should always be in UTC.","type":"string","format":"date","uniqueKey":"billing.freeTrialEndDate","typeLabel":"string\u003cdate>"},"isBespoke":{"description":"IsBespoke is true if the Organisation is on a bespoke plan, i.e. not using Stripe for billing.","type":"boolean","uniqueKey":"billing.isBespoke","typeLabel":"boolean"},"boardQuota":{"description":"BoardQuota is the maximum number of Switchboard boards (NOT including hub boards) the Organisation is allowed to have. This is determined by the quantity of boards that are on the Organisation's subscription. It is also used to determine the amount of free executions and users that an organisation is allowed.","type":"integer","uniqueKey":"billing.boardQuota","typeLabel":"integer"},"hubBoardQuota":{"description":"HubBoardQuota is the maximum number of Hub boards the Organisation is allowed to have. This is determined by the quantity of hub boards that are on the Organisation's subscription. It is also used to determine the amount of free executions and users that an organisation is allowed.","type":"integer","uniqueKey":"billing.hubBoardQuota","typeLabel":"integer"}},"required":["platformId","customerId","billingEmail","isSubscriptionActive","billingPeriodEnd","billingPeriodStart"],"isRequired":true,"uniqueKey":"billing","typeLabel":"object"},"systemServiceAccountClientID":{"description":"SystemServiceAccountClientID is the client ID of the system service account for this Organisation. This is automatically created when the Organisation is created and is used by internal services which must authenticate on behalf of the Organisation. It cannot be deleted.","type":"string","isRequired":true,"uniqueKey":"systemServiceAccountClientID","typeLabel":"string"},"plan":{"description":"Subscription plan the organisation is enrolled.","type":"string","uniqueKey":"plan","typeLabel":"string"}},"required":["id","slug","displayName","owner","billing","systemServiceAccountClientID"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"id":"\u003cstring>","slug":"\u003cstring>","displayName":"\u003cstring>","owner":"\u003cstring>","billing":{"platformId":"\u003cstring>","customerId":"\u003cstring>","billingEmail":"\u003cstring>","isSubscriptionActive":123,"billingPeriodStart":"2023-12-25","billingPeriodEnd":"2023-12-25","platformType":"\u003cstring>","subscriptionId":"\u003cstring>","recentSubscriptions":[{"id":"\u003cstring>","status":"active","rawData":"\u003cunknown>"}],"hasMoreSubscriptions":true,"freeTrialEndDate":"2023-12-25","isBespoke":true,"boardQuota":123,"hubBoardQuota":123},"systemServiceAccountClientID":"\u003cstring>","plan":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"7fd3ea14-3c30-465a-944d-7d9e4cb43cba":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"Code is a machine-readable error code.","isRequired":true,"uniqueKey":"code","typeLabel":"string"},"message":{"type":"string","description":"Message is a human-readable error message.","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"cause":{"type":"string","x-go-type-skip-optional-pointer":true,"uniqueKey":"cause","typeLabel":"string"}},"required":["code","message"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"code":"\u003cstring>","message":"\u003cstring>","cause":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"eeaf2ca4-81fe-4189-9bad-992bee5cc37b":{"Authorization":{"type":"http","scheme":"bearer","description":"Bearer authentication header of the form `Bearer \u003ctoken>`, where `\u003ctoken>` is your auth token."}}},"servers":{"2100a169-b143-4bd5-a1b5-259cb73d8f4d":{"url":"https://platform.versori.com/api/organisations/v1","description":"Production server"},"9efcf180-79f6-4875-8d92-dc0cc8fe8b07":{"url":"http://localhost:8081/v1","description":"Localhost"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","description":"Bearer authentication header of the form `Bearer \u003ctoken>`, where `\u003ctoken>` is your auth token."},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Bearer authentication header of the form `Bearer \u003ctoken>`, where `\u003ctoken>` is your auth token.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"Authorization","name":"Authorization"}],"title":"Authorization"}]},"originalFileLocation":"openapi/organisations-api-v1.yaml"},"subdomain":"versori","siteName":"Versori User Documentation","title":"Create Organisation - Versori User Documentation","navMaps":{"firstHrefInVersion":{"Latest":{"href":"/api-reference/organisations-api/create-organisation","matchLevel":0},"Legacy":{"href":"/legacy/welcome","matchLevel":4},"v2":{"href":"/v2/introduction","matchLevel":4}},"firstHrefInLanguage":{}},"lastModified":"2026-01-23T11:43:55.478Z","originalFileLocation":"api-reference/organisations-api/create-organisation.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=\"CreateOrganisation creates a new Organisation with the current user as the owner. A user can create as many Organisations as they like, but each has their own billing profile and must be on a paid plan to use certain features.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Versori User 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/versori/JHvcKEOb4limbJz2/_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/versori/JHvcKEOb4limbJz2/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/versori/JHvcKEOb4limbJz2/_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/versori/JHvcKEOb4limbJz2/_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/versori/JHvcKEOb4limbJz2/_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/versori/JHvcKEOb4limbJz2/_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/versori/JHvcKEOb4limbJz2/_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/versori/JHvcKEOb4limbJz2/_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/versori/JHvcKEOb4limbJz2/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Create Organisation - Versori User Documentation\">\u003cmeta data-mint-head property=\"og:description\" content=\"CreateOrganisation creates a new Organisation with the current user as the owner. A user can create as many Organisations as they like, but each has their own billing profile and must be on a paid plan to use certain features.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Versori User Documentation\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.versori.com/api-reference/organisations-api/create-organisation\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://versori.mintlify.app/_mintlify/api/og/v2?division=API+Reference\u0026amp;title=Create+Organisation\u0026amp;description=CreateOrganisation+creates+a+new+Organisation+with+the+current+user+as+the+owner.+A+user+can+create+as+many+Organisations+as+they+like%2C+but+each+has+their+own+b\u0026amp;theme=1ac70f2532992ffb34bd6aef\u0026amp;signature=ad59441d35cfca10fc0fa0dbdfb14c086bbae3f0fc56a4a0309d121681a498c8\">\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 Organisation - Versori User Documentation\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"CreateOrganisation creates a new Organisation with the current user as the owner. A user can create as many Organisations as they like, but each has their own billing profile and must be on a paid plan to use certain features.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://versori.mintlify.app/_mintlify/api/og/v2?division=API+Reference\u0026amp;title=Create+Organisation\u0026amp;description=CreateOrganisation+creates+a+new+Organisation+with+the+current+user+as+the+owner.+A+user+can+create+as+many+Organisations+as+they+like%2C+but+each+has+their+own+b\u0026amp;theme=1ac70f2532992ffb34bd6aef\u0026amp;signature=ad59441d35cfca10fc0fa0dbdfb14c086bbae3f0fc56a4a0309d121681a498c8\">\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/versori/JHvcKEOb4limbJz2/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Versori User Documentation\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#6EB0D8\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.versori.com/api-reference/organisations-api/create-organisation\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/organisations-api/create-organisation.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.versori.com/#organization\",\"name\":\"Versori User Documentation\",\"url\":\"https://docs.versori.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/versori/PWNCaMS5nGiiWoff/logo/versori-logo-wordmark.svg?fit=max\u0026auto=format\u0026n=PWNCaMS5nGiiWoff\u0026q=85\u0026s=be10819ca139d000a6edaef35334c0af\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.versori.com#website\",\"name\":\"Versori User Documentation\",\"url\":\"https://docs.versori.com\",\"publisher\":{\"@id\":\"https://docs.versori.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.versori.com/api-reference/organisations-api/create-organisation#webpage\",\"url\":\"https://docs.versori.com/api-reference/organisations-api/create-organisation\",\"name\":\"Create Organisation\",\"description\":\"CreateOrganisation creates a new Organisation with the current user as the owner. A user can create as many Organisations as they like, but each has their own billing profile and must be on a paid plan to use certain features.\",\"dateModified\":\"2026-01-23T11:43:55.478Z\",\"isPartOf\":{\"@id\":\"https://docs.versori.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.versori.com/api-reference/organisations-api/create-organisation#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.versori.com/api-reference/organisations-api/create-organisation#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"API Reference\",\"item\":\"https://docs.versori.com/api-reference/organisations-api/signing-keys/retrieve-public-key\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"API Reference\",\"item\":\"https://docs.versori.com/api-reference/organisations-api/get-active-organisation\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Create Organisation\",\"item\":\"https://docs.versori.com/api-reference/organisations-api/create-organisation\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.versori.com/api-reference/organisations-api/create-organisation#apireference\",\"headline\":\"Create Organisation\",\"name\":\"Create Organisation\",\"description\":\"CreateOrganisation creates a new Organisation with the current user as the owner. A user can create as many Organisations as they like, but each has their own billing profile and must be on a paid plan to use certain features.\",\"url\":\"https://docs.versori.com/api-reference/organisations-api/create-organisation\",\"mainEntityOfPage\":{\"@id\":\"https://docs.versori.com/api-reference/organisations-api/create-organisation#webpage\"},\"dateModified\":\"2026-01-23T11:43:55.478Z\",\"publisher\":{\"@id\":\"https://docs.versori.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.versori.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Versori User Documentation\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Versori User Documentation","nav":{"global":null,"versions":[{"version":"Latest","tabs":[{"tab":"Home","pages":[{"title":"Home","href":"/latest/home"}]},{"tab":"User Guide","pages":[{"title":"User Guide","href":"/latest/guides/getting-started/chat"}]},{"tab":"Run SDK","dropdowns":[{"dropdown":"Latest (0.4.x)","groups":[{"group":"Getting Started","expanded":true,"pages":[{"title":"Run SDK","sidebarTitle":"Introduction","href":"/latest/run-sdk/latest/introduction"},{"title":"Connections","href":"/latest/run-sdk/latest/connections"},{"group":"Workflows, Triggers and Tasks","pages":[{"title":"Workflows, Triggers and Tasks","sidebarTitle":"Overview","href":"/latest/run-sdk/latest/workflows"},{"title":"Inputs and outputs","href":"/latest/run-sdk/latest/workflows/inputs-outputs"},{"title":"Task Types","href":"/latest/run-sdk/latest/workflows/task-types"},{"title":"Background","href":"/latest/run-sdk/latest/workflows/background"},{"title":"Catch","href":"/latest/run-sdk/latest/workflows/catch"}]},{"title":"The Context Object","href":"/latest/run-sdk/latest/context"},{"title":"Durable Workflows","href":"/latest/run-sdk/latest/durable-workflows"}]},{"group":"Developers","pages":[{"title":"Developers Overview","sidebarTitle":"Overview","href":"/latest/run-sdk/latest/developers/overview"}]}]}]},{"tab":"CLI","pages":[{"title":"CLI","href":"/latest/cli/introduction"}]},{"tab":"AI Tooling","pages":[{"title":"AI Tooling","href":"/latest/ai-tooling/cloud-agents"}]},{"tab":"API Reference","anchors":[{"anchor":"Overview","pages":[{"title":"Overview","href":"/latest/api-reference/getting-started"}]},{"anchor":"Platform API","icon":"cloud","pages":[{"title":"Platform API","href":"/latest/api-reference/platform-api/getting-started"}]},{"anchor":"Organisations API","icon":"users","pages":[{"title":"Getting Started","href":"/latest/api-reference/organisations-api/getting-started"},{"group":"API Reference","pages":[{"group":"signing-keys","pages":[{"title":"Retrieve public key","deprecated":null,"version":null,"openapi":"/openapi/organisations-api-v1.yaml get /keys/{id}","href":"/api-reference/organisations-api/signing-keys/retrieve-public-key"},{"title":"List Signing Keys","deprecated":null,"version":null,"openapi":"/openapi/organisations-api-v1.yaml get /organisations/{organisation_id}/keys","href":"/api-reference/organisations-api/signing-keys/list-signing-keys"},{"title":"Create Signing Key","deprecated":null,"version":null,"openapi":"/openapi/organisations-api-v1.yaml post /organisations/{organisation_id}/keys","href":"/api-reference/organisations-api/signing-keys/create-signing-key"},{"title":"Delete Signing Key","deprecated":null,"version":null,"openapi":"/openapi/organisations-api-v1.yaml delete /organisations/{organisation_id}/keys/{key_id}","href":"/api-reference/organisations-api/signing-keys/delete-signing-key"}]},{"group":"API Reference","pages":[{"title":"Get Active Organisation","deprecated":null,"version":null,"openapi":"/openapi/organisations-api-v1.yaml get /active-organisation","href":"/api-reference/organisations-api/get-active-organisation"},{"title":"Get Organisations","description":"GetOrganisations returns a paginated list of Organisations which the current user is a member of. If there is no filter provided, the result will always contain the active Organisation as the first item of the first page. Otherwise, the filter is applied to the name and slug using a case-insensitive substring match.","deprecated":null,"version":null,"openapi":"/openapi/organisations-api-v1.yaml get /organisations","href":"/api-reference/organisations-api/get-organisations"},{"title":"Create Organisation","deprecated":null,"version":null,"openapi":"/openapi/organisations-api-v1.yaml post /organisations","href":"/api-reference/organisations-api/create-organisation"},{"title":"Get Organisation","description":"Get an Organisation by its ID","deprecated":null,"version":null,"openapi":"/openapi/organisations-api-v1.yaml get /organisations/{organisation_id}","href":"/api-reference/organisations-api/get-organisation"},{"title":"Get Members","deprecated":null,"version":null,"openapi":"/openapi/organisations-api-v1.yaml get /organisations/{organisation_id}/members","href":"/api-reference/organisations-api/get-members"},{"title":"Get Member","deprecated":null,"version":null,"openapi":"/openapi/organisations-api-v1.yaml get /organisations/{organisation_id}/members/{member_id}","href":"/api-reference/organisations-api/get-member"},{"title":"Delete Member","deprecated":null,"version":null,"openapi":"/openapi/organisations-api-v1.yaml delete /organisations/{organisation_id}/members/{member_id}","href":"/api-reference/organisations-api/delete-member"},{"title":"Get Service Accounts","deprecated":null,"version":null,"openapi":"/openapi/organisations-api-v1.yaml get /organisations/{organisation_id}/service-accounts","href":"/api-reference/organisations-api/get-service-accounts"},{"title":"Create Service Account","deprecated":null,"version":null,"openapi":"/openapi/organisations-api-v1.yaml post /organisations/{organisation_id}/service-accounts","href":"/api-reference/organisations-api/create-service-account"},{"title":"Get Service Account","deprecated":null,"version":null,"openapi":"/openapi/organisations-api-v1.yaml get /organisations/{organisation_id}/service-accounts/{service_account_id}","href":"/api-reference/organisations-api/get-service-account"},{"title":"Delete Service Account","deprecated":null,"version":null,"openapi":"/openapi/organisations-api-v1.yaml delete /organisations/{organisation_id}/service-accounts/{service_account_id}","href":"/api-reference/organisations-api/delete-service-account"},{"title":"Get Groups","deprecated":null,"version":null,"openapi":"/openapi/organisations-api-v1.yaml get /organisations/{organisation_id}/groups","href":"/api-reference/organisations-api/get-groups"},{"title":"Create Group","deprecated":null,"version":null,"openapi":"/openapi/organisations-api-v1.yaml post /organisations/{organisation_id}/groups","href":"/api-reference/organisations-api/create-group"},{"title":"Get Group","deprecated":null,"version":null,"openapi":"/openapi/organisations-api-v1.yaml get /organisations/{organisation_id}/groups/{group_id}","href":"/api-reference/organisations-api/get-group"},{"title":"Delete Group","deprecated":null,"version":null,"openapi":"/openapi/organisations-api-v1.yaml delete /organisations/{organisation_id}/groups/{group_id}","href":"/api-reference/organisations-api/delete-group"},{"title":"Get Invitations","deprecated":null,"version":null,"openapi":"/openapi/organisations-api-v1.yaml get /organisations/{organisation_id}/invitations","href":"/api-reference/organisations-api/get-invitations"},{"title":"Invite Member","deprecated":null,"version":null,"openapi":"/openapi/organisations-api-v1.yaml post /organisations/{organisation_id}/invitations","href":"/api-reference/organisations-api/invite-member"},{"title":"Delete Invitation","deprecated":null,"version":null,"openapi":"/openapi/organisations-api-v1.yaml delete /organisations/{organisation_id}/invitations/{invitation_id}","href":"/api-reference/organisations-api/delete-invitation"},{"title":"Accept Invitation","deprecated":null,"version":null,"openapi":"/openapi/organisations-api-v1.yaml put /organisations/{organisation_id}/invitations/{invitation_id}/accept","href":"/api-reference/organisations-api/accept-invitation"},{"title":"Resend Invitation","deprecated":null,"version":null,"openapi":"/openapi/organisations-api-v1.yaml put /organisations/{organisation_id}/invitations/{invitation_id}/resend","href":"/api-reference/organisations-api/resend-invitation"},{"title":"Set Active Organisation","deprecated":null,"version":null,"openapi":"/openapi/organisations-api-v1.yaml put /organisations/{organisation_id}/active","href":"/api-reference/organisations-api/set-active-organisation"},{"title":"Get Billing","deprecated":null,"version":null,"openapi":"/openapi/organisations-api-v1.yaml get /organisations/{organisation_id}/billing","href":"/api-reference/organisations-api/get-billing"},{"title":"Update Billing Details such as billing email","deprecated":null,"version":null,"openapi":"/openapi/organisations-api-v1.yaml put /organisations/{organisation_id}/billing","href":"/api-reference/organisations-api/update-billing-details-such-as-billing-email"},{"title":"Get Invoices","deprecated":null,"version":null,"openapi":"/openapi/organisations-api-v1.yaml get /organisations/{organisation_id}/billing/invoices","href":"/api-reference/organisations-api/get-invoices"},{"title":"Update Subscription","deprecated":null,"version":null,"openapi":"/openapi/organisations-api-v1.yaml put /organisations/{organisation_id}/billing/update-subscription","href":"/api-reference/organisations-api/update-subscription"},{"title":"Create Checkout Session","deprecated":null,"version":null,"openapi":"/openapi/organisations-api-v1.yaml post /organisations/{organisation_id}/billing/checkout-session","href":"/api-reference/organisations-api/create-checkout-session"},{"title":"Get Slug Availability","deprecated":null,"version":null,"openapi":"/openapi/organisations-api-v1.yaml get /slug/{slug}/availability","href":"/api-reference/organisations-api/get-slug-availability"}]},{"group":"webhooks","pages":[{"title":"Post billing webhooks","deprecated":null,"version":null,"openapi":"/openapi/organisations-api-v1.yaml post /billing-webhooks","href":"/api-reference/organisations-api/webhooks/post-billing-webhooks"}]}]}]}]}]},{"version":"Legacy","pages":[{"title":"Legacy","href":"/legacy/welcome"}]},{"version":"v2","pages":[{"title":"v2","href":"/v2/introduction"}]}]},"title":"Create Organisation - Versori User Documentation","buildId":"dpl_849ArpqvBiCczQiT1Y1stNGpbqHT","deploymentId":"dpl_849ArpqvBiCczQiT1Y1stNGpbqHT","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-Bbp7I60D.js","utils-C3RIvJha.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-DqD-vLt8.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-B31Loprg.js","snippetPresets-DKpk-b8t.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-Cj65AhOR.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BXtn5gcC.js","shallow-RY2b03Cp.js","getApiPlaygroundDisplay-B0jeiPk3.js","CodeSnippet-CYgBjjwn.js","CodeSnippets-DOngDrYB.js","Page-n7I5XbKb.js","getPastedJson-DRQbJx-T.js","icon-CQiQCicY.js","MethodPill-BKTLdNtu.js","DuplicateIcon-B9jpAdat.js","createIcon-DCddRrXv.js","DynamicMarkdown-a8hUKrw6.js","SectionHeading-eECVV2eH.js","axios-vUo_bRtp.js","Markdown--GF7ZIpf.js","clsx-DZLdJUrt.js","lib--scc4DXi.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-2LoAhjKH.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-Zwc0ZncM.js"]}