Complete the sign-in flow, or enter the app’s bearer token in the secure Tools form when Aubrey asks for one.
Some providers, such as CAISbook when it is available for your workspace, use a bearer token instead of a sign-in window. Enter that token only in Tools, never in chat or a messaging channel.If a connected bearer-token app adds newly approved actions, choose Refresh. Aubrey tries the stored connection first. Enter the token again only if the refresh cannot finish and the secure form appears.If you see Upgrade, open Settings -> Billing and choose a plan that includes that app.If you see Admin setup needed, that app is not available for your workspace yet.
If Aubrey asks for an app connection during a request, use the connection card in chat. For a bearer-token app, the card opens Tools and focuses the secure token form.After you connect the app, return to the request and continue.If you send a different message instead of finishing the connection card, Aubrey stops waiting on that earlier app setup and treats the new message as a new request. Open the latest card when you are ready to continue.
For Telegram or WhatsApp groups, the owner must enable Connected app actions in Channels before group participants can use Airtable, Notion, or another approved app through Aubrey.If Aubrey shows Reconnect for a previously connected app, finish that reconnect step for the same app you asked to use. Aubrey should not switch you to a different app just because one needs attention.
{"docsConfig":{"theme":"sequoia","$schema":"https://mintlify.com/docs.json","name":"Aubrey Docs","description":"Setup guides, help articles, and product updates for Aubrey personal AI agents.","colors":{"primary":"#7C3AED","light":"#E9E0FF","dark":"#281950"},"logo":{"light":"https://mintcdn.com/aubrey-11/Z_rP_3cUHePvNAmJ/images/aubrey-logo.png?fit=max\u0026auto=format\u0026n=Z_rP_3cUHePvNAmJ\u0026q=85\u0026s=3bd48af7b20207a5445ed166110d8243","dark":"https://mintcdn.com/aubrey-11/Z_rP_3cUHePvNAmJ/images/aubrey-logo.png?fit=max\u0026auto=format\u0026n=Z_rP_3cUHePvNAmJ\u0026q=85\u0026s=3bd48af7b20207a5445ed166110d8243"},"favicon":{"light":"https://mintcdn.com/aubrey-11/Z_rP_3cUHePvNAmJ/images/favicon.ico?fit=max\u0026auto=format\u0026n=Z_rP_3cUHePvNAmJ\u0026q=85\u0026s=8fce2e4bd2415b1e92caabc08ff10015","dark":"https://mintcdn.com/aubrey-11/Z_rP_3cUHePvNAmJ/images/favicon.ico?fit=max\u0026auto=format\u0026n=Z_rP_3cUHePvNAmJ\u0026q=85\u0026s=8fce2e4bd2415b1e92caabc08ff10015"},"appearance":{"default":"light"},"background":{"decoration":"gradient","color":{"light":"#F3F0F7","dark":"#241548"}},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"aubrey-11","hasAudioNarration":false,"actualSubdomain":"aubrey-11","customDomains":["knowledge.helloaubrey.com"],"gitSource":{"type":"github","owner":"legendz3","repo":"saas-agent","deployBranch":"main","contentDirectory":"knowledge","isPrivate":true,"mountPath":"","label":""},"chroma":{"collectionId":"84d966dd-3806-402b-b292-c4731a3b87d9","liveDeploymentHistoryId":"6ac6b3f3a3f4a1aef220dc29","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ac6b3f3a3f4a1aef220dc29"},"entitlements":{"AI_CHAT":{"status":"ENABLED"}},"buildId":"6ac6b3f3a3f4a1aef220dc29","clientVersion":"0.0.4021","searchFilterCounts":[{"language":"default","tag":"Documentation","count":16},{"language":"default","tag":"Help Center","count":11},{"language":"default","tag":"Getting started","count":7},{"language":"default","tag":"Sample use cases","count":6},{"language":"default","tag":"Guides","count":4},{"language":"default","tag":"Overview","count":3},{"language":"default","tag":"Email and calendar","count":3},{"language":"default","tag":"Sharing","count":3},{"language":"default","tag":"Changelog","count":1},{"language":"default","tag":"Updates","count":1}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":false,"toggles":[],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"help-center/getting-started/connect-a-connected-app","slug":"/help-center/getting-started/connect-a-connected-app","pageMetadata":{"title":"Connect an approved app","description":null,"href":"/help-center/getting-started/connect-a-connected-app"},"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={li:`li`,ol:`ol`,p:`p`,strong:`strong`,..._provideComponents(),...props.components},{Heading}=_components;if(!Heading)_missingMdxReference(`Heading`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`Aubrey can use approved connected apps when they are available for your account.`}),`\n`,_jsx(Heading,{level:`2`,id:`connect-or-reconnect`,children:`Connect or reconnect`}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsx(_components.li,{children:`Open the agent workspace.`}),`\n`,_jsxs(_components.li,{children:[`Open `,_jsx(_components.strong,{children:`Tools`}),`.`]}),`\n`,_jsxs(_components.li,{children:[`In `,_jsx(_components.strong,{children:`Connections`}),`, find the app you want to use.`]}),`\n`,_jsxs(_components.li,{children:[`Choose `,_jsx(_components.strong,{children:`Connect`}),` or `,_jsx(_components.strong,{children:`Reconnect`}),`.`]}),`\n`,_jsxs(_components.li,{children:[`Complete the sign-in flow, or enter the app’s bearer token in the secure `,_jsx(_components.strong,{children:`Tools`}),` form when Aubrey asks for one.`]}),`\n`]}),`\n`,_jsxs(_components.p,{children:[`Some providers, such as CAISbook when it is available for your workspace, use a bearer token instead of a sign-in window. Enter that token only in `,_jsx(_components.strong,{children:`Tools`}),`, never in chat or a messaging channel.`]}),`\n`,_jsxs(_components.p,{children:[`If a connected bearer-token app adds newly approved actions, choose `,_jsx(_components.strong,{children:`Refresh`}),`. Aubrey tries the stored connection first. Enter the token again only if the refresh cannot finish and the secure form appears.`]}),`\n`,_jsxs(_components.p,{children:[`If you see `,_jsx(_components.strong,{children:`Upgrade`}),`, open `,_jsx(_components.strong,{children:`Settings`}),` -> `,_jsx(_components.strong,{children:`Billing`}),` and choose a plan that includes that app.`]}),`\n`,_jsxs(_components.p,{children:[`If you see `,_jsx(_components.strong,{children:`Admin setup needed`}),`, that app is not available for your workspace yet.`]}),`\n`,_jsx(Heading,{level:`2`,id:`continue-from-chat`,children:`Continue from chat`}),`\n`,_jsxs(_components.p,{children:[`If Aubrey asks for an app connection during a request, use the connection card in chat. For a bearer-token app, the card opens `,_jsx(_components.strong,{children:`Tools`}),` and focuses the secure token form.`]}),`\n`,_jsx(_components.p,{children:`After you connect the app, return to the request and continue.`}),`\n`,_jsx(_components.p,{children:`If you send a different message instead of finishing the connection card, Aubrey stops waiting on that earlier app setup and treats the new message as a new request. Open the latest card when you are ready to continue.`}),`\n`,_jsx(Heading,{level:`2`,id:`use-in-a-shared-group`,children:`Use in a shared group`}),`\n`,_jsxs(_components.p,{children:[`For Telegram or WhatsApp groups, the owner must enable `,_jsx(_components.strong,{children:`Connected app actions`}),` in `,_jsx(_components.strong,{children:`Channels`}),` before group participants can use Airtable, Notion, or another approved app through Aubrey.`]}),`\n`,_jsxs(_components.p,{children:[`If Aubrey shows `,_jsx(_components.strong,{children:`Reconnect`}),` for a previously connected app, finish that reconnect step for the same app you asked to use. Aubrey should not switch you to a different app just because one needs attention.`]})]})}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":"Connect an approved app","description":null,"href":"/help-center/getting-started/connect-a-connected-app"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Connect or reconnect","slug":"connect-or-reconnect","depth":2,"children":[]},{"title":"Continue from chat","slug":"continue-from-chat","depth":2,"children":[]},{"title":"Use in a shared group","slug":"use-in-a-shared-group","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"aubrey-11","siteName":"Aubrey Docs","title":"Connect an approved app - Aubrey Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-09-08T17:58:03.197Z","originalFileLocation":"help-center/getting-started/connect-a-connected-app.md"},"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=\"light\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"application-name\" content=\"Aubrey Docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/x-icon\" sizes=\"180x180\" href=\"https://mintcdn.com/aubrey-11/Z_rP_3cUHePvNAmJ/images/favicon.ico?fit=max\u0026amp;auto=format\u0026amp;n=Z_rP_3cUHePvNAmJ\u0026amp;q=85\u0026amp;s=8fce2e4bd2415b1e92caabc08ff10015\">\u003clink data-mint-head rel=\"icon\" type=\"image/x-icon\" sizes=\"32x32\" href=\"https://mintcdn.com/aubrey-11/Z_rP_3cUHePvNAmJ/images/favicon.ico?fit=max\u0026amp;auto=format\u0026amp;n=Z_rP_3cUHePvNAmJ\u0026amp;q=85\u0026amp;s=8fce2e4bd2415b1e92caabc08ff10015\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/x-icon\" sizes=\"16x16\" href=\"https://mintcdn.com/aubrey-11/Z_rP_3cUHePvNAmJ/images/favicon.ico?fit=max\u0026amp;auto=format\u0026amp;n=Z_rP_3cUHePvNAmJ\u0026amp;q=85\u0026amp;s=8fce2e4bd2415b1e92caabc08ff10015\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"https://mintcdn.com/aubrey-11/Z_rP_3cUHePvNAmJ/images/favicon.ico?fit=max\u0026amp;auto=format\u0026amp;n=Z_rP_3cUHePvNAmJ\u0026amp;q=85\u0026amp;s=8fce2e4bd2415b1e92caabc08ff10015\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/x-icon\" sizes=\"32x32\" href=\"https://mintcdn.com/aubrey-11/Z_rP_3cUHePvNAmJ/images/favicon.ico?fit=max\u0026amp;auto=format\u0026amp;n=Z_rP_3cUHePvNAmJ\u0026amp;q=85\u0026amp;s=8fce2e4bd2415b1e92caabc08ff10015\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/x-icon\" sizes=\"16x16\" href=\"https://mintcdn.com/aubrey-11/Z_rP_3cUHePvNAmJ/images/favicon.ico?fit=max\u0026amp;auto=format\u0026amp;n=Z_rP_3cUHePvNAmJ\u0026amp;q=85\u0026amp;s=8fce2e4bd2415b1e92caabc08ff10015\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"https://mintcdn.com/aubrey-11/Z_rP_3cUHePvNAmJ/images/favicon.ico?fit=max\u0026amp;auto=format\u0026amp;n=Z_rP_3cUHePvNAmJ\u0026amp;q=85\u0026amp;s=8fce2e4bd2415b1e92caabc08ff10015\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Connect an approved app - Aubrey Docs\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Aubrey Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://knowledge.helloaubrey.com/help-center/getting-started/connect-a-connected-app\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://aubrey-11.mintlify.app/_mintlify/api/og/v2?division=Getting+started\u0026amp;title=Connect+an+approved+app\u0026amp;theme=0dd8a8089305d8e66012d3db\u0026amp;signature=73d50f2f69ade914642b2ba40c3ea78080b7b337fe481edb19ea11d6bf30f231\">\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=\"Connect an approved app - Aubrey Docs\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://aubrey-11.mintlify.app/_mintlify/api/og/v2?division=Getting+started\u0026amp;title=Connect+an+approved+app\u0026amp;theme=0dd8a8089305d8e66012d3db\u0026amp;signature=73d50f2f69ade914642b2ba40c3ea78080b7b337fe481edb19ea11d6bf30f231\">\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=\"https://mintlify.s3.us-west-1.amazonaws.com/aubrey-11/_generated/favicon/browserconfig.xml?v=3\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Aubrey Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#7C3AED\">\u003clink data-mint-head rel=\"canonical\" href=\"https://knowledge.helloaubrey.com/help-center/getting-started/connect-a-connected-app\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/help-center/getting-started/connect-a-connected-app.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://knowledge.helloaubrey.com/#organization\",\"name\":\"Aubrey Docs\",\"url\":\"https://knowledge.helloaubrey.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/aubrey-11/Z_rP_3cUHePvNAmJ/images/aubrey-logo.png?fit=max\u0026auto=format\u0026n=Z_rP_3cUHePvNAmJ\u0026q=85\u0026s=3bd48af7b20207a5445ed166110d8243\"}},{\"@type\":\"WebSite\",\"@id\":\"https://knowledge.helloaubrey.com#website\",\"name\":\"Aubrey Docs\",\"url\":\"https://knowledge.helloaubrey.com\",\"publisher\":{\"@id\":\"https://knowledge.helloaubrey.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://knowledge.helloaubrey.com/help-center/getting-started/connect-a-connected-app#webpage\",\"url\":\"https://knowledge.helloaubrey.com/help-center/getting-started/connect-a-connected-app\",\"name\":\"Connect an approved app\",\"dateModified\":\"2026-09-08T17:58:03.197Z\",\"isPartOf\":{\"@id\":\"https://knowledge.helloaubrey.com#website\"},\"breadcrumb\":{\"@id\":\"https://knowledge.helloaubrey.com/help-center/getting-started/connect-a-connected-app#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://knowledge.helloaubrey.com/help-center/getting-started/connect-a-connected-app#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Getting started\",\"item\":\"https://knowledge.helloaubrey.com/help-center/getting-started/create-your-first-assistant\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Connect an approved app\",\"item\":\"https://knowledge.helloaubrey.com/help-center/getting-started/connect-a-connected-app\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://knowledge.helloaubrey.com/help-center/getting-started/connect-a-connected-app#article\",\"headline\":\"Connect an approved app\",\"name\":\"Connect an approved app\",\"url\":\"https://knowledge.helloaubrey.com/help-center/getting-started/connect-a-connected-app\",\"mainEntityOfPage\":{\"@id\":\"https://knowledge.helloaubrey.com/help-center/getting-started/connect-a-connected-app#webpage\"},\"dateModified\":\"2026-09-08T17:58:03.197Z\",\"publisher\":{\"@id\":\"https://knowledge.helloaubrey.com/#organization\"},\"isPartOf\":{\"@id\":\"https://knowledge.helloaubrey.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Aubrey Docs\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Aubrey Docs","nav":{"global":null,"tabs":[{"tab":"Home","icon":"home","pages":[{"title":"Home","href":""}]},{"tab":"Documentation","icon":"book","pages":[{"title":"Documentation","href":"/documentation"}]},{"tab":"Help Center","icon":"question-circle","groups":[{"group":"Overview","icon":"book-open","pages":[{"title":"Overview","href":"/help-center"}]},{"group":"Getting started","icon":"rocket","pages":[{"title":"Create your first agent","href":"/help-center/getting-started/create-your-first-assistant"},{"title":"Chat with Aubrey","description":null,"href":"/help-center/getting-started/chat-with-aubrey"},{"title":"Connect an approved app","href":"/help-center/getting-started/connect-a-connected-app"}]},{"group":"Email and calendar","icon":"mail-bulk","pages":[{"title":"Forward selected emails to Aubrey","description":null,"href":"/help-center/email-calendar/forward-selected-emails-to-aubrey"},{"title":"Use Aubrey email and calendar","href":"/help-center/email-calendar/use-aubrey-email-and-calendar"},{"title":"Connect Google Workspace","href":"/help-center/email-calendar/connect-google-workspace"}]},{"group":"Sharing","icon":"share-alt","pages":[{"title":"Share an agent","href":"/help-center/sharing/share-an-assistant"},{"title":"Share a skill","href":"/help-center/sharing/share-a-skill"},{"title":"Use Aubrey in a group chat","href":"/help-center/sharing/use-aubrey-in-a-group-chat"}]},{"group":"Account","icon":"contact-book","pages":[{"title":"Billing and account settings","href":"/help-center/account/billing-and-account-settings"}]}]},{"tab":"Changelog","icon":"calendar","pages":[{"title":"Changelog","href":"/changelog"}]}]},"title":"Connect an approved app - Aubrey Docs","buildId":"dpl_EnxDqhjaNc9a8MVa833TGULPd9uJ","deploymentId":"dpl_EnxDqhjaNc9a8MVa833TGULPd9uJ","dynamics":[],"chunks":[]}