Integration Credential Scopes: Organization, Project, and User
What Organization, Project, and User scope mean for an integration credential — who authenticates, whose access the agent uses, and who ends up able to read the results.
Every integration credential Parlé stores belongs to exactly one of three scopes. The scope you pick when you connect an integration decides three things: who authenticates, whose access the agent uses for a given call, and who can end up reading the result. It’s the most consequential choice in setting an integration up, so read this before connecting anything that reaches content not everyone in your organization should see.
A catalogue entry decides which scopes it even offers — you’re never
choosing from all three. The right scope is a property of the system being
connected, not of the admin’s mood. Confluence,
Linear, Miro, Notion and
Productive can sensibly be any of the three, because a
documentation space, issue tracker, board or project workspace can reasonably
be org-shared, project-owned, or personal. The meeting recorders,
Fathom, Fireflies and
Otter, only ever offer User scope: a recording belongs to
the person who made it and to the people in the meeting, so each member
connects their own account and the integration can’t be shared
organization-wide or project-wide. Parlé refuses Organization or Project scope
for them rather than just hiding it.
One connection, shared by every project the integration is enabled on. An Org Admin authenticates once — approving OAuth access, or entering an API key — and from then on every project that switches the integration on uses that same connection.
Who authenticates: the Org Admin who connects it.
Whose access the agent uses: the connected account’s, for every call from every project.
Who can see the results: anyone in any project the integration is enabled on.
Organization scope is the only one that survives unattended agent work. Nothing else about Parlé requires a person to be online for the agent to act, and Organization scope is what keeps that true for integrations too — there’s always a credential available, because it doesn’t belong to whoever happens to be in the conversation. Pick this for a service account, or a space every project may legitimately search.
Each project that enables the integration connects its own account, separately from every other project. A Project Admin runs the connect flow from that project’s Tools tab; a Project Admin never supplies a server address or any other outbound destination — that stays decided by the Org Admin who registered the integration in the first place. A project that hasn’t connected shows the integration as switched on but not connected, and the agent can neither see nor call it there until someone does.
Who authenticates: a Project Admin, on behalf of that project.
Whose access the agent uses: that project’s own connected account — never another project’s, even for the same integration.
Who can see the results: anyone in that project’s conversations. Nobody in a different project, even one enabled for the same integration, can reach this project’s connection or its results.
Pick this when different projects should each see only their own space in the connected system — a firm running Confluence for two separate client engagements, for instance, where one client’s documentation should never surface in the other’s project.
Each member connects their own account from My Integrations in their personal settings — see My Integrations. The agent then acts with the asking member’s own access: it can reach whatever that member’s account could reach at the provider, and nothing more.
Who authenticates: each member, individually, for their own connection only.
Whose access the agent uses: the credential of the member whose turn triggered the call.
Who can see the results: everyone who can see the message the results landed in — which in a shared project conversation is every member of that project, not just the one who connected.
User-scoped integrations are allowed in shared project conversations, and that has a real consequence worth stating plainly: if Alice asks a question that triggers a Confluence call, the agent fetches with Alice’s credential, and the answer goes to everyone in that conversation — so a colleague may end up reading content their own account couldn’t have retrieved themselves. Nothing about a shared conversation stops working because one member’s connection reached further than another’s would have.The alternative — restricting User-scoped integrations to personal, one-person conversations — was considered and rejected: project conversations are where Parlé’s collaboration happens, and walling User scope off from them would gut the feature for exactly the teams it’s meant to help.What Parlé does instead is disclose it, every time. Whenever a reply used a member’s own credential, the message says so — for example, “Retrieved using Alice’s Confluence account” — visible to everyone who can see that message, in shared conversations and personal ones alike. It’s a permanent part of the message: reopening the thread tomorrow still shows whose access produced the answer, not just at the moment it happened. This is also recorded in your organization’s audit log, but the label on the message is the control that matters here — there is no customer-facing audit screen or export today, so audit alone would make the disclosure invisible to the people it actually affects.
There’s no setting to turn the disclosure label off, and there won’t be one. A
label whose “off” position hides exactly the thing it exists to reveal isn’t a
control worth offering.
If a member hasn’t connected their own account yet, the integration still appears in the conversation — the agent tells them it needs a connection and links to My Integrations — rather than silently disappearing from the tool list, so the absence never looks like “this integration doesn’t exist here.”
Changing an integration’s scope is a disconnect and reconnect, not a migration — there’s no path that carries a credential from one scope to another, because a Project or User connection is a genuinely different account authenticating, not the same one relabelled. Parlé tells you this before you confirm a scope change.
Losing the Integrations entitlement never touches a credential you’ve already connected, at any scope — see Plans & Billing. It only stops new connections and new tool calls; every member who already connected their own account can still see it and disconnect it themselves.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Parlé","description":"Learn what Parlé is, why it was built for professional services firms, and how it solves AI cost allocation, collaboration, and governance.","colors":{"primary":"#4d8eff","light":"#87b0fb"},"logo":{"light":"https://mintcdn.com/parle-hub/uMgtWYiEd2Y8w4qH/images/pwa-215x215.png?fit=max\u0026auto=format\u0026n=uMgtWYiEd2Y8w4qH\u0026q=85\u0026s=290f7be415b686266afc7bda58f66c6d","dark":"https://mintcdn.com/parle-hub/uMgtWYiEd2Y8w4qH/images/pwa-215x215.png?fit=max\u0026auto=format\u0026n=uMgtWYiEd2Y8w4qH\u0026q=85\u0026s=290f7be415b686266afc7bda58f66c6d"},"favicon":{"light":"https://mintcdn.com/parle-hub/uMgtWYiEd2Y8w4qH/images/apple-touch-icon.png?fit=max\u0026auto=format\u0026n=uMgtWYiEd2Y8w4qH\u0026q=85\u0026s=1aef3d4694a0ac53fb2780d44f099816","dark":"https://mintcdn.com/parle-hub/uMgtWYiEd2Y8w4qH/images/apple-touch-icon.png?fit=max\u0026auto=format\u0026n=uMgtWYiEd2Y8w4qH\u0026q=85\u0026s=1aef3d4694a0ac53fb2780d44f099816"},"appearance":{"default":"system"},"navbar":{"primary":{"type":"button","label":"Start Free Trial","href":"https://app.parlehub.com"}},"footer":{"socials":{"website":"https://www.parlehub.com"}},"fonts":{"heading":{"family":"Fraunces"},"body":{"family":"Inter"}},"styling":{"latex":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"parle-hub","hasAudioNarration":false,"actualSubdomain":"parle-hub","customDomains":["docs.parlehub.com"],"gitSource":{"type":"github","owner":"parlehub","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"DISABLED"},"WEB_MCP":{"status":"DISABLED"}},"buildId":"6aebdba23df5e5c5ae952888","clientVersion":"0.0.4088","searchFilterCounts":[{"language":"default","tag":"Documentation","count":47},{"language":"default","tag":"Tools \u0026 Knowledge","count":15},{"language":"default","tag":"AI Models","count":7},{"language":"default","tag":"Administration","count":6},{"language":"default","tag":"Projects \u0026 Collaboration","count":5},{"language":"default","tag":"Security \u0026 Governance","count":5},{"language":"default","tag":"Cost Management","count":4},{"language":"default","tag":"Get Started","count":3},{"language":"default","tag":"Architecture","count":2}]},"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":"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":"llms-txt-v2","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":"comment-mode","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"tools/integration-scopes","slug":"/tools/integration-scopes","pageMetadata":{"title":"Integration Credential Scopes: Organization, Project, and User","sidebarTitle":"Credential Scopes","description":"What Organization, Project, and User scope mean for an integration credential — who authenticates, whose access the agent uses, and who ends up able to read the results.","icon":"shield-halved","href":"/tools/integration-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 Organization, Project, and User scope mean for an integration credential — who authenticates, whose access the agent uses, and who ends up able to read the results.\"\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`,em:`em`,li:`li`,p:`p`,strong:`strong`,ul:`ul`,..._provideComponents(),...props.components},{Heading,Info,Warning}=_components;if(!Heading)_missingMdxReference(`Heading`,true);if(!Info)_missingMdxReference(`Info`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`Every integration credential Parlé stores belongs to exactly one of three scopes. The scope you pick when you connect an integration decides three things: `,_jsx(_components.strong,{children:`who authenticates`}),`, `,_jsx(_components.strong,{children:`whose access the agent uses`}),` for a given call, and `,_jsx(_components.strong,{children:`who can end up reading the result`}),`. It’s the most consequential choice in setting an integration up, so read this before connecting anything that reaches content not everyone in your organization should see.`]}),`\n`,_jsx(Info,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`A catalogue entry decides which scopes it even offers — you’re never\nchoosing from all three.`}),` The right scope is a property of the system being\nconnected, not of the admin’s mood. `,_jsx(_components.a,{href:`/tools/confluence`,children:`Confluence`}),`,\n`,_jsx(_components.a,{href:`/tools/linear`,children:`Linear`}),`, `,_jsx(_components.a,{href:`/tools/miro`,children:`Miro`}),`, `,_jsx(_components.a,{href:`/tools/notion`,children:`Notion`}),` and\n`,_jsx(_components.a,{href:`/tools/productive`,children:`Productive`}),` can sensibly be any of the three, because a\ndocumentation space, issue tracker, board or project workspace can reasonably\nbe org-shared, project-owned, or personal. The meeting recorders,\n`,_jsx(_components.a,{href:`/tools/fathom`,children:`Fathom`}),`, `,_jsx(_components.a,{href:`/tools/fireflies`,children:`Fireflies`}),` and\n`,_jsx(_components.a,{href:`/tools/otter`,children:`Otter`}),`, only ever offer `,_jsx(_components.strong,{children:`User`}),` scope: a recording belongs to\nthe person who made it and to the people in the meeting, so each member\nconnects their own account and the integration can’t be shared\norganization-wide or project-wide. Parlé refuses Organization or Project scope\nfor them rather than just hiding it.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`organization-scope`,children:`Organization scope`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`One connection, shared by every project the integration is enabled on.`}),` An Org Admin authenticates once — approving OAuth access, or entering an API key — and from then on every project that switches the integration on uses that same connection.`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Who authenticates:`}),` the Org Admin who connects it.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Whose access the agent uses:`}),` the connected account’s, for every call from every project.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Who can see the results:`}),` anyone in any project the integration is enabled on.`]}),`\n`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Organization scope is the only one that survives unattended agent work.`}),` Nothing else about Parlé requires a person to be online for the agent to act, and Organization scope is what keeps that true for integrations too — there’s always a credential available, because it doesn’t belong to whoever happens to be in the conversation. Pick this for a service account, or a space every project may legitimately search.`]}),`\n`,_jsx(Heading,{level:`2`,id:`project-scope`,children:`Project scope`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Each project that enables the integration connects its own account`}),`, separately from every other project. A Project Admin runs the connect flow from that project’s Tools tab; a Project Admin never supplies a server address or any other outbound destination — that stays decided by the Org Admin who registered the integration in the first place. A project that hasn’t connected shows the integration as switched on but `,_jsx(_components.strong,{children:`not connected`}),`, and the agent can neither see nor call it there until someone does.`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Who authenticates:`}),` a Project Admin, on behalf of that project.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Whose access the agent uses:`}),` that project’s own connected account — never another project’s, even for the same integration.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Who can see the results:`}),` anyone in that project’s conversations. Nobody in a different project, even one enabled for the same integration, can reach this project’s connection or its results.`]}),`\n`]}),`\n`,_jsx(_components.p,{children:`Pick this when different projects should each see only their own space in the connected system — a firm running Confluence for two separate client engagements, for instance, where one client’s documentation should never surface in the other’s project.`}),`\n`,_jsx(Heading,{level:`2`,id:`user-scope`,children:`User scope`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Each member connects their own account`}),` from `,_jsx(_components.strong,{children:`My Integrations`}),` in their personal settings — see `,_jsx(_components.a,{href:`/tools/my-integrations`,children:`My Integrations`}),`. The agent then acts with the asking member’s own access: it can reach whatever that member’s account could reach at the provider, and nothing more.`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Who authenticates:`}),` each member, individually, for their own connection only.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Whose access the agent uses:`}),` the credential of the member whose turn triggered the call.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Who can see the results:`}),` everyone who can see the message the results landed in — which in a shared project conversation is every member of that project, not just the one who connected.`]}),`\n`]}),`\n`,_jsx(Heading,{level:`3`,id:`the-fan-out-consequence-and-why-it’s-accepted`,children:`The fan-out consequence, and why it’s accepted`}),`\n`,_jsxs(_components.p,{children:[`User-scoped integrations are allowed in shared project conversations, and that has a real consequence worth stating plainly: if Alice asks a question that triggers a Confluence call, the agent fetches with `,_jsx(_components.strong,{children:`Alice’s`}),` credential, and the answer goes to `,_jsx(_components.strong,{children:`everyone in that conversation`}),` — so a colleague may end up reading content their own account couldn’t have retrieved themselves. Nothing about a shared conversation stops working because one member’s connection reached further than another’s would have.`]}),`\n`,_jsx(_components.p,{children:`The alternative — restricting User-scoped integrations to personal, one-person conversations — was considered and rejected: project conversations are where Parlé’s collaboration happens, and walling User scope off from them would gut the feature for exactly the teams it’s meant to help.`}),`\n`,_jsxs(_components.p,{children:[`What Parlé does instead is disclose it, every time. `,_jsx(_components.strong,{children:`Whenever a reply used a member’s own credential, the message says so`}),` — for example, `,_jsx(_components.em,{children:`“Retrieved using Alice’s Confluence account”`}),` — visible to everyone who can see that message, in shared conversations and personal ones alike. It’s a permanent part of the message: reopening the thread tomorrow still shows whose access produced the answer, not just at the moment it happened. This is also recorded in your organization’s audit log, but the label on the message is the control that matters here — there is no customer-facing audit screen or export today, so audit alone would make the disclosure invisible to the people it actually affects.`]}),`\n`,_jsx(Warning,{children:_jsx(_components.p,{children:`There’s no setting to turn the disclosure label off, and there won’t be one. A\nlabel whose “off” position hides exactly the thing it exists to reveal isn’t a\ncontrol worth offering.`})}),`\n`,_jsx(_components.p,{children:`If a member hasn’t connected their own account yet, the integration still appears in the conversation — the agent tells them it needs a connection and links to My Integrations — rather than silently disappearing from the tool list, so the absence never looks like “this integration doesn’t exist here.”`}),`\n`,_jsx(Heading,{level:`2`,id:`changing-scope`,children:`Changing scope`}),`\n`,_jsxs(_components.p,{children:[`Changing an integration’s scope is a `,_jsx(_components.strong,{children:`disconnect and reconnect`}),`, not a migration — there’s no path that carries a credential from one scope to another, because a Project or User connection is a genuinely different account authenticating, not the same one relabelled. Parlé tells you this before you confirm a scope change.`]}),`\n`,_jsx(Heading,{level:`2`,id:`if-your-plan-changes`,children:`If your plan changes`}),`\n`,_jsxs(_components.p,{children:[`Losing the Integrations entitlement never touches a credential you’ve already connected, at any scope — see `,_jsx(_components.a,{href:`/plans-and-billing#what-happens-if-your-plan-changes`,children:`Plans \u0026 Billing`}),`. It only stops `,_jsx(_components.strong,{children:`new`}),` connections and new tool calls; every member who already connected their own account can still see it and disconnect it themselves.`]})]})}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":"Integration Credential Scopes: Organization, Project, and User","sidebarTitle":"Credential Scopes","description":"What Organization, Project, and User scope mean for an integration credential — who authenticates, whose access the agent uses, and who ends up able to read the results.","icon":"shield-halved","href":"/tools/integration-scopes"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Organization scope","slug":"organization-scope","depth":2,"children":[]},{"title":"Project scope","slug":"project-scope","depth":2,"children":[]},{"title":"User scope","slug":"user-scope","depth":2,"children":[{"title":"The fan-out consequence, and why it’s accepted","slug":"the-fan-out-consequence-and-why-it’s-accepted","depth":3,"children":[]}]},{"title":"Changing scope","slug":"changing-scope","depth":2,"children":[]},{"title":"If your plan changes","slug":"if-your-plan-changes","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"parle-hub","siteName":"Parlé","title":"Integration Credential Scopes: Organization, Project, and User - Parlé","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-17T14:22:02.000Z","originalFileLocation":"tools/integration-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 Organization, Project, and User scope mean for an integration credential — who authenticates, whose access the agent uses, and who ends up able to read the results.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Parlé\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/parle-hub/c49aGkjhS9xXtbTR/_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/parle-hub/c49aGkjhS9xXtbTR/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/parle-hub/c49aGkjhS9xXtbTR/_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/parle-hub/c49aGkjhS9xXtbTR/_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/parle-hub/c49aGkjhS9xXtbTR/_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/parle-hub/c49aGkjhS9xXtbTR/_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/parle-hub/c49aGkjhS9xXtbTR/_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/parle-hub/c49aGkjhS9xXtbTR/_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/parle-hub/c49aGkjhS9xXtbTR/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Integration Credential Scopes: Organization, Project, and User - Parlé\">\u003cmeta data-mint-head property=\"og:description\" content=\"What Organization, Project, and User scope mean for an integration credential — who authenticates, whose access the agent uses, and who ends up able to read the results.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Parlé\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.parlehub.com/tools/integration-scopes\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://parle-hub.mintlify.site/_mintlify/api/og/v2?division=Tools+%26+Knowledge\u0026amp;title=Integration+Credential+Scopes%3A+Organization%2C+Project%2C+and+User\u0026amp;description=What+Organization%2C+Project%2C+and+User+scope+mean+for+an+integration+credential+%E2%80%94+who+authenticates%2C+whose+access+the+agent+uses%2C+and+who+ends+up+able+to+read+the\u0026amp;theme=708a6a442977800d90624975\u0026amp;signature=db09d06835aac109c9685c560702f68ffa333a1123f70961c0a1458f624661e9\">\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=\"Integration Credential Scopes: Organization, Project, and User - Parlé\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"What Organization, Project, and User scope mean for an integration credential — who authenticates, whose access the agent uses, and who ends up able to read the results.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://parle-hub.mintlify.site/_mintlify/api/og/v2?division=Tools+%26+Knowledge\u0026amp;title=Integration+Credential+Scopes%3A+Organization%2C+Project%2C+and+User\u0026amp;description=What+Organization%2C+Project%2C+and+User+scope+mean+for+an+integration+credential+%E2%80%94+who+authenticates%2C+whose+access+the+agent+uses%2C+and+who+ends+up+able+to+read+the\u0026amp;theme=708a6a442977800d90624975\u0026amp;signature=db09d06835aac109c9685c560702f68ffa333a1123f70961c0a1458f624661e9\">\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/parle-hub/c49aGkjhS9xXtbTR/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Parlé\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#4d8eff\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.parlehub.com/tools/integration-scopes\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/tools/integration-scopes.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.parlehub.com/#organization\",\"name\":\"Parlé\",\"url\":\"https://docs.parlehub.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/parle-hub/uMgtWYiEd2Y8w4qH/images/pwa-215x215.png?fit=max\u0026auto=format\u0026n=uMgtWYiEd2Y8w4qH\u0026q=85\u0026s=290f7be415b686266afc7bda58f66c6d\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.parlehub.com#website\",\"name\":\"Parlé\",\"url\":\"https://docs.parlehub.com\",\"publisher\":{\"@id\":\"https://docs.parlehub.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.parlehub.com/tools/integration-scopes#webpage\",\"url\":\"https://docs.parlehub.com/tools/integration-scopes\",\"name\":\"Integration Credential Scopes: Organization, Project, and User\",\"description\":\"What Organization, Project, and User scope mean for an integration credential — who authenticates, whose access the agent uses, and who ends up able to read the results.\",\"dateModified\":\"2026-10-17T14:22:02.000Z\",\"isPartOf\":{\"@id\":\"https://docs.parlehub.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.parlehub.com/tools/integration-scopes#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.parlehub.com/tools/integration-scopes#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Tools \u0026 Knowledge\",\"item\":\"https://docs.parlehub.com/tools/integrations\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Integration Credential Scopes: Organization, Project, and User\",\"item\":\"https://docs.parlehub.com/tools/integration-scopes\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.parlehub.com/tools/integration-scopes#article\",\"headline\":\"Integration Credential Scopes: Organization, Project, and User\",\"name\":\"Integration Credential Scopes: Organization, Project, and User\",\"description\":\"What Organization, Project, and User scope mean for an integration credential — who authenticates, whose access the agent uses, and who ends up able to read the results.\",\"url\":\"https://docs.parlehub.com/tools/integration-scopes\",\"mainEntityOfPage\":{\"@id\":\"https://docs.parlehub.com/tools/integration-scopes#webpage\"},\"dateModified\":\"2026-10-17T14:22:02.000Z\",\"publisher\":{\"@id\":\"https://docs.parlehub.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.parlehub.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Parlé\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Parlé","nav":{"global":null,"tabs":[{"tab":"Documentation","groups":[{"group":"Get Started","pages":[{"title":"Parlé: Shared AI Workspace for Client-Billing Firms","sidebarTitle":"Introduction","href":"/introduction"},{"title":"Quick start: Set Up Parlé for Your Firm in Minutes","sidebarTitle":"Quick start","href":"/quickstart"},{"title":"Parlé Plans: Team, Business, Business Elite, and Enterprise Compared","sidebarTitle":"Plans \u0026 Billing","href":"/plans-and-billing"}]},{"group":"Projects \u0026 Collaboration","pages":[{"title":"Projects: Organize AI Work by Client Engagement","sidebarTitle":"Overview","href":"/projects/overview"},{"title":"Conversations: Real-Time AI Threads Your Team Shares","sidebarTitle":"Conversations","href":"/projects/conversations"},{"title":"Shared Context: Keep Knowledge in the Project, Not a Tab","sidebarTitle":"Shared Context","href":"/projects/shared-context"},{"title":"File Tools: Work Directly with Your Project Documents","sidebarTitle":"File Tools","href":"/projects/file-tools"},{"title":"Semantic File Search: Find Passages by Meaning, Not Exact Words","sidebarTitle":"Semantic File Search","href":"/projects/file-search"}]},{"group":"Cost Management","pages":[{"title":"Project Budgets: Set Ceilings Before You Hit Them","sidebarTitle":"Budgets","href":"/cost/budgets"},{"title":"Currencies and Exchange Rates: Spend in USD, GBP, EUR or CAD","sidebarTitle":"Currencies","href":"/cost/currencies"},{"title":"Expense Codes: Tag Every AI Dollar to a Client Matter","sidebarTitle":"Expense Codes","href":"/cost/expense-codes"},{"title":"Usage Analytics: Token Spend Across Projects and People","sidebarTitle":"Usage Analytics","href":"/cost/usage-analytics"}]},{"group":"AI Models","pages":[{"title":"Connect AI Model Providers to Parlé (BYOK)","sidebarTitle":"Connecting Providers","href":"/models/connecting-providers"},{"title":"AI Models Supported by Parlé — All Providers","sidebarTitle":"Supported Models","href":"/models/supported-models"},{"title":"Choose Which AI Models a Project Can Use","sidebarTitle":"Model Selection","href":"/models/model-selection"},{"title":"Choose How Hard the Model Thinks","sidebarTitle":"Thinking Level","href":"/models/thinking-level"},{"title":"Auto: Let Parlé Pick the Right Model for Each Conversation","sidebarTitle":"Auto","icon":"wand-magic-sparkles","href":"/models/auto"},{"title":"Set Up Auto for Your Organization","sidebarTitle":"Set Up Auto","icon":"sliders","href":"/models/auto-setup"},{"title":"Model Policy: Decide Which Models Your Firm Can Use","sidebarTitle":"Model Policy","icon":"shield-halved","href":"/models/model-policy"}]},{"group":"Tools \u0026 Knowledge","icon":"toolbox","pages":[{"title":"Connect Integrations to Parlé: Branded Cards and Custom MCP Tools","sidebarTitle":"Integrations","icon":"plug","href":"/tools/integrations"},{"title":"Connect Confluence to Parlé","sidebarTitle":"Confluence","icon":"confluence","href":"/tools/confluence"},{"title":"Connect Fathom to Parlé","sidebarTitle":"Fathom","icon":"video","href":"/tools/fathom"},{"title":"Connect Fireflies to Parlé","sidebarTitle":"Fireflies","icon":"microphone-lines","href":"/tools/fireflies"},{"title":"Connect Linear to Parlé","sidebarTitle":"Linear","icon":"list-check","href":"/tools/linear"},{"title":"Connect Miro to Parlé","sidebarTitle":"Miro","icon":"object-group","href":"/tools/miro"},{"title":"Connect Notion to Parlé","sidebarTitle":"Notion","icon":"notion","href":"/tools/notion"},{"title":"Connect Otter to Parlé","sidebarTitle":"Otter","icon":"microphone","href":"/tools/otter"},{"title":"Connect Productive to Parlé","sidebarTitle":"Productive","description":"Connect Productive from the Integrations gallery — pick a scope, approve access, and let the agent work with your projects, time, budgets and invoices.","icon":"chart-gantt","href":"/tools/productive"},{"title":"Integration Credential Scopes: Organization, Project, and User","sidebarTitle":"Credential Scopes","icon":"shield-halved","href":"/tools/integration-scopes"},{"title":"Set Up Organization Knowledge in Parlé","sidebarTitle":"Organization Knowledge","description":"Connect a SharePoint or Drive library, or publish policies by hand, so the assistant can quote your firm's documents with a citation in any conversation.","icon":"books","href":"/knowledge/organization-knowledge"},{"title":"Ask the Assistant About Your Own Parlé Setup","sidebarTitle":"Asking About Your Org","icon":"circle-question","href":"/knowledge/asking-about-your-org"},{"title":"My Integrations: Connect Your Own Account to a Parlé Integration","sidebarTitle":"My Integrations","icon":"user-gear","href":"/tools/my-integrations"},{"title":"Web Search: Let Parlé Agents Search the Web with Cited Sources","sidebarTitle":"Web Search","icon":"magnifying-glass","href":"/tools/web-search"},{"title":"How Parlé Keeps Web Research Safe","sidebarTitle":"Web Search Safety","icon":"shield-halved","href":"/tools/web-search-safety"}]},{"group":"Architecture","icon":"sitemap","pages":[{"title":"How Parle Fits Together: Architecture Overview","sidebarTitle":"Overview","icon":"sitemap","href":"/architecture/overview"},{"title":"Connected Services: What Parlé Talks To and What It Sends","sidebarTitle":"Connected Services","icon":"plug","href":"/architecture/connected-services"}]},{"group":"Security \u0026 Governance","pages":[{"title":"Parlé Security and Compliance Overview","sidebarTitle":"Overview","href":"/security/overview"},{"title":"Single Sign-On with Entra ID and Google Workspace","sidebarTitle":"SSO","href":"/security/sso"},{"title":"Native Storage: Files Stay in Your SharePoint or Drive","sidebarTitle":"Storage","href":"/security/storage"},{"title":"Audit Log: Append-Only Record of Sensitive Actions","sidebarTitle":"Audit Log","href":"/security/audit-log"},{"title":"Roles and Permissions in Parlé","sidebarTitle":"Roles \u0026 Permissions","href":"/security/roles-and-permissions"}]},{"group":"Administration","pages":[{"title":"Set Up Your Parlé Organization","sidebarTitle":"Organization Setup","href":"/admin/organization-setup"},{"title":"Invite and Manage Members in Your Organization","sidebarTitle":"Managing Members","href":"/admin/managing-members"},{"title":"Org-Wide and Per-User AI Spending Caps","sidebarTitle":"Spending Caps","href":"/admin/org-caps"},{"title":"Export Your Organization's Data","sidebarTitle":"Data Export","href":"/admin/data-export"},{"title":"Connect Parlé to Microsoft 365 (SSO and SharePoint)","sidebarTitle":"Connect Microsoft 365","icon":"microsoft","href":"/admin/microsoft-365"},{"title":"Connect Parlé to Google Workspace (SSO and Drive)","sidebarTitle":"Connect Google Workspace","icon":"google","href":"/admin/google-workspace"}]}]}]},"basePath":"","title":"Integration Credential Scopes: Organization, Project, and User - Parlé","buildId":"dpl_DTau1J5HqS9UTgVSDwGksstFWtPa","deploymentId":"dpl_DTau1J5HqS9UTgVSDwGksstFWtPa","dynamics":[],"chunks":[]}