Create and manage Launchpad service accounts for KODE API integrations with OAuth 2.0 credentials and permissions.
A service account is a non-human identity for system integrations. You create one in Launchpad, assign buildings, set permissions, and generate credentials. Your integration then uses those credentials to authenticate with the KODE API.Open Service Accounts from the left sidebar. The table lists each account. Select a row to open Details and Permissions.
Details
Use Details to review the account and manage credentials.
View name, client ID, credential type, and description
Generate a private key or client secret
Edit or disable existing credentials
The Details section shows account information and credential controls
Permissions
Use Permissions to grant Read and Write access per resource group. Assign only what the integration needs.
Edit Read or Write for each permission group
Limit the account to the buildings you assigned when you created it
API paths use the /api/v1/ structure under https://api.kodelabs.com/kodeos. Token requests use https://api.kodelabs.com/oauth2/v1/token.The table summarizes common endpoints for service account integrations. The KODE API reference is the source of truth for every endpoint, parameter, and response.
Grant matching Launchpad permissions before you call an endpoint. A valid token still returns 403 when the account lacks access to the building or operation.
Next steps
Permissions reference
Review Read and Write operations for each permission group.
Authenticate with the KODE API
Exchange service account credentials for a Bearer access token.
KODE API quickstart
Request a token and list the buildings your account can access.
KODE API reference
Browse every endpoint, or fork the Postman collection.
Last modified on November 14, 2026
Was this page helpful?
{"docsConfig":{"theme":"aspen","$schema":"https://mintlify.com/docs.json","name":"KODE Labs - Product Documentation","colors":{"primary":"#015BFA","light":"#3A9AFF","dark":"#015BFA"},"logo":{"light":"https://mintcdn.com/kodelabs/YfYud6Al4TM68wc2/logo/logo-light.png?fit=max\u0026auto=format\u0026n=YfYud6Al4TM68wc2\u0026q=85\u0026s=00d4ffd6ad7a592e52856804d1a53d12","dark":"https://mintcdn.com/kodelabs/YfYud6Al4TM68wc2/logo/logo-dark.png?fit=max\u0026auto=format\u0026n=YfYud6Al4TM68wc2\u0026q=85\u0026s=a6769f53904d96f5a53ea0c4b3c972d6","href":"/"},"favicon":{"light":"https://mintcdn.com/kodelabs/H3HEEQdnaG21O57-/logo/favicon-light.png?fit=max\u0026auto=format\u0026n=H3HEEQdnaG21O57-\u0026q=85\u0026s=3ae881e353dfb5c2f667e175ec82c799","dark":"https://mintcdn.com/kodelabs/H3HEEQdnaG21O57-/logo/favicon-dark.png?fit=max\u0026auto=format\u0026n=H3HEEQdnaG21O57-\u0026q=85\u0026s=845431bc7d53ce5bf50f56ef53d9137f"},"api":{"params":{"expanded":"closed"},"playground":{"display":"interactive","proxy":true},"examples":{"defaults":"required","languages":["bash","javascript","python","powershell"],"prefill":true,"autogenerate":true},"url":"full"},"appearance":{"default":"light","strict":true},"background":{"color":{"light":"#ffffff","dark":"#121212"}},"navbar":{"links":[{"href":"https://kodelabs.com/contact/","label":"Contact Us"}]},"footer":{"socials":{"x":"https://twitter.com/kodelabs","instagram":"https://www.instagram.com/kode_labs","linkedin":"https://www.linkedin.com/company/kodelabs","youtube":"https://www.youtube.com/channel/UCKCnsgnYtugWxMPzu3UEHkw"},"links":[{"header":"Platform","items":[{"label":"KODE OS","href":"https://kodelabs.com"},{"label":"Integrations","href":"https://kodelabs.com/partners/integrations-library"},{"label":"Security","href":"https://kodelabs.com/security"}]},{"header":"Resources","items":[{"label":"Blog","href":"https://kodelabs.com/blog"},{"label":"Reports \u0026 Guides","href":"https://kodelabs.com/resources"},{"label":"Podcasts \u0026 Webinars","href":"https://kodelabs.com/resources"},{"label":"Case Studies","href":"https://kodelabs.com/case-studies"},{"label":"News","href":"https://kodelabs.com/news"}]},{"header":"Solutions","items":[{"label":"Commercial","href":"https://kodelabs.com/solutions/commercial-real-estate"},{"label":"Corporate","href":"https://kodelabs.com/solutions/corporate"},{"label":"Retail","href":"https://kodelabs.com/solutions/retail"},{"label":"Healthcare","href":"https://kodelabs.com/solutions/healthcare"},{"label":"Education","href":"https://kodelabs.com/solutions/education"}]},{"header":"Company","items":[{"label":"About","href":"https://kodelabs.com/about"},{"label":"Careers","href":"https://kodelabs.com/careers"},{"label":"Internships","href":"https://kodelabs.com/internships"},{"label":"Contact Us","href":"https://kodelabs.com/contact"}]}]},"search":{"prompt":"Search our docs..."},"fonts":{"heading":{"family":"Manrope","weight":600},"body":{"family":"Inter"}},"icons":{"library":"lucide"},"styling":{"eyebrows":"section","codeblocks":{"theme":{"light":"github-light","dark":"github-dark"}},"latex":false},"integrations":{"ga4":{"measurementId":"G-WKYQEE1T4B"}},"banner":{"content":"KODE 3.20 is live. See [what's new in November 2026](/whats-new/2026/v3.20-november-2026).","dismissible":true,"color":{"light":"#015BFA","dark":"#015BFA"}},"errors":{"404":{"redirect":false,"title":"We're working on it!","description":"If you're not seeing this page, we're definitely updating it."}},"contextual":{"options":["copy","view",{"title":"Email KODE support","description":"Contact KODE Labs support for help","icon":"mail","href":"mailto:support@kodelabs.com"}],"display":"toc"},"interaction":{"drilldown":false},"metadata":{"timestamp":true},"navigation":{"global":{"anchors":[{"anchor":"Home","icon":"house","href":"/"},{"anchor":"What's New","icon":"megaphone","href":"/whats-new/2026/v3.20-november-2026"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"kodelabs","hasAudioNarration":false,"actualSubdomain":"kodelabs","customDomains":["docs.kodelabs.com"],"gitSource":{"type":"github","owner":"kode-labs","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true,"agentFeedback":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"REMOVE_BRANDING":{"status":"ENABLED"},"CONTEXTUAL_FEEDBACK":{"status":"ENABLED"},"CODE_SNIPPET_FEEDBACK":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6af8e4f300819710da52c87a","clientVersion":"0.0.4227","searchFilterCounts":[{"language":"default","tag":"Integrations","count":214},{"language":"default","tag":"All Integrations","count":205},{"language":"default","tag":"KODE API","count":143},{"language":"default","tag":"API reference","count":132},{"language":"default","tag":"EnerG","count":61},{"language":"default","tag":"Meters","count":37},{"language":"default","tag":"Building BI","count":35},{"language":"default","tag":"AssetOps","count":32},{"language":"default","tag":"Cloud BMS","count":31},{"language":"default","tag":"Reference","count":29}],"searchSettings":{"showContentSnippets":true,"isFiltersEnabled":true,"maxResults":10}},"assistantConfig":{"enableStarterQuestions":true,"enableContextualStarterQuestions":true},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"treatment","enabled":true,"payload":{"type":"string","value":"treatment"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":true},"customCss":[{"filePath":"custom.css","href":"/_mintlify/custom/kodelabs/fd6257d3326e3afa/custom.css"}]}
{"page":{"pagePath":"products/launchpad/client-organizations/service-accounts","slug":"/products/launchpad/client-organizations/service-accounts","pageMetadata":{"title":"Service Accounts","sidebarTitle":"Overview","description":"Create and manage Launchpad service accounts for KODE API integrations with OAuth 2.0 credentials and permissions.","icon":"dot","keywords":["client organization","service accounts","API","OAuth 2.0","keys","permissions","Launchpad","KODE OS"],"href":"/products/launchpad/client-organizations/service-accounts"},"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 and manage Launchpad service accounts for KODE API integrations with OAuth 2.0 credentials and permissions.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,li:`li`,p:`p`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{Card,CardGroup,Expandable,Frame,Heading,Note,OptimizedImage,Step,Steps,Tab,Table,Tabs,Warning}=_components;if(!Card)_missingMdxReference(`Card`,true);if(!CardGroup)_missingMdxReference(`CardGroup`,true);if(!Expandable)_missingMdxReference(`Expandable`,true);if(!Frame)_missingMdxReference(`Frame`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Note)_missingMdxReference(`Note`,true);if(!OptimizedImage)_missingMdxReference(`OptimizedImage`,true);if(!Step)_missingMdxReference(`Step`,true);if(!Steps)_missingMdxReference(`Steps`,true);if(!Tab)_missingMdxReference(`Tab`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Tabs)_missingMdxReference(`Tabs`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`A service account is a non-human identity for system integrations. You create one in Launchpad, assign buildings, set permissions, and generate credentials. Your integration then uses those credentials to authenticate with the `,_jsx(_components.a,{href:`/products/kode-api/authentication`,children:`KODE API`}),`.`]}),`\n`,_jsxs(_components.p,{children:[`Open `,_jsx(_components.strong,{children:`Service Accounts`}),` from the left sidebar. The table lists each account. Select a row to open `,_jsx(_components.strong,{children:`Details`}),` and `,_jsx(_components.strong,{children:`Permissions`}),`.`]}),`\n`,_jsx(Heading,{level:`2`,id:`details`,children:`Details`}),`\n`,_jsxs(_components.p,{children:[`Use `,_jsx(_components.strong,{children:`Details`}),` to review the account and manage credentials.`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`View name, client ID, credential type, and description`}),`\n`,_jsx(_components.li,{children:`Generate a private key or client secret`}),`\n`,_jsx(_components.li,{children:`Edit or disable existing credentials`}),`\n`]}),`\n`,_jsx(Frame,{caption:`The Details section shows account information and credential controls`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/kodelabs/QV43LEddE2aJcRYU/images/launchpad/launchpad-client-org-service-account-detail.png?fit=max\u0026auto=format\u0026n=QV43LEddE2aJcRYU\u0026q=85\u0026s=d052b9261f7807d6915f91df37aa903e`,alt:`Service account detail page showing general information with email, created by, created at, credential type, client ID, and description, plus a Credentials section with a Generate Private Key button`,\"data-og-width\":`1024`,width:`1024`,\"data-og-height\":`494`,height:`494`,\"data-path\":`images/launchpad/launchpad-client-org-service-account-detail.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/kodelabs/QV43LEddE2aJcRYU/images/launchpad/launchpad-client-org-service-account-detail.png?w=280\u0026fit=max\u0026auto=format\u0026n=QV43LEddE2aJcRYU\u0026q=85\u0026s=c4030aca2053e12690ecb4f705aea603 280w, https://mintcdn.com/kodelabs/QV43LEddE2aJcRYU/images/launchpad/launchpad-client-org-service-account-detail.png?w=560\u0026fit=max\u0026auto=format\u0026n=QV43LEddE2aJcRYU\u0026q=85\u0026s=55377234f2e1af47d6cb68091076296d 560w, https://mintcdn.com/kodelabs/QV43LEddE2aJcRYU/images/launchpad/launchpad-client-org-service-account-detail.png?w=840\u0026fit=max\u0026auto=format\u0026n=QV43LEddE2aJcRYU\u0026q=85\u0026s=63c2d92d5d33354bcf2c221cf77f511a 840w, https://mintcdn.com/kodelabs/QV43LEddE2aJcRYU/images/launchpad/launchpad-client-org-service-account-detail.png?w=1100\u0026fit=max\u0026auto=format\u0026n=QV43LEddE2aJcRYU\u0026q=85\u0026s=017fa16e4dabb5e0eadb3f7ec4a114e3 1100w, https://mintcdn.com/kodelabs/QV43LEddE2aJcRYU/images/launchpad/launchpad-client-org-service-account-detail.png?w=1650\u0026fit=max\u0026auto=format\u0026n=QV43LEddE2aJcRYU\u0026q=85\u0026s=6af232f6fcdf27da4fca4b72bfb26afe 1650w, https://mintcdn.com/kodelabs/QV43LEddE2aJcRYU/images/launchpad/launchpad-client-org-service-account-detail.png?w=2500\u0026fit=max\u0026auto=format\u0026n=QV43LEddE2aJcRYU\u0026q=85\u0026s=1aab7c73058004abf59eae7063793d69 2500w`})}),`\n`,_jsx(Heading,{level:`2`,id:`permissions`,children:`Permissions`}),`\n`,_jsxs(_components.p,{children:[`Use `,_jsx(_components.strong,{children:`Permissions`}),` to grant `,_jsx(_components.code,{children:`Read`}),` and `,_jsx(_components.code,{children:`Write`}),` access per resource group. Assign only what the integration needs.`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`Edit `,_jsx(_components.code,{children:`Read`}),` or `,_jsx(_components.code,{children:`Write`}),` for each permission group`]}),`\n`,_jsx(_components.li,{children:`Limit the account to the buildings you assigned when you created it`}),`\n`]}),`\n`,_jsxs(_components.p,{children:[`See the `,_jsx(_components.a,{href:`/products/launchpad/client-organizations/service-accounts/permissions-reference`,children:`permissions reference`}),` for each group and operation.`]}),`\n`,_jsx(Frame,{caption:`The Permissions section lists permission groups with Read and Write indicators`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/kodelabs/QV43LEddE2aJcRYU/images/launchpad/launchpad-client-org-service-account-permissions.png?fit=max\u0026auto=format\u0026n=QV43LEddE2aJcRYU\u0026q=85\u0026s=0f95bcd4b19e27d02b320d8ea91ebb22`,alt:`Service account Permissions page showing permission groups including BuildingsPublic, Actions, AreasPublic, DatasourcesPublic, DevicesPublic, MetersPublic, PointsPublic, SpacesPublic, TenantsPublic, TimeseriesPublic, and WorkOrdersPublic with green Read and orange Write permission badges`,\"data-og-width\":`1024`,width:`1024`,\"data-og-height\":`740`,height:`740`,\"data-path\":`images/launchpad/launchpad-client-org-service-account-permissions.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/kodelabs/QV43LEddE2aJcRYU/images/launchpad/launchpad-client-org-service-account-permissions.png?w=280\u0026fit=max\u0026auto=format\u0026n=QV43LEddE2aJcRYU\u0026q=85\u0026s=5efa999b8bca469a9f9b42552d93fada 280w, https://mintcdn.com/kodelabs/QV43LEddE2aJcRYU/images/launchpad/launchpad-client-org-service-account-permissions.png?w=560\u0026fit=max\u0026auto=format\u0026n=QV43LEddE2aJcRYU\u0026q=85\u0026s=5eeea2ef698aa2e96e01e2f8a752d27c 560w, https://mintcdn.com/kodelabs/QV43LEddE2aJcRYU/images/launchpad/launchpad-client-org-service-account-permissions.png?w=840\u0026fit=max\u0026auto=format\u0026n=QV43LEddE2aJcRYU\u0026q=85\u0026s=351cfacca6c46f1a01b19fe2d27d1149 840w, https://mintcdn.com/kodelabs/QV43LEddE2aJcRYU/images/launchpad/launchpad-client-org-service-account-permissions.png?w=1100\u0026fit=max\u0026auto=format\u0026n=QV43LEddE2aJcRYU\u0026q=85\u0026s=cf1117ea2721965ddd509deaa12646f8 1100w, https://mintcdn.com/kodelabs/QV43LEddE2aJcRYU/images/launchpad/launchpad-client-org-service-account-permissions.png?w=1650\u0026fit=max\u0026auto=format\u0026n=QV43LEddE2aJcRYU\u0026q=85\u0026s=32eac64a60f99e203ed378096e7f3695 1650w, https://mintcdn.com/kodelabs/QV43LEddE2aJcRYU/images/launchpad/launchpad-client-org-service-account-permissions.png?w=2500\u0026fit=max\u0026auto=format\u0026n=QV43LEddE2aJcRYU\u0026q=85\u0026s=729239051b72914544a0aaa382b574a0 2500w`})}),`\n`,_jsx(Heading,{level:`2`,id:`create-a-service-account`,children:`Create a service account`}),`\n`,_jsxs(_components.p,{children:[`Create the account from the `,_jsx(_components.strong,{children:`Service Accounts`}),` page, then generate credentials and set permissions.`]}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`You can update `,_jsx(_components.strong,{children:`Details`}),` and `,_jsx(_components.strong,{children:`Permissions`}),` after you create the account.`]})}),`\n`,_jsxs(Steps,{children:[_jsx(Step,{title:`Open Service Accounts`,children:_jsxs(_components.p,{children:[`In Launchpad, open `,_jsx(_components.strong,{children:`Service Accounts`}),` from the left sidebar.`]})}),_jsx(Step,{title:`Select +Add Service`,children:_jsxs(_components.p,{children:[`Select `,_jsx(_components.code,{children:`+Add Service`}),` to open the create dialog.`]})}),_jsxs(Step,{title:`Configure the account`,children:[_jsx(_components.p,{children:`Enter a name, credential type, description, and site assignment.`}),_jsx(Frame,{caption:`The Add New Service Account dialog collects name, credential type, description, and sites`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/kodelabs/QV43LEddE2aJcRYU/images/launchpad/launchpad-client-org-service-accounts-add.png?fit=max\u0026auto=format\u0026n=QV43LEddE2aJcRYU\u0026q=85\u0026s=d4429efd06c8d8079e2c734f0ca7409b`,alt:`Add New Service Account dialog with fields for name, credential type selection between Private JWT and Client Secret, description, and site selection, displayed over the Service Accounts table`,\"data-og-width\":`1024`,width:`1024`,\"data-og-height\":`668`,height:`668`,\"data-path\":`images/launchpad/launchpad-client-org-service-accounts-add.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/kodelabs/QV43LEddE2aJcRYU/images/launchpad/launchpad-client-org-service-accounts-add.png?w=280\u0026fit=max\u0026auto=format\u0026n=QV43LEddE2aJcRYU\u0026q=85\u0026s=524c76adcae9435d4923cf5a76c4443b 280w, https://mintcdn.com/kodelabs/QV43LEddE2aJcRYU/images/launchpad/launchpad-client-org-service-accounts-add.png?w=560\u0026fit=max\u0026auto=format\u0026n=QV43LEddE2aJcRYU\u0026q=85\u0026s=b05d01c21a44b83feaefe5e35f71945a 560w, https://mintcdn.com/kodelabs/QV43LEddE2aJcRYU/images/launchpad/launchpad-client-org-service-accounts-add.png?w=840\u0026fit=max\u0026auto=format\u0026n=QV43LEddE2aJcRYU\u0026q=85\u0026s=db63d3959bd6d0c4b29e8d71b6081038 840w, https://mintcdn.com/kodelabs/QV43LEddE2aJcRYU/images/launchpad/launchpad-client-org-service-accounts-add.png?w=1100\u0026fit=max\u0026auto=format\u0026n=QV43LEddE2aJcRYU\u0026q=85\u0026s=0a3ac87b77ce85ef105bb69ce3834018 1100w, https://mintcdn.com/kodelabs/QV43LEddE2aJcRYU/images/launchpad/launchpad-client-org-service-accounts-add.png?w=1650\u0026fit=max\u0026auto=format\u0026n=QV43LEddE2aJcRYU\u0026q=85\u0026s=98f09a856573b454fe9b6057b083a6dc 1650w, https://mintcdn.com/kodelabs/QV43LEddE2aJcRYU/images/launchpad/launchpad-client-org-service-accounts-add.png?w=2500\u0026fit=max\u0026auto=format\u0026n=QV43LEddE2aJcRYU\u0026q=85\u0026s=9020a0d488900e16600ad231d1ea124a 2500w`})}),_jsx(Expandable,{defaultOpen:true,title:`Example configuration`,children:_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Field`}),_jsx(_components.th,{children:`Example`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Name`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`BMS Integration`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Credential type`}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`Private Key (JWT)`}),` or `,_jsx(_components.code,{children:`Client Secret`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Description`}),_jsx(_components.td,{children:`Purpose of the integration`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Assign site(s)`}),_jsx(_components.td,{children:`One or more buildings in your portfolio`})]})]})]})})]}),_jsx(Step,{title:`Save`,children:_jsxs(_components.p,{children:[`Select `,_jsx(_components.strong,{children:`Save`}),` to create the service account.`]})}),_jsxs(Step,{title:`Generate credentials`,children:[_jsx(_components.p,{children:`Open the new account and generate credentials for the type you chose.`}),_jsxs(Tabs,{children:[_jsxs(Tab,{title:`Private Key (JWT)`,id:`private-key-jwt`,children:[_jsxs(_components.p,{children:[`Select `,_jsx(_components.strong,{children:`Generate Private Key`}),` on the detail page. Launchpad creates a key pair and downloads the private key file.`]}),_jsx(Warning,{children:_jsx(_components.p,{children:`The private key downloads only once. Store it in a secure location. If you lose it, generate a new key and update your integration.`})})]}),_jsxs(Tab,{title:`Client Secret`,id:`client-secret`,children:[_jsxs(_components.p,{children:[`Select `,_jsx(_components.strong,{children:`Generate Client Secret`}),` on the detail page. Launchpad shows the secret on screen.`]}),_jsx(Warning,{children:_jsx(_components.p,{children:`The client secret displays only once. Copy and store it securely. If you lose it, generate a new secret and update your integration.`})})]})]})]}),_jsxs(Step,{title:`Authenticate with the KODE API`,children:[_jsx(_components.p,{children:`After you generate credentials, exchange them for an access token and call the API.`}),_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`Follow `,_jsx(_components.a,{href:`/products/kode-api/authentication`,children:`Authenticate with the KODE API`}),` for the OAuth 2.0 token flow.`]}),`\n`,_jsxs(_components.li,{children:[`Use the `,_jsx(_components.a,{href:`/products/kode-api/quickstart`,children:`KODE API quickstart`}),` to list buildings with your new account.`]}),`\n`,_jsxs(_components.li,{children:[`Open the `,_jsx(_components.a,{href:`https://documenter.getpostman.com/view/37847641/2sAYkEqfGB`,children:`KODE OS Public API collection`}),` for setup examples and runnable requests.`]}),`\n`]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`common-kode-api-endpoints`,children:`Common KODE API endpoints`}),`\n`,_jsxs(_components.p,{children:[`API paths use the `,_jsx(_components.code,{children:`/api/v1/`}),` structure under `,_jsx(_components.code,{children:`https://api.kodelabs.com/kodeos`}),`. Token requests use `,_jsx(_components.code,{children:`https://api.kodelabs.com/oauth2/v1/token`}),`.`]}),`\n`,_jsxs(_components.p,{children:[`The table summarizes common endpoints for service account integrations. The `,_jsx(_components.a,{href:`/products/kode-api/api-reference/introduction`,children:`KODE API reference`}),` is the source of truth for every endpoint, parameter, and response.`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Functionality`}),_jsx(_components.th,{children:`Method`}),_jsx(_components.th,{children:`Path`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Create an access token`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`POST`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`https://api.kodelabs.com/oauth2/v1/token`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`List buildings`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`GET`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`/api/v1/buildings`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`List building areas`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`GET`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`/api/v1/buildings/{buildingId}/areas`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`List building data sources`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`GET`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`/api/v1/buildings/{buildingId}/integrations/datasources`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`List data source actions`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`GET`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`/api/v1/buildings/{buildingId}/integrations/datasources/{datasourceId}/actions`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`List action fields`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`GET`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`/api/v1/buildings/{buildingId}/integrations/datasources/{datasourceId}/actions/{action}/fields`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Invoke an action`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`POST`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`/api/v1/buildings/{buildingId}/integrations/datasources/{datasourceId}/actions/{action}/invoke`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`List building devices`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`GET`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`/api/v1/buildings/{buildingId}/devices`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Create or update a device`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`POST`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`/api/v1/buildings/{buildingId}/integrations/datasources/{datasourceId}/devices`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Create or update devices in a batch`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`POST`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`/api/v1/buildings/{buildingId}/integrations/datasources/{datasourceId}/devices/batch`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`List building points`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`GET`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`/api/v1/buildings/{buildingId}/points`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`List point write fields`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`GET`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`/api/v1/buildings/{buildingId}/integrations/datasources/{datasourceId}/devices/{deviceId}/points/{pointId}/fields`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Write to a point`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`POST`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`/api/v1/buildings/{buildingId}/integrations/datasources/{datasourceId}/devices/{deviceId}/points/{pointId}/write`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`List point timeseries`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`GET`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`/api/v1/buildings/{buildingId}/timeseries`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Send timeseries for a data source`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`POST`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`/api/v1/buildings/{buildingId}/integrations/datasources/{datasourceId}/timeseries`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Send timeseries for a device`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`POST`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`/api/v1/buildings/{buildingId}/integrations/datasources/{datasourceId}/devices/{deviceId}/timeseries`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Send historical values for a point`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`POST`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`/api/v1/buildings/{buildingId}/integrations/datasources/{datasourceId}/devices/{deviceId}/points/{pointId}/timeseries`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`List work orders`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`GET`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`/api/v1/buildings/{buildingId}/assetops/work-orders`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Create a work order`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`POST`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`/api/v1/buildings/{buildingId}/assetops/work-orders`})})]})]})]}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`Grant matching Launchpad permissions before you call an endpoint. A valid token still returns `,_jsx(_components.code,{children:`403`}),` when the account lacks access to the building or operation.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`next-steps`,children:`Next steps`}),`\n`,_jsxs(CardGroup,{cols:2,children:[_jsx(Card,{title:`Permissions reference`,icon:`shield`,href:`/products/launchpad/client-organizations/service-accounts/permissions-reference`,children:_jsx(_components.p,{children:`Review Read and Write operations for each permission group.`})}),_jsx(Card,{title:`Authenticate with the KODE API`,icon:`key-round`,href:`/products/kode-api/authentication`,children:_jsx(_components.p,{children:`Exchange service account credentials for a Bearer access token.`})}),_jsx(Card,{title:`KODE API quickstart`,icon:`bolt`,href:`/products/kode-api/quickstart`,children:_jsx(_components.p,{children:`Request a token and list the buildings your account can access.`})}),_jsx(Card,{title:`KODE API reference`,icon:`book-open`,href:`/products/kode-api/api-reference/introduction`,children:_jsx(_components.p,{children:`Browse every endpoint, or fork the Postman collection.`})})]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"codeStyling":{"theme":{"light":"github-light","dark":"github-dark"}},"config":{},"pageMetadata":{"title":"Service Accounts","sidebarTitle":"Overview","description":"Create and manage Launchpad service accounts for KODE API integrations with OAuth 2.0 credentials and permissions.","icon":"dot","keywords":["client organization","service accounts","API","OAuth 2.0","keys","permissions","Launchpad","KODE OS"],"href":"/products/launchpad/client-organizations/service-accounts"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Details","slug":"details","depth":2,"children":[]},{"title":"Permissions","slug":"permissions","depth":2,"children":[]},{"title":"Create a service account","slug":"create-a-service-account","depth":2,"children":[]},{"title":"Common KODE API endpoints","slug":"common-kode-api-endpoints","depth":2,"children":[]},{"title":"Next steps","slug":"next-steps","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":["/_mintlify/custom/kodelabs/ce5d3bd08e955b7b/navbar-assistant.js"],"subdomain":"kodelabs","siteName":"KODE Labs - Product Documentation","title":"Service Accounts - KODE Labs - Product Documentation","contextualStarterQuestions":[{"_id":"6af8e4d39039cd94ad08f240","deploymentId":"67fd4d9635f314f3a994be65","questionText":"How do I create a service account?","status":"active","generatedBy":"contextual","path":"products/launchpad/client-organizations/service-accounts","createdAt":"2026-11-14T22:46:43.467Z","updatedAt":"2026-11-14T22:46:43.467Z","__v":0},{"_id":"6af8e4d39039cd94ad08f242","deploymentId":"67fd4d9635f314f3a994be65","questionText":"How do I assign permissions?","status":"active","generatedBy":"contextual","path":"products/launchpad/client-organizations/service-accounts","createdAt":"2026-11-14T22:46:43.467Z","updatedAt":"2026-11-14T22:46:43.467Z","__v":0},{"_id":"6af8e4d39039cd94ad08f241","deploymentId":"67fd4d9635f314f3a994be65","questionText":"What credentials can I generate?","status":"active","generatedBy":"contextual","path":"products/launchpad/client-organizations/service-accounts","createdAt":"2026-11-14T22:46:43.467Z","updatedAt":"2026-11-14T22:46:43.467Z","__v":0}],"navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-14T22:46:23.700Z","gitLastModified":"2026-11-14T22:46:03.000Z","originalFileLocation":"products/launchpad/client-organizations/service-accounts.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=\"light\";if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"light\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Create and manage Launchpad service accounts for KODE API integrations with OAuth 2.0 credentials and permissions.\">\u003cmeta data-mint-head name=\"application-name\" content=\"KODE Labs - Product 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/kodelabs/vtcGE1gj2AkAE1l2/_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/kodelabs/vtcGE1gj2AkAE1l2/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/kodelabs/vtcGE1gj2AkAE1l2/_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/kodelabs/vtcGE1gj2AkAE1l2/_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/kodelabs/vtcGE1gj2AkAE1l2/_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/kodelabs/vtcGE1gj2AkAE1l2/_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/kodelabs/vtcGE1gj2AkAE1l2/_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/kodelabs/vtcGE1gj2AkAE1l2/_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/kodelabs/vtcGE1gj2AkAE1l2/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Service Accounts - KODE Labs - Product Documentation\">\u003cmeta data-mint-head property=\"og:description\" content=\"Create and manage Launchpad service accounts for KODE API integrations with OAuth 2.0 credentials and permissions.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"KODE Labs - Product Documentation\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.kodelabs.com/products/launchpad/client-organizations/service-accounts\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://kodelabs.mintlify.site/_mintlify/api/og/v2?division=Service+Accounts\u0026amp;title=Service+Accounts\u0026amp;description=Create+and+manage+Launchpad+service+accounts+for+KODE+API+integrations+with+OAuth+2.0+credentials+and+permissions.\u0026amp;theme=ac252318c016362b89abdbd3\u0026amp;signature=fea5bf3511641caf2e208c229beb85d610d4d527cc2d9025205beb436cfdc8ea\">\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=\"Service Accounts - KODE Labs - Product Documentation\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Create and manage Launchpad service accounts for KODE API integrations with OAuth 2.0 credentials and permissions.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://kodelabs.mintlify.site/_mintlify/api/og/v2?division=Service+Accounts\u0026amp;title=Service+Accounts\u0026amp;description=Create+and+manage+Launchpad+service+accounts+for+KODE+API+integrations+with+OAuth+2.0+credentials+and+permissions.\u0026amp;theme=ac252318c016362b89abdbd3\u0026amp;signature=fea5bf3511641caf2e208c229beb85d610d4d527cc2d9025205beb436cfdc8ea\">\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/kodelabs/vtcGE1gj2AkAE1l2/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"KODE Labs - Product Documentation\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#015BFA\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.kodelabs.com/products/launchpad/client-organizations/service-accounts\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/products/launchpad/client-organizations/service-accounts.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.kodelabs.com/#organization\",\"name\":\"KODE Labs - Product Documentation\",\"url\":\"https://docs.kodelabs.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/kodelabs/YfYud6Al4TM68wc2/logo/logo-light.png?fit=max\u0026auto=format\u0026n=YfYud6Al4TM68wc2\u0026q=85\u0026s=00d4ffd6ad7a592e52856804d1a53d12\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.kodelabs.com#website\",\"name\":\"KODE Labs - Product Documentation\",\"url\":\"https://docs.kodelabs.com\",\"publisher\":{\"@id\":\"https://docs.kodelabs.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.kodelabs.com/products/launchpad/client-organizations/service-accounts#webpage\",\"url\":\"https://docs.kodelabs.com/products/launchpad/client-organizations/service-accounts\",\"name\":\"Service Accounts\",\"description\":\"Create and manage Launchpad service accounts for KODE API integrations with OAuth 2.0 credentials and permissions.\",\"dateModified\":\"2026-11-14T22:46:03.000Z\",\"isPartOf\":{\"@id\":\"https://docs.kodelabs.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.kodelabs.com/products/launchpad/client-organizations/service-accounts#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.kodelabs.com/products/launchpad/client-organizations/service-accounts#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Client Organizations\",\"item\":\"https://docs.kodelabs.com/products/launchpad/client-organizations/client-organization-overview\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Service Accounts\",\"item\":\"https://docs.kodelabs.com/products/launchpad/client-organizations/service-accounts\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.kodelabs.com/products/launchpad/client-organizations/service-accounts#article\",\"headline\":\"Service Accounts\",\"name\":\"Service Accounts\",\"description\":\"Create and manage Launchpad service accounts for KODE API integrations with OAuth 2.0 credentials and permissions.\",\"url\":\"https://docs.kodelabs.com/products/launchpad/client-organizations/service-accounts\",\"mainEntityOfPage\":{\"@id\":\"https://docs.kodelabs.com/products/launchpad/client-organizations/service-accounts#webpage\"},\"dateModified\":\"2026-11-14T22:46:03.000Z\",\"keywords\":\"client organization, service accounts, API, OAuth 2.0, keys, permissions, Launchpad, KODE OS\",\"publisher\":{\"@id\":\"https://docs.kodelabs.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.kodelabs.com#website\"}}]}\u003c/script>","agentPointerHref":"/products/launchpad/client-organizations/service-accounts.md","siteName":"KODE Labs - Product Documentation","nav":{"global":{"anchors":[{"anchor":"Home","icon":"house","href":"/"},{"anchor":"What's New","icon":"megaphone","href":"/whats-new/2026/v3.20-november-2026"}]},"products":[{"product":"Cloud BMS","icon":"https://mintlify.s3.us-west-1.amazonaws.com/kodelabs/images/cloud-bms.svg","description":"Cloud building management, graphics, and control","pages":[{"title":"Cloud BMS","href":"/products/kode-os/get-started/introduction"}]},{"product":"Building BI","icon":"https://mintlify.s3.us-west-1.amazonaws.com/kodelabs/images/bbi.svg","description":"Dashboards and analytics for building performance","pages":[{"title":"Building BI","href":"/products/building-bi/overview"}]},{"product":"FDD","icon":"https://mintlify.s3.us-west-1.amazonaws.com/kodelabs/images/fdd.svg","description":"Fault detection and diagnostics for equipment","pages":[{"title":"FDD","href":"/products/fdd/overview"}]},{"product":"FTT","icon":"https://mintlify.s3.us-west-1.amazonaws.com/kodelabs/images/ftt.svg","description":"Automated functional testing and commissioning","pages":[{"title":"FTT","href":"/products/ftt/overview"}]},{"product":"AssetOps","icon":"https://mintlify.s3.us-west-1.amazonaws.com/kodelabs/images/assetops.svg","description":"Asset and maintenance operations","pages":[{"title":"AssetOps","href":"/products/assetops/quickstart/overview"}]},{"product":"EnerG","icon":"https://mintlify.s3.us-west-1.amazonaws.com/kodelabs/images/enerG.svg","description":"Energy management and sustainability reporting","pages":[{"title":"EnerG","href":"/products/energ/get-started/introduction"}]},{"product":"Launchpad","icon":"https://mintlify.s3.us-west-1.amazonaws.com/kodelabs/images/launchpad.svg","description":"Dynamic management for apps, users, and buildings","groups":[{"group":"Get Started","pages":[{"title":"What's Launchpad?","sidebarTitle":"Introduction","icon":"rocket","href":"/products/launchpad/get-started/introduction"},{"title":"Provisioning Architecture","sidebarTitle":"Provisioning Architecture","icon":"git-branch","href":"/products/launchpad/get-started/provisioning-architecture"},{"title":"Accounts and Users","sidebarTitle":"Accounts and Users","icon":"users","href":"/products/launchpad/get-started/accounts-and-users"},{"title":"Workspaces \u0026 Sign-In","sidebarTitle":"Workspaces \u0026 Sign-In","icon":"log-in","href":"/products/launchpad/get-started/workspaces-and-sign-in"},{"title":"Configure Single Sign-On (SSO)","sidebarTitle":"Configure SSO","icon":"key","href":"/products/launchpad/get-started/configure-single-sign-on-sso"},{"title":"Security Settings","sidebarTitle":"Security Settings","icon":"shield","href":"/products/launchpad/get-started/security-settings"}]},{"group":"Channel Partners","pages":[{"title":"Channel Partners","sidebarTitle":"Overview","icon":"book-open","href":"/products/launchpad/channel-partners/channel-partner-overview"},{"title":"Clients","sidebarTitle":"Manage Clients","icon":"cog","href":"/products/launchpad/channel-partners/clients"},{"title":"Users","sidebarTitle":"Manage Users","icon":"cog","href":"/products/launchpad/channel-partners/users"},{"title":"Product Enablement","sidebarTitle":"Product Enablement","icon":"box","href":"/products/launchpad/channel-partners/product-enablement"}]},{"group":"Client Organizations","pages":[{"title":"Client Organizations","sidebarTitle":"Overview","icon":"book-open","href":"/products/launchpad/client-organizations/client-organization-overview"},{"title":"Users","sidebarTitle":"Manage Users","icon":"cog","href":"/products/launchpad/client-organizations/users"},{"title":"Buildings","sidebarTitle":"Manage Buildings","icon":"cog","href":"/products/launchpad/client-organizations/buildings"},{"group":"Apps","icon":"app-store","pages":[{"title":"Apps (KODE OS)","sidebarTitle":"Overview","icon":"dot","tag":"KODE OS","href":"/products/launchpad/client-organizations/apps"},{"title":"Permissions Reference","sidebarTitle":"Permissions Reference","description":"Reference for KODE OS role permissions by product","icon":"dot","href":"/products/launchpad/client-organizations/apps/permissions-reference"}]},{"group":"Service Accounts","icon":"webhook","pages":[{"title":"Service Accounts","sidebarTitle":"Overview","icon":"dot","href":"/products/launchpad/client-organizations/service-accounts"},{"title":"Permissions Reference","sidebarTitle":"Permissions Reference","description":"Reference for service account permission scopes and operations","icon":"dot","href":"/products/launchpad/client-organizations/service-accounts/permissions-reference"}]}]},{"group":"Reference","icon":"book-a","pages":[{"title":"KODE glossary","sidebarTitle":"Glossary","icon":"book-a","href":"/products/launchpad/glossary"}]}]},{"product":"Mobile app","icon":"https://mintlify.s3.us-west-1.amazonaws.com/kodelabs/images/mobile-app.svg","description":"Monitor and operate buildings from iOS and Android","pages":[{"title":"Mobile app","href":"/products/mobile-app/overview"}]},{"product":"KODE API","icon":"braces","description":"Build services and integrations with KODE OS","pages":[{"title":"KODE API","href":"/products/kode-api"}]},{"product":"Integrations","icon":"cable","description":"Connect 200+ building systems to KODE OS","pages":[{"title":"Integrations","href":"/products/integrations/get-started/introduction"}]},{"product":"What's New","icon":"megaphone","description":"KODE platform release notes and updates","pages":[{"title":"What's New","href":"/whats-new/2026/v3.20-november-2026"}]}]},"basePath":"","title":"Service Accounts - KODE Labs - Product Documentation","deploymentId":"dpl_vSEmv961Ncyvz1psVwgUnTXQMSYk","buildId":"dpl_vSEmv961Ncyvz1psVwgUnTXQMSYk","dynamics":["10e4515597","07c022d89b","a74be98ba7"],"chunks":["BannerMarkdown-DnSAhvaM.js","dist-DIfYWxfm.js","lib-DMeTj1gb.js","lib-B8HbPgcC.js","katex-Dbtb6Wk7.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js","Frame-BRsfsIIG.js","DynamicMarkdown-NFqqduU7.js","zoom-image-lightbox-BguUeq2N.js","lightbox-handle-r17bVUz3.js"]}