Start connection authorization and return a user-facing URL plus instructions. Inbound messaging endpoints such as LINE require the in-product setup form instead (messaging_setup_requires_ui).
{"docsConfig":{"theme":"maple","$schema":"https://mintlify.com/docs.json","name":"Kylon","colors":{"primary":"#4C5F63","light":"#CDD8D7","dark":"#3A4A4E"},"logo":{"light":"https://mintcdn.com/kylon/dI5U5Le9kjf4Aaet/logo/light.svg?fit=max\u0026auto=format\u0026n=dI5U5Le9kjf4Aaet\u0026q=85\u0026s=96ed53581dca88286ffa5dce6836b245","dark":"https://mintcdn.com/kylon/dI5U5Le9kjf4Aaet/logo/dark.svg?fit=max\u0026auto=format\u0026n=dI5U5Le9kjf4Aaet\u0026q=85\u0026s=5d11cb2ea147392426839a1323b1add6"},"favicon":"https://mintcdn.com/kylon/dI5U5Le9kjf4Aaet/favicon.svg?fit=max\u0026auto=format\u0026n=dI5U5Le9kjf4Aaet\u0026q=85\u0026s=bc093f47bc7f31c1863be194c2600415","api":{"openapi":"openapi.json","playground":{"display":"simple"},"mdx":{"auth":{"method":"key","name":"x-api-key"},"server":"https://api.kylon.io"}},"background":{"color":{"light":"#FCF9F3","dark":"#14110D"}},"footer":{"socials":{"x":"https://x.com/kylon_ai","github":"https://github.com/fre-so"}},"seo":{"metatags":{"canonical":"https://docs.kylon.io","description":"Kylon documentation: collaborate with Agents in Rooms, manage Apps, files, knowledge and Automations, and connect through the CLI and proxy APIs.","og:description":"Kylon documentation: collaborate with Agents in Rooms, manage Apps, files, knowledge and Automations, and connect through the CLI and proxy APIs.","og:image":"https://docs.kylon.io/images/og.png","og:type":"website","twitter:card":"summary_large_image","twitter:description":"Rooms, Agents, Apps, files, knowledge, Automations, CLI setup and proxy APIs for Kylon."}},"fonts":{"family":"Geist"},"styling":{"latex":false},"navigation":{"languages":[{"language":"en","href":"introduction"},{"language":"ja","href":"ja/introduction"}]}},"deployment":{"deploymentMetadataValue":{"subdomain":"kylon","hasAudioNarration":false,"actualSubdomain":"kylon","customDomains":["docs.kylon.io"],"gitSource":{"type":"github","owner":"fre-so","repo":"kylon-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6ae81e7ce4ce0f5bc7ce4f7c","collectionId":"ffdc2f39-1a7a-4454-be7d-1c61083e3c6e","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ae81e7ce4ce0f5bc7ce4f7c"},"feedback":{"agentFeedback":true},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6ae81e7ce4ce0f5bc7ce4f7c","clientVersion":"0.0.4045","searchFilterCounts":[{"language":"en","tag":"Documentation","count":94},{"language":"en","tag":"CLI","count":50},{"language":"en","tag":"Workspace commands","count":39},{"language":"ja","tag":"ドキュメント","count":21},{"language":"en","tag":"Concepts","count":16},{"language":"ja","tag":"コアコンセプト","count":16},{"language":"en","tag":"API Reference","count":9},{"language":"en","tag":"Proxy","count":9},{"language":"en","tag":"Agents","count":8},{"language":"en","tag":"Tutorials","count":7},{"language":"en","tag":"Execution","count":3},{"language":"en","tag":"Connections","count":3},{"language":"ja","tag":"はじめに","count":3},{"language":"ja","tag":"チュートリアル","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":"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":"byok-sep-25","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":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","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":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":true},"customCss":[{"filePath":"style.css","content":".pagination-prev:not(.w-full){flex-shrink:0}.pagination-next>div>div:last-child,.pagination-prev>div>div:first-child{flex-shrink:0}.pagination-next span,.pagination-prev span{white-space:nowrap}"}],"page":{"pagePath":"api-reference/get-auth-url","slug":"/api-reference/get-auth-url","pageMetadata":{"title":"Get Auth URL","openapi":"POST /proxy/tools/auth","description":"Start connection authorization and return a user-facing URL plus instructions. Inbound messaging endpoints such as LINE require the in-product setup form instead (messaging_setup_requires_ui).","href":"/api-reference/get-auth-url"},"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: \"Start connection authorization and return a user-facing URL plus instructions. Inbound messaging endpoints such as LINE require the in-product setup form instead (messaging_setup_requires_ui).\"\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}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Get Auth URL","openapi":"POST /proxy/tools/auth","description":"Start connection authorization and return a user-facing URL plus instructions. Inbound messaging endpoints such as LINE require the in-product setup form instead (messaging_setup_requires_ui).","href":"/api-reference/get-auth-url"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":["/_mintlify/custom/kylon/5723b6435732f5c8/kylon-analytics.js"],"openApiReferenceData":{"operation":{"operationId":"getAuthUrl","summary":"Get auth URL","description":"Start connection authorization and return a user-facing URL plus instructions. Inbound messaging endpoints such as LINE require the in-product setup form instead (messaging_setup_requires_ui).","tags":["Connections"],"requestBody":"12e63710-3eb7-4d74-b8af-a054466f9bab","responses":{"200":"998d2973-8acc-40e5-8fd2-f5cae26f7c80","400":"ec3d516e-41bd-4cfc-9b01-553ba15c1906","401":"19a713f2-9e28-41a4-8a03-92b08c6a0bca"},"method":"post","type":"path","servers":["b2274b65-fcea-4ddd-8b29-1eeeac289af1"],"security":["f9ceb271-8f5d-43ac-8d0e-94ee8e6b8f34","f3dcd8aa-dd82-41aa-8d73-1eb656b0d026"],"path":"/proxy/tools/auth","baseUrlOptions":["https://api.kylon.io"],"title":"Get auth URL","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"toolkit":{"type":"string","description":"Toolkit slug (from search results).","isRequired":true,"uniqueKey":"toolkit","typeLabel":"string"},"scopes":{"type":"array","items":{"type":"string","uniqueKey":"scopes.items.[INDEX]","typeLabel":"string"},"description":"Optional provider-specific OAuth scopes.","uniqueKey":"scopes","typeLabel":"string[]"},"redirect_url":{"type":"string","description":"Agent-started proxy authorization uses Kylon's connection popup callback; this field does not override it.","uniqueKey":"redirect_url","typeLabel":"string"},"connection_intent":{"type":"object","properties":{"kind":{"type":"string","enum":["one_off_access","realtime_delivery","scheduled_digest","context_discovery","unknown"],"isRequired":true,"uniqueKey":"connection_intent.kind","typeLabel":"enum\u003cstring>"},"task_summary":{"type":"string","maxLength":500,"uniqueKey":"connection_intent.task_summary","typeLabel":"string"},"cadence":{"type":"string","maxLength":120,"description":"Required and non-empty for scheduled_digest.","uniqueKey":"connection_intent.cadence","typeLabel":"string"}},"required":["kind"],"description":"Why authorization is requested. Missing or malformed intent normalizes to unknown; scheduled_digest without cadence is rejected.","uniqueKey":"connection_intent","typeLabel":"object"}},"required":["toolkit"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"toolkit":"\u003cstring>","scopes":["\u003cstring>"],"redirect_url":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"998d2973-8acc-40e5-8fd2-f5cae26f7c80":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"redirectUrl":{"type":"string","description":"URL to open in a browser to complete the OAuth flow.","isRequired":true,"uniqueKey":"redirectUrl","typeLabel":"string"},"agentInstruction":{"type":"string","description":"Instructions for presenting the authorization link.","isRequired":true,"uniqueKey":"agentInstruction","typeLabel":"string"}},"required":["redirectUrl","agentInstruction"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"redirectUrl":"\u003cstring>","agentInstruction":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"ec3d516e-41bd-4cfc-9b01-553ba15c1906":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"message":{"type":"string","uniqueKey":"message","typeLabel":"string"},"code":{"oneOf":[{"type":"integer","uniqueKey":"code.oneOf.0","typeLabel":"integer"},{"type":"string","uniqueKey":"code.oneOf.1","typeLabel":"string"}],"uniqueKey":"code","typeLabel":"integer | string"},"details":{"type":"object","additionalProperties":true,"uniqueKey":"details","typeLabel":"object"},"guidance":{"description":"Instructions for recovering from a script policy refusal.","uniqueKey":"guidance","typeLabel":"any"},"recoverable":{"type":"boolean","uniqueKey":"recoverable","typeLabel":"boolean"},"suggested_connections":{"type":"array","items":{"type":"object","additionalProperties":true,"uniqueKey":"suggested_connections.items.[INDEX]","typeLabel":"object"},"uniqueKey":"suggested_connections","typeLabel":"object[]"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>","message":"\u003cstring>","code":123,"details":{},"guidance":"\u003cunknown>","recoverable":true,"suggested_connections":[{}]}}},"exampleType":"generated"}},"exampleType":"generated"},"19a713f2-9e28-41a4-8a03-92b08c6a0bca":{"description":"Unauthorized - invalid or missing API key","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"message":{"type":"string","uniqueKey":"message","typeLabel":"string"},"code":{"oneOf":[{"type":"integer","uniqueKey":"code.oneOf.0","typeLabel":"integer"},{"type":"string","uniqueKey":"code.oneOf.1","typeLabel":"string"}],"uniqueKey":"code","typeLabel":"integer | string"},"details":{"type":"object","additionalProperties":true,"uniqueKey":"details","typeLabel":"object"},"guidance":{"description":"Instructions for recovering from a script policy refusal.","uniqueKey":"guidance","typeLabel":"any"},"recoverable":{"type":"boolean","uniqueKey":"recoverable","typeLabel":"boolean"},"suggested_connections":{"type":"array","items":{"type":"object","additionalProperties":true,"uniqueKey":"suggested_connections.items.[INDEX]","typeLabel":"object"},"uniqueKey":"suggested_connections","typeLabel":"object[]"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>","message":"\u003cstring>","code":123,"details":{},"guidance":"\u003cunknown>","recoverable":true,"suggested_connections":[{}]}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"f9ceb271-8f5d-43ac-8d0e-94ee8e6b8f34":{"apiKey":{"type":"apiKey","in":"header","name":"x-api-key","description":"Kylon agent API credential. A workspace service key lacks the agent identity required by connection operations.","scopes":[],"schemeName":"apiKey"}},"f3dcd8aa-dd82-41aa-8d73-1eb656b0d026":{"bearerAuth":{"type":"http","scheme":"bearer","description":"Use a Kylon agent API credential. Keep runtime-provided signed context attached to the token.","scopes":[],"schemeName":"bearerAuth"}}},"servers":{"b2274b65-fcea-4ddd-8b29-1eeeac289af1":{"url":"https://api.kylon.io","description":"Production"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"x-api-key","description":"Kylon agent API credential. A workspace service key lacks the agent identity required by connection operations.","scopes":[],"schemeName":"apiKey"},"schema":{"title":"x-api-key","type":"string","description":"Kylon agent API credential. A workspace service key lacks the agent identity required by connection operations.","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"apiKey","name":"x-api-key"}],"title":"apiKey"},{"schemes":[{"scheme":{"type":"http","scheme":"bearer","description":"Use a Kylon agent API credential. Keep runtime-provided signed context attached to the token.","scopes":[],"schemeName":"bearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Use a Kylon agent API credential. Keep runtime-provided signed context attached to the token.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"}]},"originalFileLocation":"openapi.json"},"subdomain":"kylon","siteName":"Kylon","title":"Get Auth URL - Kylon","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"en":{"href":"/api-reference/get-auth-url","matchLevel":0},"ja":{"href":"/ja/introduction","matchLevel":4}}},"lastModified":"2026-10-15T15:52:26.789Z","originalFileLocation":"api-reference/get-auth-url.mdx","locale":"en"},"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=\"Start connection authorization and return a user-facing URL plus instructions. Inbound messaging endpoints such as LINE require the in-product setup form instead (messaging_setup_requires_ui).\">\u003cmeta data-mint-head name=\"application-name\" content=\"Kylon\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/kylon/GxdFPJNExZFCV4u_/_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/kylon/GxdFPJNExZFCV4u_/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/kylon/GxdFPJNExZFCV4u_/_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/kylon/GxdFPJNExZFCV4u_/_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/kylon/GxdFPJNExZFCV4u_/_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/kylon/GxdFPJNExZFCV4u_/_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/kylon/GxdFPJNExZFCV4u_/_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/kylon/GxdFPJNExZFCV4u_/_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/kylon/GxdFPJNExZFCV4u_/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Get Auth URL - Kylon\">\u003cmeta data-mint-head property=\"og:description\" content=\"Kylon documentation: collaborate with Agents in Rooms, manage Apps, files, knowledge and Automations, and connect through the CLI and proxy APIs.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Kylon\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.kylon.io/api-reference/get-auth-url\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://docs.kylon.io/images/og.png\">\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=\"Get Auth URL - Kylon\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Rooms, Agents, Apps, files, knowledge, Automations, CLI setup and proxy APIs for Kylon.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://docs.kylon.io/images/og.png\">\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/kylon/GxdFPJNExZFCV4u_/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Kylon\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#4C5F63\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.kylon.io/api-reference/get-auth-url\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/get-auth-url.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.kylon.io/#organization\",\"name\":\"Kylon\",\"url\":\"https://docs.kylon.io\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/kylon/dI5U5Le9kjf4Aaet/logo/light.svg?fit=max\u0026auto=format\u0026n=dI5U5Le9kjf4Aaet\u0026q=85\u0026s=96ed53581dca88286ffa5dce6836b245\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.kylon.io#website\",\"name\":\"Kylon\",\"url\":\"https://docs.kylon.io\",\"publisher\":{\"@id\":\"https://docs.kylon.io/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.kylon.io/api-reference/get-auth-url#webpage\",\"url\":\"https://docs.kylon.io/api-reference/get-auth-url\",\"name\":\"Get Auth URL\",\"description\":\"Start connection authorization and return a user-facing URL plus instructions. Inbound messaging endpoints such as LINE require the in-product setup form instead (messaging_setup_requires_ui).\",\"dateModified\":\"2026-10-15T15:52:26.789Z\",\"isPartOf\":{\"@id\":\"https://docs.kylon.io#website\"},\"breadcrumb\":{\"@id\":\"https://docs.kylon.io/api-reference/get-auth-url#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.kylon.io/api-reference/get-auth-url#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Connections\",\"item\":\"https://docs.kylon.io/api-reference/list-connections\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Get Auth URL\",\"item\":\"https://docs.kylon.io/api-reference/get-auth-url\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.kylon.io/api-reference/get-auth-url#apireference\",\"headline\":\"Get Auth URL\",\"name\":\"Get Auth URL\",\"description\":\"Start connection authorization and return a user-facing URL plus instructions. Inbound messaging endpoints such as LINE require the in-product setup form instead (messaging_setup_requires_ui).\",\"url\":\"https://docs.kylon.io/api-reference/get-auth-url\",\"mainEntityOfPage\":{\"@id\":\"https://docs.kylon.io/api-reference/get-auth-url#webpage\"},\"image\":\"https://docs.kylon.io/images/og.png\",\"dateModified\":\"2026-10-15T15:52:26.789Z\",\"publisher\":{\"@id\":\"https://docs.kylon.io/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.kylon.io#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Kylon\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Kylon","nav":{"global":null,"languages":[{"language":"en","tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":"/introduction"}]},{"tab":"API Reference","groups":[{"group":"Overview","pages":[{"title":"Kylon Tools API reference","sidebarTitle":"API Reference","href":"/api-reference/introduction"}]},{"group":"Connections","pages":[{"title":"List Connections","openapi":"GET /proxy/tools/connections","description":"List all connections currently linked to your agent.","href":"/api-reference/list-connections"},{"title":"Get Auth URL","openapi":"POST /proxy/tools/auth","href":"/api-reference/get-auth-url"}]},{"group":"Toolkits","pages":[{"title":"Search Toolkits","openapi":"GET /proxy/tools/search","description":"Search available toolkits by keywords. Returns both native and third-party integrations.","href":"/api-reference/search-toolkits"},{"title":"Get Toolkit Details","openapi":"GET /proxy/tools/toolkit/{toolkit}","href":"/api-reference/get-toolkit-details"},{"title":"Search Toolkit Tools","openapi":"GET /proxy/tools/toolkit/{toolkit}/search","href":"/api-reference/search-toolkit-tools"}]},{"group":"Execution","pages":[{"title":"Execute Tool","openapi":"POST /proxy/tools/execute","href":"/api-reference/execute-tool"},{"title":"Proxy Request","openapi":"POST /proxy/tools/proxy","href":"/api-reference/proxy-request"},{"title":"Upload File","openapi":"POST /proxy/tools/upload","href":"/api-reference/upload-file"}]}]}]},{"language":"ja","pages":[{"title":"ja","href":"/ja/introduction"}]}]},"basePath":"","title":"Get Auth URL - Kylon","buildId":"dpl_36EDyZCDfRuoUD9af5CH4M1bqY2h","deploymentId":"dpl_36EDyZCDfRuoUD9af5CH4M1bqY2h","dynamics":["c2aa737661","b0f84f53ff","a9bb46feb3","2b790eda92"],"chunks":["OpenApiReferenceProvider-DCDCdBVX.js","utils-ME8dDnLe.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-0e84ACsd.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-wgRBj-ia.js","snippetPresets-C11Sgb-o.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","Page-Bevw23-4.js","ApiExamples-C0lapOpP.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-ZeRQV8fF.js","shallow-BupWh095.js","getApiPlaygroundDisplay-BnYQO2Ss.js","CodeSnippet-RKKOc8c_.js","CodeSnippets-Drf_m8wS.js","getPastedJson-u6QiPzNZ.js","icon-Bb-CBSxO.js","MethodPill-F7l5AI7V.js","DuplicateIcon-IiAXkdSg.js","createIcon-FliI8EBc.js","DynamicMarkdown-B62XqCSI.js","SectionHeading-Dj31pT03.js","axios-vUo_bRtp.js","Markdown-BOgQCTwD.js","clsx-BIWXJmsZ.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-DKZWslLH.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-UDqbR6xh.js"]}