Give AI agents and automations their own Layers credentials and store roles, separate from any person on your team.
A service account is a non-human identity for an AI agent, script, or automation that connects to Layers. It has its own client ID and secret and its own role on each store you add it to. Use one when an automation should keep working regardless of who set it up, or when you want its access to be separate from any teammate’s.Service accounts connect to the Layers MCP server. They can’t sign in to the Layers dashboard.
Prerequisites
You need the Invite members, assign roles, manage custom roles permission on the store. The Owner and Admin roles include it.
You can only give a service account permissions you hold yourself.
Create a service account
Go to Settings > Service accounts, under Access & Security.
Click New service account.
Enter a Name that describes what the account is for, such as “Catalog sync agent”.
Copy the Client ID, Client secret, Token URL, and MCP URL from the dialog and store the secret somewhere safe.
The client secret is shown only once. If you lose it, rotate the secret to get a new one.
The account keeps the permissions you granted even if your own access changes later.
Review service accounts
The Service accounts page lists each account with its client ID, its roles on this store, and when and by whom it was created. Accounts that can publish changes without review show a Publishes without review badge. An account that belongs to your store but has no role on it shows Not on this store.Service accounts also appear in their own section on Settings > Users & Invites, marked with a bot badge. They don’t count as team members and don’t receive invites or notifications. Select Manage there to open the Service accounts page.
Change what a service account can do
Open the account’s actions menu and select Change access to update its roles and extra permissions on this store.
Publishing without review
By default, changes a service account makes through the shared editor go to a person for review, just like changes from an AI assistant connection. To let an account publish its changes straight to your live store, give it the Publish without review permission in the Access group, along with the edit permission for each resource it changes. This permission only affects service accounts.
Use a service account on more than one store
If your store belongs to an organization, a service account created on it belongs to the organization and can be added to the organization’s other stores. Open the account’s actions menu on another store’s Service accounts page and select Add to this store, then choose its role there. Each store has its own role for the account.To take an account off one store, select Remove from this store. It loses its role on that store, but its secret keeps working on its other stores. Detaching a store from the organization also removes the organization’s service accounts from that store.Organization owners and admins can see every service account in the organization. To manage an account that is on several stores, you need access management permission on each of them.
Rotate a secret
Rotate a secret when it may have been exposed, or as part of a routine security review.
Open the account’s actions menu and select Rotate secret.
Confirm. A new secret is shown once; copy it.
Update the automation with the new secret.
Rotation takes effect immediately. The old secret and every token created with it stop working right away, with no grace period.
Revoke a service account
Revoke an account when the automation it belongs to is retired. Open the account’s actions menu, select Revoke, and confirm. Its tokens stop working on every store and no new tokens can be issued. Revoking can’t be undone. The account stays in the list with a Revoked badge so its history remains visible.
Rename a service account
Open the account’s actions menu and select Rename. Renaming doesn’t change its credentials or access.
Troubleshooting
The automation gets a permission error. The account’s role on that store doesn’t include the permission the action needs, or the account hasn’t been added to that store. Select Change access or Add to this store to fix it.The automation stopped connecting after a rotation. Update it with the new secret. Secrets from before the rotation no longer work.You can’t grant a role or rotate a secret. You can only grant, and rotate secrets for, permissions you hold yourself on every store the account belongs to. Ask an Owner or Admin to make the change.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Layers","colors":{"primary":"#607FFD","light":"#AFC0FF","dark":"#3A57E8"},"logo":{"light":"https://mintcdn.com/protoninc/PNs-gxGUVcdBDEEC/logo.svg?fit=max\u0026auto=format\u0026n=PNs-gxGUVcdBDEEC\u0026q=85\u0026s=989e3194cb32f07e7018b8b7186b9007","dark":"https://mintcdn.com/protoninc/PNs-gxGUVcdBDEEC/logo.svg?fit=max\u0026auto=format\u0026n=PNs-gxGUVcdBDEEC\u0026q=85\u0026s=989e3194cb32f07e7018b8b7186b9007","href":"https://www.uselayers.com/?utm_source=docs\u0026utm_medium=referral\u0026utm_campaign=docs-to-site"},"favicon":"https://mintcdn.com/protoninc/qubyNEZK4oJTl9By/favicon.svg?fit=max\u0026auto=format\u0026n=qubyNEZK4oJTl9By\u0026q=85\u0026s=3611d60346e12f15e4684bc60cb69ece","api":{"mdx":{"server":"https://app.uselayers.com/api/storefront/v1"}},"navbar":{"links":[{"href":"https://www.uselayers.com/changelog?utm_source=docs\u0026utm_medium=referral\u0026utm_campaign=docs-to-site","label":"Changelog"},{"href":"mailto:support@uselayers.com","label":"Support"},{"href":"https://app.uselayers.com/dashboard?utm_source=docs\u0026utm_medium=referral\u0026utm_campaign=docs-to-dashboard","label":"Dashboard"}],"primary":{"type":"button","label":"Request Demo","href":"https://www.uselayers.com/demo?utm_source=docs\u0026utm_medium=referral\u0026utm_campaign=docs-to-site"}},"footer":{"socials":{"linkedin":"https://www.linkedin.com/company/uselayers"},"links":[{"header":"Legal","items":[{"label":"Privacy Statement","href":"https://docs.uselayers.com/legal/privacy-statement"},{"label":"Terms of Use","href":"https://docs.uselayers.com/legal/terms-of-use"}]}]},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"styling":{"latex":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"protoninc","hasAudioNarration":false,"actualSubdomain":"protoninc","customDomains":["docs.uselayers.com"],"gitSource":{"type":"github","owner":"protonagency","repo":"layers-docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"feedback":{"thumbs":true,"edits":false,"issues":false,"agentFeedback":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"REMOVE_BRANDING":{"status":"ENABLED"}},"buildId":"6b00be7a93a47743e4aca507","clientVersion":"0.0.4248","searchFilterCounts":[{"language":"default","tag":"Documentation","count":103},{"language":"default","tag":"Help Center","count":91},{"language":"default","tag":"Merchandising","count":57},{"language":"default","tag":"Developers","count":42},{"language":"default","tag":"API Reference","count":25},{"language":"default","tag":"SDK","count":20},{"language":"default","tag":"Sort Orders","count":18},{"language":"default","tag":"Configuration","count":16},{"language":"default","tag":"Liquid","count":14},{"language":"default","tag":"Search \u0026 Discovery","count":14}]},"assistantConfig":{"enableAskAiButton":true,"enableAskAiSearchBar":false,"deflection":{"enabled":true,"email":"support@uselayers.com","showHelpButton":true}},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":false,"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":"site-roles","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":false},"customCss":[]}
{"page":{"pagePath":"help/configuration/manage-service-accounts","slug":"/help/configuration/manage-service-accounts","pageMetadata":{"title":"Manage service accounts","description":"Give AI agents and automations their own Layers credentials and store roles, separate from any person on your team.","href":"/help/configuration/manage-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: \"Give AI agents and automations their own Layers credentials and store roles, separate from any person on your team.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,li:`li`,ol:`ol`,p:`p`,strong:`strong`,ul:`ul`,..._provideComponents(),...props.components},{Heading,Warning}=_components;if(!Heading)_missingMdxReference(`Heading`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`A `,_jsx(_components.strong,{children:`service account`}),` is a non-human identity for an AI agent, script, or automation that connects to Layers. It has its own client ID and secret and its own role on each store you add it to. Use one when an automation should keep working regardless of who set it up, or when you want its access to be separate from any teammate’s.`]}),`\n`,_jsxs(_components.p,{children:[`Service accounts connect to the `,_jsx(_components.a,{href:`/developers/mcp-servers#connecting-with-a-service-account`,children:`Layers MCP server`}),`. They can’t sign in to the Layers dashboard.`]}),`\n`,_jsx(Heading,{level:`2`,id:`prerequisites`,children:`Prerequisites`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`You need the `,_jsx(_components.strong,{children:`Invite members, assign roles, manage custom roles`}),` permission on the store. The Owner and Admin roles include it.`]}),`\n`,_jsx(_components.li,{children:`You can only give a service account permissions you hold yourself.`}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`create-a-service-account`,children:`Create a service account`}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[`Go to `,_jsx(_components.strong,{children:`Settings > Service accounts`}),`, under `,_jsx(_components.strong,{children:`Access \u0026 Security`}),`.`]}),`\n`,_jsxs(_components.li,{children:[`Click `,_jsx(_components.strong,{children:`New service account`}),`.`]}),`\n`,_jsxs(_components.li,{children:[`Enter a `,_jsx(_components.strong,{children:`Name`}),` that describes what the account is for, such as “Catalog sync agent”.`]}),`\n`,_jsxs(_components.li,{children:[`Select one or more roles, and optionally add extra permissions, including `,_jsx(_components.a,{href:`/help/configuration/manage-roles-and-permissions#resource-scoped-permissions`,children:`resource-scoped permissions`}),`.`]}),`\n`,_jsxs(_components.li,{children:[`Click `,_jsx(_components.strong,{children:`Create`}),`.`]}),`\n`,_jsxs(_components.li,{children:[`Copy the `,_jsx(_components.strong,{children:`Client ID`}),`, `,_jsx(_components.strong,{children:`Client secret`}),`, `,_jsx(_components.strong,{children:`Token URL`}),`, and `,_jsx(_components.strong,{children:`MCP URL`}),` from the dialog and store the secret somewhere safe.`]}),`\n`]}),`\n`,_jsx(Warning,{children:_jsx(_components.p,{children:`The client secret is shown only once. If you lose it, rotate the secret to get a new one.`})}),`\n`,_jsx(_components.p,{children:`The account keeps the permissions you granted even if your own access changes later.`}),`\n`,_jsx(Heading,{level:`2`,id:`review-service-accounts`,children:`Review service accounts`}),`\n`,_jsxs(_components.p,{children:[`The `,_jsx(_components.strong,{children:`Service accounts`}),` page lists each account with its client ID, its roles on this store, and when and by whom it was created. Accounts that can publish changes without review show a `,_jsx(_components.strong,{children:`Publishes without review`}),` badge. An account that belongs to your store but has no role on it shows `,_jsx(_components.strong,{children:`Not on this store`}),`.`]}),`\n`,_jsxs(_components.p,{children:[`Service accounts also appear in their own section on `,_jsx(_components.strong,{children:`Settings > Users \u0026 Invites`}),`, marked with a bot badge. They don’t count as team members and don’t receive invites or notifications. Select `,_jsx(_components.strong,{children:`Manage`}),` there to open the `,_jsx(_components.strong,{children:`Service accounts`}),` page.`]}),`\n`,_jsx(Heading,{level:`2`,id:`change-what-a-service-account-can-do`,children:`Change what a service account can do`}),`\n`,_jsxs(_components.p,{children:[`Open the account’s actions menu and select `,_jsx(_components.strong,{children:`Change access`}),` to update its roles and extra permissions on this store.`]}),`\n`,_jsx(Heading,{level:`3`,id:`publishing-without-review`,children:`Publishing without review`}),`\n`,_jsxs(_components.p,{children:[`By default, changes a service account makes through the shared editor go to a person for review, just like changes from an AI assistant connection. To let an account publish its changes straight to your live store, give it the `,_jsx(_components.strong,{children:`Publish without review`}),` permission in the `,_jsx(_components.strong,{children:`Access`}),` group, along with the edit permission for each resource it changes. This permission only affects service accounts.`]}),`\n`,_jsx(Heading,{level:`2`,id:`use-a-service-account-on-more-than-one-store`,children:`Use a service account on more than one store`}),`\n`,_jsxs(_components.p,{children:[`If your store belongs to an `,_jsx(_components.a,{href:`/help/configuration/manage-organizations`,children:`organization`}),`, a service account created on it belongs to the organization and can be added to the organization’s other stores. Open the account’s actions menu on another store’s `,_jsx(_components.strong,{children:`Service accounts`}),` page and select `,_jsx(_components.strong,{children:`Add to this store`}),`, then choose its role there. Each store has its own role for the account.`]}),`\n`,_jsxs(_components.p,{children:[`To take an account off one store, select `,_jsx(_components.strong,{children:`Remove from this store`}),`. It loses its role on that store, but its secret keeps working on its other stores. Detaching a store from the organization also removes the organization’s service accounts from that store.`]}),`\n`,_jsx(_components.p,{children:`Organization owners and admins can see every service account in the organization. To manage an account that is on several stores, you need access management permission on each of them.`}),`\n`,_jsx(Heading,{level:`2`,id:`rotate-a-secret`,children:`Rotate a secret`}),`\n`,_jsx(_components.p,{children:`Rotate a secret when it may have been exposed, or as part of a routine security review.`}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[`Open the account’s actions menu and select `,_jsx(_components.strong,{children:`Rotate secret`}),`.`]}),`\n`,_jsx(_components.li,{children:`Confirm. A new secret is shown once; copy it.`}),`\n`,_jsx(_components.li,{children:`Update the automation with the new secret.`}),`\n`]}),`\n`,_jsx(Warning,{children:_jsx(_components.p,{children:`Rotation takes effect immediately. The old secret and every token created with it stop working right away, with no grace period.`})}),`\n`,_jsx(Heading,{level:`2`,id:`revoke-a-service-account`,children:`Revoke a service account`}),`\n`,_jsxs(_components.p,{children:[`Revoke an account when the automation it belongs to is retired. Open the account’s actions menu, select `,_jsx(_components.strong,{children:`Revoke`}),`, and confirm. Its tokens stop working on every store and no new tokens can be issued. Revoking can’t be undone. The account stays in the list with a `,_jsx(_components.strong,{children:`Revoked`}),` badge so its history remains visible.`]}),`\n`,_jsx(Heading,{level:`2`,id:`rename-a-service-account`,children:`Rename a service account`}),`\n`,_jsxs(_components.p,{children:[`Open the account’s actions menu and select `,_jsx(_components.strong,{children:`Rename`}),`. Renaming doesn’t change its credentials or access.`]}),`\n`,_jsx(Heading,{level:`2`,id:`troubleshooting`,children:`Troubleshooting`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`The automation gets a permission error.`}),` The account’s role on that store doesn’t include the permission the action needs, or the account hasn’t been added to that store. Select `,_jsx(_components.strong,{children:`Change access`}),` or `,_jsx(_components.strong,{children:`Add to this store`}),` to fix it.`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`The automation stopped connecting after a rotation.`}),` Update it with the new secret. Secrets from before the rotation no longer work.`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`You can’t grant a role or rotate a secret.`}),` You can only grant, and rotate secrets for, permissions you hold yourself on every store the account belongs to. Ask an Owner or Admin to make the change.`]}),`\n`,_jsx(Heading,{level:`2`,id:`next-steps`,children:`Next steps`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:_jsx(_components.a,{href:`/developers/mcp-servers#connecting-with-a-service-account`,children:`Connect a service account to the Layers MCP server`})}),`\n`,_jsx(_components.li,{children:_jsx(_components.a,{href:`/help/configuration/manage-roles-and-permissions`,children:`Manage roles and permissions`})}),`\n`,_jsx(_components.li,{children:_jsx(_components.a,{href:`/help/configuration/manage-team-members`,children:`Manage team members`})}),`\n`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Manage service accounts","description":"Give AI agents and automations their own Layers credentials and store roles, separate from any person on your team.","href":"/help/configuration/manage-service-accounts"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Prerequisites","slug":"prerequisites","depth":2,"children":[]},{"title":"Create a service account","slug":"create-a-service-account","depth":2,"children":[]},{"title":"Review service accounts","slug":"review-service-accounts","depth":2,"children":[]},{"title":"Change what a service account can do","slug":"change-what-a-service-account-can-do","depth":2,"children":[{"title":"Publishing without review","slug":"publishing-without-review","depth":3,"children":[]}]},{"title":"Use a service account on more than one store","slug":"use-a-service-account-on-more-than-one-store","depth":2,"children":[]},{"title":"Rotate a secret","slug":"rotate-a-secret","depth":2,"children":[]},{"title":"Revoke a service account","slug":"revoke-a-service-account","depth":2,"children":[]},{"title":"Rename a service account","slug":"rename-a-service-account","depth":2,"children":[]},{"title":"Troubleshooting","slug":"troubleshooting","depth":2,"children":[]},{"title":"Next steps","slug":"next-steps","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":["/_mintlify/custom/protoninc/d2da920448b9ce07/track.js"],"subdomain":"protoninc","siteName":"Layers","title":"Manage service accounts - Layers","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-20T14:40:05.582Z","originalFileLocation":"help/configuration/manage-service-accounts.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=\"Give AI agents and automations their own Layers credentials and store roles, separate from any person on your team.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Layers\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/protoninc/-Zid9_7urMZu-aPC/_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/protoninc/-Zid9_7urMZu-aPC/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/protoninc/-Zid9_7urMZu-aPC/_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/protoninc/-Zid9_7urMZu-aPC/_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/protoninc/-Zid9_7urMZu-aPC/_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/protoninc/-Zid9_7urMZu-aPC/_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/protoninc/-Zid9_7urMZu-aPC/_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/protoninc/-Zid9_7urMZu-aPC/_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/protoninc/-Zid9_7urMZu-aPC/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Manage service accounts - Layers\">\u003cmeta data-mint-head property=\"og:description\" content=\"Give AI agents and automations their own Layers credentials and store roles, separate from any person on your team.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Layers\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.uselayers.com/help/configuration/manage-service-accounts\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://protoninc.mintlify.site/_mintlify/api/og/v2?division=Configuration\u0026amp;title=Manage+service+accounts\u0026amp;description=Give+AI+agents+and+automations+their+own+Layers+credentials+and+store+roles%2C+separate+from+any+person+on+your+team.\u0026amp;theme=b639e83e40674e1127455713\u0026amp;signature=c3aad82a9b2811ed08e39cd465f7514f107ed3fb70bf3b3a9203a86176cac092\">\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=\"Manage service accounts - Layers\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Give AI agents and automations their own Layers credentials and store roles, separate from any person on your team.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://protoninc.mintlify.site/_mintlify/api/og/v2?division=Configuration\u0026amp;title=Manage+service+accounts\u0026amp;description=Give+AI+agents+and+automations+their+own+Layers+credentials+and+store+roles%2C+separate+from+any+person+on+your+team.\u0026amp;theme=b639e83e40674e1127455713\u0026amp;signature=c3aad82a9b2811ed08e39cd465f7514f107ed3fb70bf3b3a9203a86176cac092\">\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/protoninc/-Zid9_7urMZu-aPC/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Layers\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#607FFD\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.uselayers.com/help/configuration/manage-service-accounts\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/help/configuration/manage-service-accounts.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.uselayers.com/#organization\",\"name\":\"Layers\",\"url\":\"https://docs.uselayers.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/protoninc/PNs-gxGUVcdBDEEC/logo.svg?fit=max\u0026auto=format\u0026n=PNs-gxGUVcdBDEEC\u0026q=85\u0026s=989e3194cb32f07e7018b8b7186b9007\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.uselayers.com#website\",\"name\":\"Layers\",\"url\":\"https://docs.uselayers.com\",\"publisher\":{\"@id\":\"https://docs.uselayers.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.uselayers.com/help/configuration/manage-service-accounts#webpage\",\"url\":\"https://docs.uselayers.com/help/configuration/manage-service-accounts\",\"name\":\"Manage service accounts\",\"description\":\"Give AI agents and automations their own Layers credentials and store roles, separate from any person on your team.\",\"dateModified\":\"2026-11-20T14:40:05.582Z\",\"isPartOf\":{\"@id\":\"https://docs.uselayers.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.uselayers.com/help/configuration/manage-service-accounts#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.uselayers.com/help/configuration/manage-service-accounts#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Configuration\",\"item\":\"https://docs.uselayers.com/help/configuration/navigate-settings\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Manage service accounts\",\"item\":\"https://docs.uselayers.com/help/configuration/manage-service-accounts\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.uselayers.com/help/configuration/manage-service-accounts#article\",\"headline\":\"Manage service accounts\",\"name\":\"Manage service accounts\",\"description\":\"Give AI agents and automations their own Layers credentials and store roles, separate from any person on your team.\",\"url\":\"https://docs.uselayers.com/help/configuration/manage-service-accounts\",\"mainEntityOfPage\":{\"@id\":\"https://docs.uselayers.com/help/configuration/manage-service-accounts#webpage\"},\"dateModified\":\"2026-11-20T14:40:05.582Z\",\"publisher\":{\"@id\":\"https://docs.uselayers.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.uselayers.com#website\"}}]}\u003c/script>","agentPointerHref":"/help/configuration/manage-service-accounts.md","siteName":"Layers","nav":{"global":null,"anchors":[{"anchor":"Documentation","pages":[{"title":"Documentation","href":"/introduction"}]},{"anchor":"Help Center","icon":"map","groups":[{"group":"Getting Started","pages":[{"title":"Install Layers on Shopify","href":"/help/onboarding/install"},{"title":"Dashboard home","href":"/help/onboarding/dashboard-home"},{"title":"Demo store setup","href":"/help/onboarding/setting-up-a-demo-store"},{"title":"Creating a crawler signature","href":"/help/onboarding/creating-crawler-signature"},{"title":"Exporting search data","href":"/help/onboarding/exporting-search-data"},{"title":"Migrate from Boost Commerce","sidebarTitle":"Migrate from Boost","href":"/help/onboarding/migrate-from-boost"}]},{"group":"Catalog","pages":[{"title":"View product details","href":"/help/catalog/view-product-details"},{"title":"See how AI reads a product in your catalog","href":"/help/catalog/how-ai-sees-this-product"},{"title":"View collection details and performance","href":"/help/catalog/view-collection-details"},{"title":"Filter the products list","href":"/help/catalog/filter-products-list"},{"title":"Manually resync your entire catalog","href":"/help/catalog/resync-catalog"},{"title":"Manually resync a single collection","href":"/help/catalog/resync-single-collection"},{"title":"Manually resync a single product","href":"/help/catalog/resync-single-product"},{"title":"Manually resync variant inventory","href":"/help/catalog/resync-variant-inventory"},{"title":"Working with dates","href":"/help/catalog/working-with-dates"},{"title":"Time a product drop","href":"/help/catalog/product-drops"},{"title":"Sort and filter by product reviews","href":"/help/catalog/review-apps"}]},{"group":"Sort Orders","pages":[{"title":"Create a sort order","href":"/help/sort-orders/create-sort-order"},{"title":"Preview a sort order","href":"/help/sort-orders/preview-sort-order"},{"title":"Duplicate a sort order","href":"/help/sort-orders/duplicate-sort-order"},{"title":"Find duplicate sort orders in the dashboard","href":"/help/sort-orders/duplicate-detection"},{"title":"Reorder sort orders","href":"/help/sort-orders/reorder-sort-orders"},{"title":"Manage sort orders in bulk","href":"/help/sort-orders/bulk-actions"},{"title":"Run a sort order A/B test experiment","href":"/help/sort-orders/experiments"},{"title":"Test sort orders by audience","href":"/help/sort-orders/test-sorts-by-audience"},{"title":"How Best Selling works","href":"/help/sort-orders/how-best-selling-works"}]},{"group":"Recommendation Blocks","pages":[{"title":"Manage blocks in bulk","href":"/help/blocks/bulk-actions"},{"title":"View block performance","href":"/help/blocks/view-performance"},{"title":"Exclude products from recommendations","href":"/help/blocks/exclude-products"}]},{"group":"Product Sequences","pages":[{"title":"Create a product sequence","href":"/help/sequences/create-product-sequence"},{"title":"Edit a product sequence","href":"/help/sequences/edit-product-sequence"},{"title":"Manage product sequences in bulk","href":"/help/sequences/bulk-actions"}]},{"group":"Customers","pages":[{"title":"Manage audiences","href":"/help/configuration/manage-audiences"},{"title":"Manage dimensions","href":"/help/configuration/manage-dimensions"}]},{"group":"Configuration","pages":[{"title":"Navigate settings","href":"/help/configuration/navigate-settings"},{"title":"Manage API access","href":"/help/configuration/manage-api-access"},{"title":"Manage outbound webhooks","href":"/help/configuration/manage-webhooks"},{"title":"Review developer notices","href":"/help/configuration/view-developer-notices"},{"title":"Manage team members","description":"Invite teammates to your Layers store by email or link, assign roles, manage individual access, transfer ownership, and remove members.","href":"/help/configuration/manage-team-members"},{"title":"Manage service accounts","href":"/help/configuration/manage-service-accounts"},{"title":"Secure your account","description":"Change your password, turn on two-factor authentication with an authenticator app, save recovery codes, and log in with passkeys.","href":"/help/configuration/secure-your-account"},{"title":"Manage roles and permissions","href":"/help/configuration/manage-roles-and-permissions"},{"title":"Manage organizations","href":"/help/configuration/manage-organizations"},{"title":"View GDPR requests","href":"/help/configuration/view-gdpr-requests"},{"title":"View billing","href":"/help/configuration/view-billing"},{"title":"Configure autocomplete curation","href":"/help/configuration/configure-autocomplete-curation"},{"title":"Configure search instructions","href":"/help/configuration/configure-search-instructions"},{"title":"Set up Agentic Feedback for AI agents","sidebarTitle":"Set up Agentic Feedback","href":"/help/configuration/set-up-agentic-feedback"},{"title":"Manage store knowledge","href":"/help/configuration/manage-store-knowledge"},{"title":"Config history and version restore","href":"/help/configuration/config-history"}]},{"group":"Ranking Relevancy","pages":[{"title":"Tune signal weights","href":"/help/ranking-relevancy/tune-signal-weights"},{"title":"Create a ranking rule","href":"/help/ranking-relevancy/create-ranking-rule"},{"title":"Manage ranking rules in bulk","href":"/help/ranking-relevancy/bulk-actions"}]},{"group":"Lab","pages":[{"title":"Lab Insights for trends, anomalies, and opportunities","href":"/help/lab/insights"},{"title":"Analytics dashboards","href":"/help/analytics/dashboards"},{"title":"Weekly performance report email","href":"/help/analytics/weekly-report-email"},{"title":"Analytics metrics glossary","href":"/help/analytics/metrics-glossary"},{"title":"Shopify search reports after switching to Layers","href":"/help/analytics/shopify-search-reports"},{"title":"Test text search (with demo profiles)","href":"/help/evaluate/test-text-search"},{"title":"Test image search","href":"/help/evaluate/test-image-search"},{"title":"Test content search with the API","href":"/help/evaluate/test-content-search"},{"title":"Test collections and similar products","href":"/help/evaluate/test-collections-and-similar-products"}]},{"group":"Merchandising","pages":[{"title":"Create a merchandising rule","href":"/help/merchandising/create-merchandising-rule"},{"title":"Edit, disable, or delete a merchandising rule","href":"/help/merchandising/edit-disable-delete-merchandising-rule"},{"title":"Add a banner to a merchandising rule","href":"/help/merchandising/add-banner-to-rule"},{"title":"Create a banner type","href":"/help/configuration/create-banner-type"},{"title":"Manage merchandising rules in bulk","href":"/help/merchandising/bulk-actions"},{"title":"Recover a deleted merchandising rule","href":"/help/merchandising/restore-deleted-merchandising-rule"},{"title":"Dynamic linking for ads","href":"/help/merchandising/dynamic-linking"},{"title":"Feature new arrivals","href":"/help/merchandising/feature-new-arrivals"},{"title":"Demote sale and final-sale products","href":"/help/merchandising/demote-products"},{"title":"Create a semantic redirect","href":"/help/merchandising/create-semantic-redirect"},{"title":"View merchandising rule performance","href":"/help/merchandising/view-rule-performance"},{"title":"Create a variant breakout","href":"/help/merchandising/create-variant-breakout"},{"title":"Edit or delete a variant breakout","href":"/help/merchandising/edit-delete-variant-breakout"},{"title":"Manage variant breakouts in bulk","href":"/help/merchandising/bulk-actions-variant-breakouts"},{"title":"Group facet values","href":"/help/advanced-merchandising/facet-grouping"},{"title":"Sort facet values","href":"/help/advanced-merchandising/facet-sorting"},{"title":"Hide facet values","href":"/help/advanced-merchandising/facet-hiding"},{"title":"View the products behind a facet value","href":"/help/advanced-merchandising/facet-value-products"},{"title":"Set up a pickup in store filter","href":"/help/advanced-merchandising/pickup-filter"},{"title":"Create a product family","href":"/help/product-families/create-product-family"},{"title":"Manage product families in bulk","href":"/help/product-families/bulk-actions"}]},{"group":"Troubleshooting","pages":[{"title":"Merchandising rule not applying","href":"/help/troubleshooting/rule-not-applying"},{"title":"Pinned products not appearing","href":"/help/troubleshooting/pins-not-showing"},{"title":"Login and access problems","href":"/help/troubleshooting/login-and-access"},{"title":"Recommendations look thin, off-category, or missing","href":"/help/troubleshooting/recommendations-thin-or-off-category"},{"title":"Product missing from a filter","href":"/help/troubleshooting/product-missing-from-filter"},{"title":"Fix unexpected search results","href":"/help/troubleshooting/search-results"},{"title":"Collection count doesn't match Shopify","href":"/help/troubleshooting/collection-count-mismatch"}]},{"group":"Misc","pages":[{"title":"Configure search behavior","href":"/help/configuration/configure-search-behavior"}]}]},{"anchor":"Developers","icon":"code","pages":[{"title":"Developers","href":"/developers/overview"}]},{"anchor":"API Reference","icon":"rectangle-terminal","pages":[{"title":"API Reference","href":"/api-reference/browse"}]},{"anchor":"Integrations","icon":"plug","href":"https://www.uselayers.com/integrations?utm_source=docs\u0026utm_medium=referral\u0026utm_campaign=docs-to-site"}]},"basePath":"","title":"Manage service accounts - Layers","deploymentId":"dpl_2pTxFtyBudBMYZiCw1MyvoA1wxpd","buildId":"dpl_2pTxFtyBudBMYZiCw1MyvoA1wxpd","dynamics":[],"chunks":[]}