What each scope allows, and how to rotate and revoke keys.
A key belongs to your organization, not to a person. It can do exactly what its scopes allow, and only for modules your organization’s subscription includes.
Revoke the old key in Settings → Integrations → API keys.
Revoke a key
Revoke a key in Settings → Integrations → API keys. It stops working on the next request.
⌘I
{"docsConfig":{"theme":"willow","$schema":"https://mintlify.com/docs.json","name":"Marro","description":"How to set up and use Marro, and connect to its API.","colors":{"primary":"#047857","light":"#34d399","dark":"#047857"},"logo":{"light":"https://mintcdn.com/marro/L_ff4QIYNuKFkgUx/logo/light.svg?fit=max\u0026auto=format\u0026n=L_ff4QIYNuKFkgUx\u0026q=85\u0026s=3b6108c447441cf9e27b14912873f0ac","dark":"https://mintcdn.com/marro/L_ff4QIYNuKFkgUx/logo/dark.svg?fit=max\u0026auto=format\u0026n=L_ff4QIYNuKFkgUx\u0026q=85\u0026s=1e2a582df4590b0c2af338ff6d625369","href":"https://marro.si"},"favicon":"https://mintcdn.com/marro/L_ff4QIYNuKFkgUx/favicon.svg?fit=max\u0026auto=format\u0026n=L_ff4QIYNuKFkgUx\u0026q=85\u0026s=a6d96cfda52d766e5a462d9d1fe64b99","api":{"playground":{"display":"interactive"},"examples":{"languages":["bash","javascript","php","python"]}},"appearance":{"default":"system"},"navbar":{"primary":{"type":"button","label":"Open Marro","href":"https://app.marro.si"}},"fonts":{"family":"Plus Jakarta Sans"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"marro","hasAudioNarration":false,"actualSubdomain":"marro","customDomains":["docs.marro.si"],"gitSource":{"type":"github","owner":"bharathvasireddy","repo":"marro-docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"DISABLED"},"WEB_MCP":{"status":"DISABLED"},"NARRATION":{"status":"DISABLED"}},"buildId":"6b021102f1d57ff81b93602a","clientVersion":"0.0.4270","searchFilterCounts":[{"language":"default","tag":"API reference","count":68},{"language":"default","tag":"Guides","count":65},{"language":"default","tag":"Use Marro","count":50},{"language":"default","tag":"Custom objects","count":15},{"language":"default","tag":"Money","count":15},{"language":"default","tag":"Leads","count":11},{"language":"default","tag":"Customers","count":10},{"language":"default","tag":"Reference","count":10},{"language":"default","tag":"API","count":7},{"language":"default","tag":"Get started","count":6}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"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":"control","enabled":true,"payload":{"type":"string","value":"control"},"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":[]}
{"page":{"pagePath":"keys-and-scopes","slug":"/keys-and-scopes","pageMetadata":{"title":"Keys and scopes","description":"What each scope allows, and how to rotate and revoke keys.","href":"/keys-and-scopes"},"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: \"What each scope allows, and how to rotate and revoke keys.\"\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`,ol:`ol`,p:`p`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,..._provideComponents(),...props.components},{Heading,Table}=_components;if(!Heading)_missingMdxReference(`Heading`,true);if(!Table)_missingMdxReference(`Table`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`A key belongs to your organization, not to a person. It can do exactly what its scopes allow, and only for modules your organization’s subscription includes.`}),`\n`,_jsx(Heading,{level:`2`,id:`scopes`,children:`Scopes`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Scope`}),_jsx(_components.th,{children:`Name`}),_jsx(_components.th,{children:`Endpoints`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`objects.records.read`})}),_jsx(_components.td,{}),_jsxs(_components.td,{children:[_jsx(_components.a,{href:`/api-reference/custom-objects/list-custom-objects`,children:`List custom objects`}),`, `,_jsx(_components.a,{href:`/api-reference/custom-objects/get-custom-object`,children:`Read a custom-object definition`}),`, `,_jsx(_components.a,{href:`/api-reference/custom-objects/list-object-records`,children:`List custom-object records`}),`, `,_jsx(_components.a,{href:`/api-reference/custom-objects/get-object-record`,children:`Read a custom-object record`}),`, `,_jsx(_components.a,{href:`/api-reference/custom-objects/object-record-linked-from`,children:`Records linked to a custom-object record`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`objects.records.write`})}),_jsx(_components.td,{}),_jsxs(_components.td,{children:[_jsx(_components.a,{href:`/api-reference/custom-objects/create-object-record`,children:`Create a custom-object record`}),`, `,_jsx(_components.a,{href:`/api-reference/custom-objects/update-object-record`,children:`Update a custom-object record`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`objects.records.delete`})}),_jsx(_components.td,{}),_jsx(_components.td,{children:_jsx(_components.a,{href:`/api-reference/custom-objects/delete-object-record`,children:`Delete a custom-object record`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`reports.read`})}),_jsx(_components.td,{}),_jsxs(_components.td,{children:[_jsx(_components.a,{href:`/api-reference/reports/list-reports`,children:`List reports`}),`, `,_jsx(_components.a,{href:`/api-reference/reports/get-report-results`,children:`Run a report`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`money.read`})}),_jsx(_components.td,{}),_jsxs(_components.td,{children:[_jsx(_components.a,{href:`/api-reference/money/list-products`,children:`List products and services`}),`, `,_jsx(_components.a,{href:`/api-reference/money/list-quotes`,children:`List quotes`}),`, `,_jsx(_components.a,{href:`/api-reference/money/get-quote`,children:`Read a quote`}),`, `,_jsx(_components.a,{href:`/api-reference/money/list-invoices`,children:`List invoices`}),`, `,_jsx(_components.a,{href:`/api-reference/money/get-invoice`,children:`Read a invoice`}),`, `,_jsx(_components.a,{href:`/api-reference/money/list-payments`,children:`List payments`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`money.write`})}),_jsx(_components.td,{}),_jsxs(_components.td,{children:[_jsx(_components.a,{href:`/api-reference/money/create-quote`,children:`Create a quote`}),`, `,_jsx(_components.a,{href:`/api-reference/money/create-invoice`,children:`Create a invoice`}),`, `,_jsx(_components.a,{href:`/api-reference/money/record-invoice-payment`,children:`Record a payment`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`leads.read`})}),_jsx(_components.td,{}),_jsxs(_components.td,{children:[_jsx(_components.a,{href:`/api-reference/leads/list-leads`,children:`List leads`}),`, `,_jsx(_components.a,{href:`/api-reference/leads/get-lead`,children:`Get a lead`}),`, `,_jsx(_components.a,{href:`/api-reference/reference/list-fields`,children:`List lead fields`}),`, `,_jsx(_components.a,{href:`/api-reference/reference/list-stages`,children:`List stages`}),`, `,_jsx(_components.a,{href:`/api-reference/reference/list-pipelines`,children:`List pipelines`}),`, `,_jsx(_components.a,{href:`/api-reference/reference/list-branches`,children:`List branches`}),`, `,_jsx(_components.a,{href:`/api-reference/reference/list-sources`,children:`List sources`}),`, `,_jsx(_components.a,{href:`/api-reference/reference/list-users`,children:`List people`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`leads.write`})}),_jsx(_components.td,{}),_jsxs(_components.td,{children:[_jsx(_components.a,{href:`/api-reference/leads/create-lead`,children:`Create a lead`}),`, `,_jsx(_components.a,{href:`/api-reference/leads/capture-lead`,children:`Capture a lead`}),`, `,_jsx(_components.a,{href:`/api-reference/leads/update-lead`,children:`Update a lead`}),`, `,_jsx(_components.a,{href:`/api-reference/leads/add-note`,children:`Add a note`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`leads.capture`})}),_jsx(_components.td,{}),_jsxs(_components.td,{children:[_jsx(_components.a,{href:`/api-reference/leads/capture-lead`,children:`Capture a lead`}),`, `,_jsx(_components.a,{href:`/api-reference/reference/list-fields`,children:`List lead fields`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`crm.records.read`})}),_jsx(_components.td,{}),_jsxs(_components.td,{children:[_jsx(_components.a,{href:`/api-reference/customers/list-records`,children:`List customer or opportunity records`}),`, `,_jsx(_components.a,{href:`/api-reference/customers/read-record`,children:`Read a customer or opportunity`}),`, `,_jsx(_components.a,{href:`/api-reference/customers/list-record-fields`,children:`List custom record fields`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`crm.records.write`})}),_jsx(_components.td,{}),_jsxs(_components.td,{children:[_jsx(_components.a,{href:`/api-reference/customers/create-record`,children:`Create a customer or opportunity`}),`, `,_jsx(_components.a,{href:`/api-reference/customers/update-record`,children:`Update a customer or opportunity`})]})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`rotate-a-key-without-downtime`,children:`Rotate a key without downtime`}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsx(_components.li,{children:`Create a new key with the same scopes.`}),`\n`,_jsx(_components.li,{children:`Switch your server to the new key and deploy.`}),`\n`,_jsxs(_components.li,{children:[`Revoke the old key in `,_jsx(_components.strong,{children:`Settings → Integrations → API keys`}),`.`]}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`revoke-a-key`,children:`Revoke a key`}),`\n`,_jsxs(_components.p,{children:[`Revoke a key in `,_jsx(_components.strong,{children:`Settings → Integrations → API keys`}),`. It stops working on the next request.`]})]})}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":"Keys and scopes","description":"What each scope allows, and how to rotate and revoke keys.","href":"/keys-and-scopes"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Scopes","slug":"scopes","depth":2,"children":[]},{"title":"Rotate a key without downtime","slug":"rotate-a-key-without-downtime","depth":2,"children":[]},{"title":"Revoke a key","slug":"revoke-a-key","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"marro","siteName":"Marro","title":"Keys and scopes - Marro","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-13T09:42:52.708Z","originalFileLocation":"keys-and-scopes.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=\"What each scope allows, and how to rotate and revoke keys.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Marro\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/marro/I-0IyWvl5z8txpHY/_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/marro/I-0IyWvl5z8txpHY/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/marro/I-0IyWvl5z8txpHY/_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/marro/I-0IyWvl5z8txpHY/_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/marro/I-0IyWvl5z8txpHY/_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/marro/I-0IyWvl5z8txpHY/_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/marro/I-0IyWvl5z8txpHY/_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/marro/I-0IyWvl5z8txpHY/_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/marro/I-0IyWvl5z8txpHY/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Keys and scopes - Marro\">\u003cmeta data-mint-head property=\"og:description\" content=\"What each scope allows, and how to rotate and revoke keys.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Marro\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.marro.si/keys-and-scopes\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://marro.mintlify.site/_mintlify/api/og/v2?division=API\u0026amp;title=Keys+and+scopes\u0026amp;description=What+each+scope+allows%2C+and+how+to+rotate+and+revoke+keys.\u0026amp;theme=d7249f23099e2c2edb8e8ddc\u0026amp;signature=9aad85b3f35cc5395433bb948056bff97a9d6b8651fbf5cf16f1df1da61451c0\">\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=\"Keys and scopes - Marro\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"What each scope allows, and how to rotate and revoke keys.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://marro.mintlify.site/_mintlify/api/og/v2?division=API\u0026amp;title=Keys+and+scopes\u0026amp;description=What+each+scope+allows%2C+and+how+to+rotate+and+revoke+keys.\u0026amp;theme=d7249f23099e2c2edb8e8ddc\u0026amp;signature=9aad85b3f35cc5395433bb948056bff97a9d6b8651fbf5cf16f1df1da61451c0\">\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/marro/I-0IyWvl5z8txpHY/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Marro\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#047857\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.marro.si/keys-and-scopes\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/keys-and-scopes.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.marro.si/#organization\",\"name\":\"Marro\",\"url\":\"https://docs.marro.si\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/marro/L_ff4QIYNuKFkgUx/logo/light.svg?fit=max\u0026auto=format\u0026n=L_ff4QIYNuKFkgUx\u0026q=85\u0026s=3b6108c447441cf9e27b14912873f0ac\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.marro.si#website\",\"name\":\"Marro\",\"url\":\"https://docs.marro.si\",\"publisher\":{\"@id\":\"https://docs.marro.si/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.marro.si/keys-and-scopes#webpage\",\"url\":\"https://docs.marro.si/keys-and-scopes\",\"name\":\"Keys and scopes\",\"description\":\"What each scope allows, and how to rotate and revoke keys.\",\"dateModified\":\"2026-11-13T09:42:52.708Z\",\"isPartOf\":{\"@id\":\"https://docs.marro.si#website\"},\"breadcrumb\":{\"@id\":\"https://docs.marro.si/keys-and-scopes#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.marro.si/keys-and-scopes#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"API\",\"item\":\"https://docs.marro.si/getting-started\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Keys and scopes\",\"item\":\"https://docs.marro.si/keys-and-scopes\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.marro.si/keys-and-scopes#article\",\"headline\":\"Keys and scopes\",\"name\":\"Keys and scopes\",\"description\":\"What each scope allows, and how to rotate and revoke keys.\",\"url\":\"https://docs.marro.si/keys-and-scopes\",\"mainEntityOfPage\":{\"@id\":\"https://docs.marro.si/keys-and-scopes#webpage\"},\"dateModified\":\"2026-11-13T09:42:52.708Z\",\"publisher\":{\"@id\":\"https://docs.marro.si/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.marro.si#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Marro\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Marro\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/keys-and-scopes.md","siteName":"Marro","nav":{"global":null,"tabs":[{"tab":"Guides","groups":[{"group":"Get started","pages":[{"title":"Introduction","href":""},{"title":"Create your workspace","href":"/guides/sign-up"},{"title":"Marro website advertising measurement","href":"/guides/marro-advertising-measurement"},{"title":"Set up your organization","href":"/guides/organization-onboarding"},{"title":"Settings","href":"/guides/settings"},{"title":"Two-step sign-in","href":"/guides/two-step-sign-in"}]},{"group":"Use Marro","pages":[{"title":"Inbox","href":"/guides/inbox"},{"title":"Blocked numbers","href":"/guides/blocked-numbers"},{"title":"WhatsApp contacts, tags and attributes","href":"/guides/whatsapp-contacts"},{"title":"Click-to-WhatsApp ads","href":"/guides/click-to-whatsapp-ads"},{"title":"WhatsApp chatbots","href":"/guides/whatsapp-chatbots"},{"title":"WhatsApp forms (Flows)","href":"/guides/whatsapp-flows"},{"title":"WhatsApp groups","href":"/guides/whatsapp-groups"},{"title":"Email with leads","href":"/guides/email"},{"title":"Email campaigns","href":"/guides/email-campaigns"},{"title":"Contact preferences","href":"/guides/contact-preferences"},{"title":"Website chat","href":"/guides/website-chat"},{"title":"Website tracking","href":"/guides/website-tracking"},{"title":"Business knowledge","href":"/guides/business-knowledge"},{"title":"Assistant","href":"/guides/assistant"},{"title":"Help and support","href":"/guides/support"},{"title":"Notifications","href":"/guides/notifications"},{"title":"Branches","href":"/guides/branches"},{"title":"Custom reports and dashboards","href":"/guides/custom-reports"},{"title":"Chat reports","href":"/guides/chat-reports"},{"title":"Campaigns and return on spend","href":"/guides/campaigns"},{"title":"Quotes and invoices","href":"/guides/quotes-and-invoices"},{"title":"Region: currency, formats and tax","href":"/guides/regional-settings"},{"title":"Company sign-in","href":"/guides/company-sign-in"},{"title":"Personal check-ins in Ask Marro","href":"/guides/personal-agent"},{"title":"Pipelines for leads and opportunities","href":"/guides/pipelines"},{"title":"Configure Log update","href":"/guides/log-update"},{"title":"Case workflows","href":"/guides/case-workflows"},{"title":"Filters","href":"/guides/advanced-filters"},{"title":"Favourites","href":"/guides/favourites"},{"title":"Agents","href":"/guides/agents"},{"title":"Automations","href":"/guides/automations"},{"title":"Sequences","href":"/guides/sequences"},{"title":"Appointments and booking","href":"/guides/appointments"},{"title":"Payments","href":"/guides/payments"},{"title":"Store orders","href":"/guides/store-orders"},{"title":"WhatsApp catalog","href":"/guides/whatsapp-catalog"},{"title":"Plans and billing","href":"/guides/billing"},{"title":"Price list and versions","href":"/guides/price-list"},{"title":"Modules","href":"/guides/modules"},{"title":"AI calling","href":"/guides/ai-calling"},{"title":"Cloud calls","href":"/guides/cloud-calls"},{"title":"AI usage and credits","href":"/guides/ai-usage"},{"title":"Connect an AI agent (MCP)","href":"/guides/mcp"},{"title":"Integrations","href":"/guides/integrations"},{"title":"Mobile app","href":"/guides/mobile-app"},{"title":"Access and data","href":"/guides/access-and-data"},{"title":"Organisation closure","href":"/guides/organisation-closure"},{"title":"Delete your account","href":"/guides/delete-your-account"},{"title":"Custom fields","href":"/guides/custom-fields"},{"title":"Custom objects","href":"/guides/custom-objects"}]},{"group":"API","pages":[{"title":"Getting started","href":"/getting-started"},{"title":"Authentication","description":"Send your key as a bearer token, over HTTPS, from your server.","href":"/authentication"},{"title":"Keys and scopes","href":"/keys-and-scopes"},{"title":"Forms","description":"Build a lead form, choose how it looks, publish it and share it.","href":"/guides/forms"},{"title":"Connect a website","href":"/guides/connect-a-website"},{"title":"Webhooks","href":"/guides/webhooks"},{"title":"Filtering leads","href":"/guides/filtering"}]},{"group":"Reference","pages":[{"title":"Errors","href":"/errors"},{"title":"Rate limits","href":"/rate-limits"}]}]},{"tab":"API reference","pages":[{"title":"API reference","href":"/api-reference/custom-objects/list-custom-objects"}]}]},"basePath":"","title":"Keys and scopes - Marro","deploymentId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","buildId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","dynamics":[],"chunks":[]}