The most recent connection attempt initiated against this session, if any. Use this to poll for OAuth completion: when status is "authenticated", the resulting account is at account_secure_id.
Show child attributes
Was this page helpful?
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Stackone","colors":{"primary":"#068F56","light":"#00AF66","dark":"#068F56"},"logo":{"light":"https://mintcdn.com/stackone-60/WsmKpuoeBZmio9QO/images/logo/logo-light-mode.svg?fit=max\u0026auto=format\u0026n=WsmKpuoeBZmio9QO\u0026q=85\u0026s=f08be9c0a142cb1e7fcaa23910c4bf7f","dark":"https://mintcdn.com/stackone-60/WsmKpuoeBZmio9QO/images/logo/logo-dark-mode.svg?fit=max\u0026auto=format\u0026n=WsmKpuoeBZmio9QO\u0026q=85\u0026s=b57d63594c13dee65c06a2d578927466","href":"/introduction"},"favicon":"https://mintcdn.com/stackone-60/EZ7nWzE-JJzhmP-C/images/logo/favicon.png?fit=max\u0026auto=format\u0026n=EZ7nWzE-JJzhmP-C\u0026q=85\u0026s=9012a8ae6ce9a80698406b611be47925","appearance":{"default":"light"},"background":{"image":{"light":"https://mintcdn.com/stackone-60/knwbcGlYFJSeLObv/images/background/light.svg?fit=max\u0026auto=format\u0026n=knwbcGlYFJSeLObv\u0026q=85\u0026s=112166d244e990ebc0146ff96958757c","dark":"https://mintcdn.com/stackone-60/knwbcGlYFJSeLObv/images/background/dark.svg?fit=max\u0026auto=format\u0026n=knwbcGlYFJSeLObv\u0026q=85\u0026s=50ec5e23eeb91f55e78a0da97dcaeb7b"},"color":{"dark":"#1a1a1a"}},"navbar":{"links":[{"icon":"circle-question","href":"/support","label":"Support"},{"href":"https://app.stackone.com","label":"Login"},{"href":"https://www.stackone.com/demo/","label":"Book a demo"}],"primary":{"type":"button","label":"Start Free","href":"https://app.stackone.com/sign_up"}},"footer":{"socials":{"linkedin":"https://www.linkedin.com/company/stackonehq","twitter":"https://twitter.com/StackOneHQ"}},"seo":{"metatags":{"canonical":"https://docs.stackone.com","google-site-verification":"gYj1x4gkdSwpCGVLFVXNVOPQ_wVrePW37ZKJt3HEqys"}},"fonts":{"heading":{"family":"Sf Pro Display","source":"https://fonts.gstatic.com/s/inter/v18/UcC73FwrK3iLTeHuS_nVMrMxCp50SjIa1ZL7W0Q5nw.woff2","format":"woff2"},"body":{"family":"Inter","source":"https://fonts.gstatic.com/s/inter/v18/UcC73FwrK3iLTeHuS_nVMrMxCp50SjIa1ZL7W0Q5nw.woff2","format":"woff2"}},"styling":{"eyebrows":"breadcrumbs","latex":true},"integrations":{"gtm":{"tagId":"GTM-NZNK37TL"}},"contextual":{"options":["copy","view","chatgpt","claude","perplexity"],"display":"header"},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"stackone-60","hasAudioNarration":false,"actualSubdomain":"stackone-60","customDomains":["docs.stackone.com"],"gitSource":{"type":"github","owner":"stackonehq","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"feedback":{"thumbs":true,"edits":false,"issues":false,"agentFeedback":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6af55880f4d75564ff81b840","clientVersion":"0.0.4111","searchFilterCounts":[{"language":"default","tag":"Connectors","count":6712},{"language":"default","tag":"Connector Catalog","count":3335},{"language":"default","tag":"Embed","count":84},{"language":"default","tag":"Platform API","count":64},{"language":"default","tag":"Gateway","count":50},{"language":"default","tag":"Features","count":48},{"language":"default","tag":"Connector Building","count":42},{"language":"default","tag":"Unified Actions","count":39},{"language":"default","tag":"Embed StackOne","count":36},{"language":"default","tag":"Call Actions","count":29}],"searchSettings":{"isFiltersEnabled":true}},"assistantConfig":{"enableStarterQuestions":false,"deflection":{"enabled":true,"email":"support@stackone.com"}},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"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}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","href":"/_mintlify/custom/stackone-60/b179af0a520e7db3/style.css"}],"page":{"pagePath":"platform/api-reference/connect-sessions/get-connect-session","slug":"/platform/api-reference/connect-sessions/get-connect-session","pageMetadata":{"openapi":"get /connect_sessions/{id}","title":"Get Connect Session","description":"Returns a connect session and the state of its most recent connection attempt.","href":"/platform/api-reference/connect-sessions/get-connect-session"},"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: \"Returns a connect session and the state of its most recent connection attempt.\"\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":{"openapi":"get /connect_sessions/{id}","title":"Get Connect Session","description":"Returns a connect session and the state of its most recent connection attempt.","href":"/platform/api-reference/connect-sessions/get-connect-session"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":["/_mintlify/custom/stackone-60/072d59ca3ea476f6/status-indicator.js","/_mintlify/custom/stackone-60/108e4b0e256a9ba7/connectors.js","/_mintlify/custom/stackone-60/af28b3fbb0435529/hubspot-form.js","/_mintlify/custom/stackone-60/b0c197d5192fa356/end-users.js"],"openApiReferenceData":{"operation":{"description":"Returns a connect session and the state of its most recent connection attempt.","operationId":"stackone_get_connect_session","parameters":["2d34374f-4e77-4071-9404-bfd781fc3dfe"],"responses":{"200":"75c1b821-4115-454b-9977-944cb1a39512","400":"b8ffa34d-3b68-4331-95f1-34f1a030cc51","401":"87c0747e-9826-4d76-a790-65c527d0d3bd","403":"eab23339-0495-4fcb-9658-910b378ec4f3","404":"77cbbc26-0cfa-48ab-880a-483d0174facb","408":"293b8e30-6b89-4018-abb9-a2e2af7821aa","409":"c7378acb-b035-4da8-a25a-2fe4844ad7f3","422":"e1434659-51e4-4782-9da8-7210852ec250","429":"2b655c7e-0324-4c38-9ff7-62e09dafe7a5","500":"386a9dfa-7265-4429-9939-b76af30186db","501":"ef2bbb44-1d61-400c-af91-a27b3dc99a53","502":"f88c1fa2-588a-4f92-87bd-a241711a8275"},"security":["8ac553bb-f5b8-48db-9f18-2e0a1d9ceacc"],"summary":"Get Connect Session","tags":["Connect Sessions"],"x-speakeasy-name-override":"get_connect_session","x-speakeasy-retries":{"statusCodes":[429,408],"strategy":"backoff"},"method":"get","type":"path","servers":["c71b036b-c486-4ced-aa78-f1e13844d595"],"path":"/connect_sessions/{id}","baseUrlOptions":["https://api.stackone.com"],"title":"Get Connect Session","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"2d34374f-4e77-4071-9404-bfd781fc3dfe":{"name":"id","required":true,"in":"path","schema":{"type":"number","isRequired":true,"uniqueKey":"","typeLabel":"number"}}},"responses":{"75c1b821-4115-454b-9977-944cb1a39512":{"description":"The connect session, including the most recent connection attempt (use latest_connection_attempt.status to poll for OAuth completion).","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"number","isRequired":true,"uniqueKey":"id","typeLabel":"number"},"organization_id":{"type":"string","isRequired":true,"uniqueKey":"organization_id","typeLabel":"string"},"project_id":{"type":"string","isRequired":true,"uniqueKey":"project_id","typeLabel":"string"},"origin_owner_id":{"type":"string","isRequired":true,"uniqueKey":"origin_owner_id","typeLabel":"string"},"origin_owner_name":{"type":"string","isRequired":true,"uniqueKey":"origin_owner_name","typeLabel":"string"},"created_at":{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"created_at","typeLabel":"string\u003cdate-time>"},"categories":{"oneOf":[{"type":"array","example":["ats","hris","hrisLegacy","crm","iam","marketing","lms","stackOne","documents","ticketing","screening","messaging","accounting","scheduling"],"x-speakeasy-unknown-values":"allow","items":{"type":"string","enum":["ats","hris","hris-legacy","crm","iam","marketing","lms","stackone","documents","ticketing","screening","messaging","accounting","scheduling",null],"uniqueKey":"categories.oneOf.0.items.[INDEX]","typeLabel":"enum\u003cstring>"},"uniqueKey":"categories.oneOf.0","typeLabel":"enum\u003cstring>[]"},{"type":"null","example":["ats","hris","hrisLegacy","crm","iam","marketing","lms","stackOne","documents","ticketing","screening","messaging","accounting","scheduling"],"x-speakeasy-unknown-values":"allow","items":{"type":"string","enum":["ats","hris","hris-legacy","crm","iam","marketing","lms","stackone","documents","ticketing","screening","messaging","accounting","scheduling",null]},"uniqueKey":"categories.oneOf.1","typeLabel":"null"}],"uniqueKey":"categories","typeLabel":"enum\u003cstring>[] | null"},"provider":{"oneOf":[{"type":"string","uniqueKey":"provider.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"provider.oneOf.1","typeLabel":"null"}],"uniqueKey":"provider","typeLabel":"string | null"},"origin_username":{"oneOf":[{"type":"string","uniqueKey":"origin_username.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"origin_username.oneOf.1","typeLabel":"null"}],"uniqueKey":"origin_username","typeLabel":"string | null"},"account_id":{"oneOf":[{"type":"string","uniqueKey":"account_id.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"account_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"account_id","typeLabel":"string | null"},"label":{"oneOf":[{"type":"string","uniqueKey":"label.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"label.oneOf.1","typeLabel":"null"}],"uniqueKey":"label","typeLabel":"string | null"},"metadata":{"oneOf":[{"type":"object","description":"Arbitrary set of key and values defined during the session token creation. This can be used to tag an account (eg. based on their pricing plan)","uniqueKey":"metadata.oneOf.0","typeLabel":"object"},{"type":"null","description":"Arbitrary set of key and values defined during the session token creation. This can be used to tag an account (eg. based on their pricing plan)","uniqueKey":"metadata.oneOf.1","typeLabel":"null"}],"uniqueKey":"metadata","typeLabel":"object | null"},"external_trigger_token":{"oneOf":[{"type":"string","description":"External trigger token to be used to trigger actions on the account","example":"f0bc3d88-2178-5423-8c81-b81d6c9da824","uniqueKey":"external_trigger_token.oneOf.0","typeLabel":"string"},{"type":"null","description":"External trigger token to be used to trigger actions on the account","example":"f0bc3d88-2178-5423-8c81-b81d6c9da824","uniqueKey":"external_trigger_token.oneOf.1","typeLabel":"null"}],"uniqueKey":"external_trigger_token","typeLabel":"string | null"},"type":{"oneOf":[{"type":"string","description":"The connect session account type","enum":["production","test","unmapped_value",null],"example":["PRODUCTION","TEST"],"x-speakeasy-unknown-values":"allow","uniqueKey":"type.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","description":"The connect session account type","enum":["production","test","unmapped_value",null],"example":["PRODUCTION","TEST"],"x-speakeasy-unknown-values":"allow","uniqueKey":"type.oneOf.1","typeLabel":"null"}],"uniqueKey":"type","typeLabel":"enum\u003cstring> | null"},"integration_id":{"oneOf":[{"type":"string","description":"Deprecated: use `connector_profile_id` instead. The integration ID (UUID) associated with this connect session.","deprecated":true,"uniqueKey":"integration_id.oneOf.0","typeLabel":"string"},{"type":"null","description":"Deprecated: use `connector_profile_id` instead. The integration ID (UUID) associated with this connect session.","deprecated":true,"uniqueKey":"integration_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"integration_id","typeLabel":"string | null"},"connector_profile_id":{"oneOf":[{"type":"string","description":"The connector profile ID associated with this connect session","uniqueKey":"connector_profile_id.oneOf.0","typeLabel":"string"},{"type":"null","description":"The connector profile ID associated with this connect session","uniqueKey":"connector_profile_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"connector_profile_id","typeLabel":"string | null"},"connector_profile_ids":{"oneOf":[{"description":"The ordered connector profile IDs this connect session is restricted to, or null when it is not restricted to a list.","type":"array","items":{"type":"string","uniqueKey":"connector_profile_ids.oneOf.0.items.[INDEX]","typeLabel":"string"},"uniqueKey":"connector_profile_ids.oneOf.0","typeLabel":"string[]"},{"description":"The ordered connector profile IDs this connect session is restricted to, or null when it is not restricted to a list.","type":"null","items":{"type":"string"},"uniqueKey":"connector_profile_ids.oneOf.1","typeLabel":"null"}],"uniqueKey":"connector_profile_ids","typeLabel":"string[] | null"},"latest_connection_attempt":{"oneOf":[{"type":"object","description":"The most recent connection attempt initiated against this session, if any. Use this to poll for OAuth completion: when status is \"authenticated\", the resulting account is at account_secure_id.","required":["id","created_at","updated_at"],"properties":{"id":{"type":"string","isRequired":true,"uniqueKey":"latest_connection_attempt.oneOf.0.id","typeLabel":"string"},"created_at":{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"latest_connection_attempt.oneOf.0.created_at","typeLabel":"string\u003cdate-time>"},"updated_at":{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"latest_connection_attempt.oneOf.0.updated_at","typeLabel":"string\u003cdate-time>"},"status":{"oneOf":[{"type":"string","enum":["pending","authenticated","error","cancelled",null],"example":"pending","x-speakeasy-unknown-values":"allow","uniqueKey":"latest_connection_attempt.oneOf.0.status.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","enum":["pending","authenticated","error","cancelled",null],"example":"pending","x-speakeasy-unknown-values":"allow","uniqueKey":"latest_connection_attempt.oneOf.0.status.oneOf.1","typeLabel":"null"}],"uniqueKey":"latest_connection_attempt.oneOf.0.status","typeLabel":"enum\u003cstring> | null"},"account_secure_id":{"oneOf":[{"type":"string","description":"The secure id of the account created/updated by this attempt. Populated only after a successful authentication.","uniqueKey":"latest_connection_attempt.oneOf.0.account_secure_id.oneOf.0","typeLabel":"string"},{"type":"null","description":"The secure id of the account created/updated by this attempt. Populated only after a successful authentication.","uniqueKey":"latest_connection_attempt.oneOf.0.account_secure_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"latest_connection_attempt.oneOf.0.account_secure_id","typeLabel":"string | null"},"oauth_error_code":{"oneOf":[{"type":"string","uniqueKey":"latest_connection_attempt.oneOf.0.oauth_error_code.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"latest_connection_attempt.oneOf.0.oauth_error_code.oneOf.1","typeLabel":"null"}],"uniqueKey":"latest_connection_attempt.oneOf.0.oauth_error_code","typeLabel":"string | null"},"oauth_error_description":{"oneOf":[{"type":"string","uniqueKey":"latest_connection_attempt.oneOf.0.oauth_error_description.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"latest_connection_attempt.oneOf.0.oauth_error_description.oneOf.1","typeLabel":"null"}],"uniqueKey":"latest_connection_attempt.oneOf.0.oauth_error_description","typeLabel":"string | null"}},"uniqueKey":"latest_connection_attempt.oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"latest_connection_attempt.oneOf.1","typeLabel":"null"}],"uniqueKey":"latest_connection_attempt","typeLabel":"object | null"}},"required":["id","organization_id","project_id","origin_owner_id","origin_owner_name","created_at"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"id":123,"organization_id":"\u003cstring>","project_id":"\u003cstring>","origin_owner_id":"\u003cstring>","origin_owner_name":"\u003cstring>","created_at":"2023-11-07T05:31:56Z","categories":["ats","hris","hrisLegacy","crm","iam","marketing","lms","stackOne","documents","ticketing","screening","messaging","accounting","scheduling"],"provider":"\u003cstring>","origin_username":"\u003cstring>","account_id":"\u003cstring>","label":"\u003cstring>","metadata":{},"external_trigger_token":"f0bc3d88-2178-5423-8c81-b81d6c9da824","type":["PRODUCTION","TEST"],"integration_id":"\u003cstring>","connector_profile_id":"\u003cstring>","connector_profile_ids":["\u003cstring>"],"latest_connection_attempt":{"id":"\u003cstring>","created_at":"2023-11-07T05:31:56Z","updated_at":"2023-11-07T05:31:56Z","status":"pending","account_secure_id":"\u003cstring>","oauth_error_code":"\u003cstring>","oauth_error_description":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"b8ffa34d-3b68-4331-95f1-34f1a030cc51":{"description":"Invalid request.","content":{"application/json":{"schema":{"type":"object","properties":{"statusCode":{"type":"number","description":"HTTP status code","example":400,"isRequired":true,"uniqueKey":"statusCode","typeLabel":"number"},"message":{"type":"string","description":"Error message","example":"Bad Request","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"timestamp":{"type":"string","description":"Timestamp when the error occurred","example":"2023-05-30T00:00:00.000Z","format":"date-time","isRequired":true,"uniqueKey":"timestamp","typeLabel":"string\u003cdate-time>"},"data":{"oneOf":[{"type":"object","description":"Error details","properties":{"statusCode":{"oneOf":[{"type":"number","description":"HTTP status code","example":400,"uniqueKey":"data.oneOf.0.statusCode.oneOf.0","typeLabel":"number"},{"type":"null","description":"HTTP status code","example":400,"uniqueKey":"data.oneOf.0.statusCode.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.oneOf.0.statusCode","typeLabel":"number | null"},"message":{"oneOf":[{"type":"string","description":"Error message","example":"Bad Request","uniqueKey":"data.oneOf.0.message.oneOf.0","typeLabel":"string"},{"type":"null","description":"Error message","example":"Bad Request","uniqueKey":"data.oneOf.0.message.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.oneOf.0.message","typeLabel":"string | null"},"headers":{"oneOf":[{"type":"object","description":"Response headers","example":{"content-type":"application/json","x-request-id":"5678c28b211dace4e0a0f9171e6b88c5"},"uniqueKey":"data.oneOf.0.headers.oneOf.0","typeLabel":"object"},{"type":"null","description":"Response headers","example":{"content-type":"application/json","x-request-id":"5678c28b211dace4e0a0f9171e6b88c5"},"uniqueKey":"data.oneOf.0.headers.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.oneOf.0.headers","typeLabel":"object | null"}},"uniqueKey":"data.oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"data.oneOf.1","typeLabel":"null"}],"uniqueKey":"data","typeLabel":"object | null"},"provider_errors":{"oneOf":[{"description":"List of provider-specific errors","type":"array","items":{"type":"object","properties":{"status":{"oneOf":[{"type":"number","description":"HTTP status code of the provider error","example":400,"uniqueKey":"provider_errors.oneOf.0.items.[INDEX].status.oneOf.0","typeLabel":"number"},{"type":"null","description":"HTTP status code of the provider error","example":400,"uniqueKey":"provider_errors.oneOf.0.items.[INDEX].status.oneOf.1","typeLabel":"null"}],"uniqueKey":"provider_errors.oneOf.0.items.[INDEX].status","typeLabel":"number | null"},"url":{"oneOf":[{"type":"string","description":"URL that caused the error","example":"https://api.provider.com/v1/resource","uniqueKey":"provider_errors.oneOf.0.items.[INDEX].url.oneOf.0","typeLabel":"string"},{"type":"null","description":"URL that caused the error","example":"https://api.provider.com/v1/resource","uniqueKey":"provider_errors.oneOf.0.items.[INDEX].url.oneOf.1","typeLabel":"null"}],"uniqueKey":"provider_errors.oneOf.0.items.[INDEX].url","typeLabel":"string | null"},"raw":{"oneOf":[{"type":"object","description":"Raw error response from the provider","example":{"message":"Invalid input parameters"},"uniqueKey":"provider_errors.oneOf.0.items.[INDEX].raw.oneOf.0","typeLabel":"object"},{"type":"null","description":"Raw error response from the provider","example":{"message":"Invalid input parameters"},"uniqueKey":"provider_errors.oneOf.0.items.[INDEX].raw.oneOf.1","typeLabel":"null"}],"uniqueKey":"provider_errors.oneOf.0.items.[INDEX].raw","typeLabel":"object | null"},"headers":{"oneOf":[{"type":"object","description":"Response headers","example":{"content-type":"application/json","x-request-id":"5678c28b211dace4e0a0f9171e6b88c5"},"uniqueKey":"provider_errors.oneOf.0.items.[INDEX].headers.oneOf.0","typeLabel":"object"},{"type":"null","description":"Response headers","example":{"content-type":"application/json","x-request-id":"5678c28b211dace4e0a0f9171e6b88c5"},"uniqueKey":"provider_errors.oneOf.0.items.[INDEX].headers.oneOf.1","typeLabel":"null"}],"uniqueKey":"provider_errors.oneOf.0.items.[INDEX].headers","typeLabel":"object | null"}},"uniqueKey":"provider_errors.oneOf.0.items.[INDEX]","typeLabel":"object"},"uniqueKey":"provider_errors.oneOf.0","typeLabel":"object[]"},{"description":"List of provider-specific errors","type":"null","items":{"type":"object","properties":{"status":{"oneOf":[{"type":"number","description":"HTTP status code of the provider error","example":400},{"type":"null","description":"HTTP status code of the provider error","example":400}]},"url":{"oneOf":[{"type":"string","description":"URL that caused the error","example":"https://api.provider.com/v1/resource"},{"type":"null","description":"URL that caused the error","example":"https://api.provider.com/v1/resource"}]},"raw":{"oneOf":[{"type":"object","description":"Raw error response from the provider","example":{"message":"Invalid input parameters"}},{"type":"null","description":"Raw error response from the provider","example":{"message":"Invalid input parameters"}}]},"headers":{"oneOf":[{"type":"object","description":"Response headers","example":{"content-type":"application/json","x-request-id":"5678c28b211dace4e0a0f9171e6b88c5"}},{"type":"null","description":"Response headers","example":{"content-type":"application/json","x-request-id":"5678c28b211dace4e0a0f9171e6b88c5"}}]}}},"uniqueKey":"provider_errors.oneOf.1","typeLabel":"null"}],"uniqueKey":"provider_errors","typeLabel":"object[] | null"}},"required":["statusCode","message","timestamp"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"statusCode":400,"message":"Bad Request","timestamp":"2023-05-30T00:00:00.000Z","data":{"statusCode":400,"message":"Bad Request","headers":{"content-type":"application/json","x-request-id":"5678c28b211dace4e0a0f9171e6b88c5"}},"provider_errors":[{"status":400,"url":"https://api.provider.com/v1/resource","raw":{"message":"Invalid input parameters"},"headers":{"content-type":"application/json","x-request-id":"5678c28b211dace4e0a0f9171e6b88c5"}}]}}},"exampleType":"generated"}},"exampleType":"generated"},"87c0747e-9826-4d76-a790-65c527d0d3bd":{"description":"Unauthorized access.","content":{"application/json":{"schema":{"type":"object","properties":{"statusCode":{"type":"number","description":"HTTP status code","example":401,"isRequired":true,"uniqueKey":"statusCode","typeLabel":"number"},"message":{"type":"string","description":"Error message","example":"Unauthorized","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"timestamp":{"type":"string","description":"Timestamp when the error occurred","example":"2023-05-30T00:00:00.000Z","format":"date-time","isRequired":true,"uniqueKey":"timestamp","typeLabel":"string\u003cdate-time>"}},"required":["statusCode","message","timestamp"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"statusCode":401,"message":"Unauthorized","timestamp":"2023-05-30T00:00:00.000Z"}}},"exampleType":"generated"}},"exampleType":"generated"},"eab23339-0495-4fcb-9658-910b378ec4f3":{"description":"Forbidden.","content":{"application/json":{"schema":{"type":"object","properties":{"statusCode":{"type":"number","description":"HTTP status code","example":403,"isRequired":true,"uniqueKey":"statusCode","typeLabel":"number"},"message":{"type":"string","description":"Error message","example":"Forbidden resource","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"timestamp":{"type":"string","description":"Timestamp when the error occurred","example":"2023-05-30T00:00:00.000Z","format":"date-time","isRequired":true,"uniqueKey":"timestamp","typeLabel":"string\u003cdate-time>"}},"required":["statusCode","message","timestamp"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"statusCode":403,"message":"Forbidden resource","timestamp":"2023-05-30T00:00:00.000Z"}}},"exampleType":"generated"}},"exampleType":"generated"},"77cbbc26-0cfa-48ab-880a-483d0174facb":{"description":"No connect session with that id exists in this project.\n\nResource not found.","content":{"application/json":{"schema":{"type":"object","properties":{"statusCode":{"type":"number","description":"HTTP status code","example":404,"isRequired":true,"uniqueKey":"statusCode","typeLabel":"number"},"message":{"type":"string","description":"Error message","example":"Not Found","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"timestamp":{"type":"string","description":"Timestamp when the error occurred","example":"2023-05-30T00:00:00.000Z","format":"date-time","isRequired":true,"uniqueKey":"timestamp","typeLabel":"string\u003cdate-time>"}},"required":["statusCode","message","timestamp"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"statusCode":404,"message":"Not Found","timestamp":"2023-05-30T00:00:00.000Z"}}},"exampleType":"generated"}},"exampleType":"generated"},"293b8e30-6b89-4018-abb9-a2e2af7821aa":{"description":"The request has timed out.","headers":{"Retry-After":{"description":"A time in seconds after which the request can be retried.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"statusCode":{"type":"number","description":"HTTP status code","example":408,"isRequired":true,"uniqueKey":"statusCode","typeLabel":"number"},"message":{"type":"string","description":"Error message","example":"Request timed out","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"timestamp":{"type":"string","description":"Timestamp when the error occurred","example":"2023-05-30T00:00:00.000Z","format":"date-time","isRequired":true,"uniqueKey":"timestamp","typeLabel":"string\u003cdate-time>"}},"required":["statusCode","message","timestamp"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"statusCode":408,"message":"Request timed out","timestamp":"2023-05-30T00:00:00.000Z"}}},"exampleType":"generated"}},"exampleType":"generated"},"c7378acb-b035-4da8-a25a-2fe4844ad7f3":{"description":"Conflict with current state.","content":{"application/json":{"schema":{"type":"object","properties":{"statusCode":{"type":"number","description":"HTTP status code","example":409,"isRequired":true,"uniqueKey":"statusCode","typeLabel":"number"},"message":{"type":"string","description":"Error message","example":"Conflict","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"timestamp":{"type":"string","description":"Timestamp when the error occurred","example":"2023-05-30T00:00:00.000Z","format":"date-time","isRequired":true,"uniqueKey":"timestamp","typeLabel":"string\u003cdate-time>"}},"required":["statusCode","message","timestamp"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"statusCode":409,"message":"Conflict","timestamp":"2023-05-30T00:00:00.000Z"}}},"exampleType":"generated"}},"exampleType":"generated"},"e1434659-51e4-4782-9da8-7210852ec250":{"description":"Validation error.","content":{"application/json":{"schema":{"type":"object","properties":{"statusCode":{"type":"number","description":"HTTP status code","example":422,"isRequired":true,"uniqueKey":"statusCode","typeLabel":"number"},"message":{"type":"string","description":"Error message","example":"Unprocessable Entity","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"timestamp":{"type":"string","description":"Timestamp when the error occurred","example":"2023-05-30T00:00:00.000Z","format":"date-time","isRequired":true,"uniqueKey":"timestamp","typeLabel":"string\u003cdate-time>"}},"required":["statusCode","message","timestamp"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"statusCode":422,"message":"Unprocessable Entity","timestamp":"2023-05-30T00:00:00.000Z"}}},"exampleType":"generated"}},"exampleType":"generated"},"2b655c7e-0324-4c38-9ff7-62e09dafe7a5":{"description":"Too many requests.","content":{"application/json":{"schema":{"type":"object","properties":{"statusCode":{"type":"number","description":"HTTP status code","example":429,"isRequired":true,"uniqueKey":"statusCode","typeLabel":"number"},"message":{"type":"string","description":"Error message","example":"Too many requests","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"timestamp":{"type":"string","description":"Timestamp when the error occurred","example":"2023-05-30T00:00:00.000Z","format":"date-time","isRequired":true,"uniqueKey":"timestamp","typeLabel":"string\u003cdate-time>"}},"required":["statusCode","message","timestamp"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"statusCode":429,"message":"Too many requests","timestamp":"2023-05-30T00:00:00.000Z"}}},"exampleType":"generated"}},"exampleType":"generated"},"386a9dfa-7265-4429-9939-b76af30186db":{"description":"Server error while executing the request.","content":{"application/json":{"schema":{"type":"object","properties":{"statusCode":{"type":"number","description":"HTTP status code","example":500,"isRequired":true,"uniqueKey":"statusCode","typeLabel":"number"},"message":{"type":"string","description":"Error message","example":"Internal server error","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"timestamp":{"type":"string","description":"Timestamp when the error occurred","example":"2023-05-30T00:00:00.000Z","format":"date-time","isRequired":true,"uniqueKey":"timestamp","typeLabel":"string\u003cdate-time>"}},"required":["statusCode","message","timestamp"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"statusCode":500,"message":"Internal server error","timestamp":"2023-05-30T00:00:00.000Z"}}},"exampleType":"generated"}},"exampleType":"generated"},"ef2bbb44-1d61-400c-af91-a27b3dc99a53":{"description":"This functionality is not implemented.","content":{"application/json":{"schema":{"type":"object","properties":{"statusCode":{"type":"number","description":"HTTP status code","example":501,"isRequired":true,"uniqueKey":"statusCode","typeLabel":"number"},"message":{"type":"string","description":"Error message","example":"Not Implemented","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"timestamp":{"type":"string","description":"Timestamp when the error occurred","example":"2023-05-30T00:00:00.000Z","format":"date-time","isRequired":true,"uniqueKey":"timestamp","typeLabel":"string\u003cdate-time>"}},"required":["statusCode","message","timestamp"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"statusCode":501,"message":"Not Implemented","timestamp":"2023-05-30T00:00:00.000Z"}}},"exampleType":"generated"}},"exampleType":"generated"},"f88c1fa2-588a-4f92-87bd-a241711a8275":{"description":"Bad gateway error.","content":{"application/json":{"schema":{"type":"object","properties":{"statusCode":{"type":"number","description":"HTTP status code","example":502,"isRequired":true,"uniqueKey":"statusCode","typeLabel":"number"},"message":{"type":"string","description":"Error message","example":"Bad Gateway","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"timestamp":{"type":"string","description":"Timestamp when the error occurred","example":"2023-05-30T00:00:00.000Z","format":"date-time","isRequired":true,"uniqueKey":"timestamp","typeLabel":"string\u003cdate-time>"}},"required":["statusCode","message","timestamp"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"statusCode":502,"message":"Bad Gateway","timestamp":"2023-05-30T00:00:00.000Z"}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"8ac553bb-f5b8-48db-9f18-2e0a1d9ceacc":{"basic":{"type":"http","scheme":"basic","scopes":[],"schemeName":"basic"}}},"servers":{"c71b036b-c486-4ced-aa78-f1e13844d595":{"url":"https://api.stackone.com"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"basic","scopes":[],"schemeName":"basic"},"schema":{"title":"Basic Auth","type":"object","description":"Basic authentication header of the form `Basic \u003cencoded-value>`, where `\u003cencoded-value>` is the base64-encoded string `username:password`.","isRequired":true,"properties":{"username":{"type":"string","uniqueKey":"username","isRequired":true,"typeLabel":"string","deprecated":false},"password":{"type":"string","uniqueKey":"password","isRequired":true,"typeLabel":"string","deprecated":false}},"additionalProperties":false,"deprecated":false},"schemeName":"basic","name":"Authorization"}],"title":"basic"}]},"originalFileLocation":"platform/api-reference/platform.json"},"subdomain":"stackone-60","siteName":"Stackone","title":"Get Connect Session - Stackone","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-08-27T12:59:04.201Z","originalFileLocation":"platform/api-reference/connect-sessions/get-connect-session.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=\"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=\"description\" content=\"Returns a connect session and the state of its most recent connection attempt.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Stackone\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/stackone-60/vUkZo0TYnLvO23Z1/_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/stackone-60/vUkZo0TYnLvO23Z1/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/stackone-60/vUkZo0TYnLvO23Z1/_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/stackone-60/vUkZo0TYnLvO23Z1/_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/stackone-60/vUkZo0TYnLvO23Z1/_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/stackone-60/vUkZo0TYnLvO23Z1/_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/stackone-60/vUkZo0TYnLvO23Z1/_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/stackone-60/vUkZo0TYnLvO23Z1/_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/stackone-60/vUkZo0TYnLvO23Z1/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Get Connect Session - Stackone\">\u003cmeta data-mint-head property=\"og:description\" content=\"Returns a connect session and the state of its most recent connection attempt.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Stackone\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.stackone.com/platform/api-reference/connect-sessions/get-connect-session\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://stackone-60.mintlify.site/_mintlify/api/og/v2?division=Connect+Sessions\u0026amp;title=Get+Connect+Session\u0026amp;description=Returns+a+connect+session+and+the+state+of+its+most+recent+connection+attempt.\u0026amp;theme=26a0c4b0d3b33d43a09092cd\u0026amp;signature=c5c02cca85333528a2472036300c4799fe0d78acc7e89e6d734e26913cbe2b3c\">\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 Connect Session - Stackone\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Returns a connect session and the state of its most recent connection attempt.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://stackone-60.mintlify.site/_mintlify/api/og/v2?division=Connect+Sessions\u0026amp;title=Get+Connect+Session\u0026amp;description=Returns+a+connect+session+and+the+state+of+its+most+recent+connection+attempt.\u0026amp;theme=26a0c4b0d3b33d43a09092cd\u0026amp;signature=c5c02cca85333528a2472036300c4799fe0d78acc7e89e6d734e26913cbe2b3c\">\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/stackone-60/vUkZo0TYnLvO23Z1/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Stackone\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#068F56\">\u003cmeta data-mint-head name=\"google-site-verification\" content=\"gYj1x4gkdSwpCGVLFVXNVOPQ_wVrePW37ZKJt3HEqys\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.stackone.com/platform/api-reference/connect-sessions/get-connect-session\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/platform/api-reference/connect-sessions/get-connect-session.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.stackone.com/#organization\",\"name\":\"Stackone\",\"url\":\"https://docs.stackone.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/stackone-60/WsmKpuoeBZmio9QO/images/logo/logo-light-mode.svg?fit=max\u0026auto=format\u0026n=WsmKpuoeBZmio9QO\u0026q=85\u0026s=f08be9c0a142cb1e7fcaa23910c4bf7f\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.stackone.com#website\",\"name\":\"Stackone\",\"url\":\"https://docs.stackone.com\",\"publisher\":{\"@id\":\"https://docs.stackone.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.stackone.com/platform/api-reference/connect-sessions/get-connect-session#webpage\",\"url\":\"https://docs.stackone.com/platform/api-reference/connect-sessions/get-connect-session\",\"name\":\"Get Connect Session\",\"description\":\"Returns a connect session and the state of its most recent connection attempt.\",\"dateModified\":\"2026-08-27T12:59:04.201Z\",\"isPartOf\":{\"@id\":\"https://docs.stackone.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.stackone.com/platform/api-reference/connect-sessions/get-connect-session#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.stackone.com/platform/api-reference/connect-sessions/get-connect-session#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Connect Sessions\",\"item\":\"https://docs.stackone.com/platform/api-reference/connect-sessions/create-connect-session\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Get Connect Session\",\"item\":\"https://docs.stackone.com/platform/api-reference/connect-sessions/get-connect-session\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.stackone.com/platform/api-reference/connect-sessions/get-connect-session#apireference\",\"headline\":\"Get Connect Session\",\"name\":\"Get Connect Session\",\"description\":\"Returns a connect session and the state of its most recent connection attempt.\",\"url\":\"https://docs.stackone.com/platform/api-reference/connect-sessions/get-connect-session\",\"mainEntityOfPage\":{\"@id\":\"https://docs.stackone.com/platform/api-reference/connect-sessions/get-connect-session#webpage\"},\"dateModified\":\"2026-08-27T12:59:04.201Z\",\"publisher\":{\"@id\":\"https://docs.stackone.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.stackone.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Stackone\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Stackone\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/platform/api-reference/connect-sessions/get-connect-session.md","siteName":"Stackone","nav":{"global":null,"tabs":[{"tab":"Gateway","icon":"rocket","pages":[{"title":"Gateway","href":"/introduction"}]},{"tab":"Connectors","icon":"plug","pages":[{"title":"Connectors","href":"/connectors/introduction"}]},{"tab":"Embed","icon":"cube","pages":[{"title":"Embed","href":"/embed/overview"}]},{"tab":"Platform API","icon":"code","groups":[{"group":"Overview","root":{"title":"Platform API Reference","href":"/platform-api/overview"},"expanded":true,"pages":[{"title":"Authentication","sidebarTitle":"Authentication","href":"/platform-api/authentication"},{"group":"Request Parameters","pages":[{"title":"Pagination","href":"/platform-api/request-parameters/pagination"},{"title":"Filtering","href":"/platform-api/request-parameters/filtering"},{"title":"Expanding Fields","href":"/platform-api/request-parameters/expanding-fields"}]},{"title":"Rate Limiting","href":"/platform-api/rate-limiting"},{"title":"Platform Events","sidebarTitle":"Platform Events","href":"/platform-api/platform-events"},{"title":"API SDKs","href":"/platform-api/api-sdks"}]},{"group":"Accounts","icon":"users","expanded":true,"pages":[{"openapi":"get /v2/accounts","title":"List accounts","href":"/platform/api-reference/v2/accounts/list-accounts"},{"openapi":"get /v2/accounts/filters","title":"List account filter values","href":"/platform/api-reference/v2/accounts/list-account-filter-values"},{"openapi":"get /v2/accounts/{id}","title":"Get an account","href":"/platform/api-reference/v2/accounts/get-an-account"},{"openapi":"patch /v2/accounts/{id}","title":"Patch an account","href":"/platform/api-reference/v2/accounts/patch-an-account"},{"openapi":"delete /v2/accounts/{id}","title":"Delete an account","href":"/platform/api-reference/v2/accounts/delete-an-account"}]},{"group":"Actions","icon":"bolt","expanded":true,"pages":[{"openapi":"post /actions/search","title":"Search connector actions by semantic similarity","href":"/platform/api-reference/actions/search-connector-actions-by-semantic-similarity"},{"openapi":"post /actions/rpc","title":"Make an RPC call to an action","href":"/platform/api-reference/actions/make-an-rpc-call-to-an-action"},{"openapi":"post /actions/rpc/synced","title":"Read synced action data from the datasync index","href":"/platform/api-reference/actions/read-synced-action-data-from-the-datasync-index"},{"openapi":"post /actions/rpc/synced/queryable_fields","title":"List the fields a synced action's data can be queried by","href":"/platform/api-reference/actions/list-the-fields-a-synced-actions-data-can-be-queried-by"},{"openapi":"post /unified/check_permissions","title":"Check user permissions on a resource","href":"/platform/api-reference/actions/check-user-permissions-on-a-resource"}]},{"group":"Connect Sessions","icon":"link","expanded":true,"pages":[{"openapi":"post /connect_sessions","title":"Create Connect Session","description":"Creates a short-lived connect session and returns the token and auth link that open the account-linking flow for one end-user.","href":"/platform/api-reference/connect-sessions/create-connect-session"},{"openapi":"get /connect_sessions/{id}","title":"Get Connect Session","href":"/platform/api-reference/connect-sessions/get-connect-session"},{"openapi":"post /connect_sessions/authenticate","title":"Authenticate Connect Session","description":"Exchanges a connect session token for the session it belongs to.","href":"/platform/api-reference/connect-sessions/authenticate-connect-session"}]},{"group":"Connector Profiles","icon":"sliders","expanded":true,"pages":[{"openapi":"get /v2/connector_profiles","title":"List connector profiles","href":"/platform/api-reference/v2/connector-profiles/list-connector-profiles"},{"openapi":"get /v2/connector_profiles/{id}","title":"Get a connector profile","href":"/platform/api-reference/v2/connector-profiles/get-a-connector-profile"},{"openapi":"post /v2/connector_profiles","title":"Create a connector profile","href":"/platform/api-reference/v2/connector-profiles/create-a-connector-profile"},{"openapi":"patch /v2/connector_profiles/{id}","title":"Patch a connector profile","href":"/platform/api-reference/v2/connector-profiles/patch-a-connector-profile"},{"openapi":"delete /v2/connector_profiles/{id}","title":"Delete a connector profile","href":"/platform/api-reference/v2/connector-profiles/delete-a-connector-profile"}]},{"group":"Connectors","icon":"puzzle-piece","expanded":true,"pages":[{"openapi":"get /v2/connectors","title":"List connectors","href":"/platform/api-reference/v2/connectors/list-connectors"},{"openapi":"get /v2/connectors/{id}","title":"Get connector","href":"/platform/api-reference/v2/connectors/get-connector"},{"openapi":"get /v2/connectors/{id}/actions/{actionId}","title":"Get connector action","href":"/platform/api-reference/v2/connectors/get-connector-action"},{"openapi":"get /v2/connectors/{id}/event_actions/{eventId}","title":"Get connector event action","href":"/platform/api-reference/v2/connectors/get-connector-event-action"},{"openapi":"get /v2/connectors/{id}/versions","title":"List connector versions","href":"/platform/api-reference/v2/connectors/list-connector-versions"},{"openapi":"post /v2/connectors","title":"Create a connector","href":"/platform/api-reference/v2/connectors/create-a-connector"},{"openapi":"post /v2/connectors/{id}/action_refreshes","title":"Create a connector action refresh","href":"/platform/api-reference/v2/connectors/create-a-connector-action-refresh"},{"openapi":"delete /v2/connectors/{id}","title":"Delete a connector","href":"/platform/api-reference/v2/connectors/delete-a-connector"}]},{"group":"Data Sync","icon":"rotate","expanded":true,"pages":[{"group":"Sync Configs","expanded":true,"pages":[{"openapi":"get /v2/data_sync/sync_configs","title":"List sync configs","href":"/platform/api-reference/v2/data-sync/list-sync-configs"},{"openapi":"get /v2/data_sync/sync_configs/{id}","title":"Get a sync config","href":"/platform/api-reference/v2/data-sync/get-a-sync-config"},{"openapi":"get /v2/data_sync/sync_configs/{id}/parameters","title":"Get a sync config action's parameters","href":"/platform/api-reference/v2/data-sync/get-a-sync-config-actions-parameters"},{"openapi":"post /v2/data_sync/sync_configs","title":"Create a sync config","href":"/platform/api-reference/v2/data-sync/create-a-sync-config"},{"openapi":"patch /v2/data_sync/sync_configs/{id}","title":"Patch a sync config","href":"/platform/api-reference/v2/data-sync/patch-a-sync-config"},{"openapi":"delete /v2/data_sync/sync_configs/{id}","title":"Delete a sync config","href":"/platform/api-reference/v2/data-sync/delete-a-sync-config"}]},{"group":"Schedules","expanded":true,"pages":[{"openapi":"get /v2/data_sync/schedules","title":"List schedules","href":"/platform/api-reference/v2/data-sync/list-schedules"},{"openapi":"get /v2/data_sync/schedules/{id}","title":"Get a schedule","href":"/platform/api-reference/v2/data-sync/get-a-schedule"},{"openapi":"patch /v2/data_sync/schedules/{id}","title":"Patch a schedule","href":"/platform/api-reference/v2/data-sync/patch-a-schedule"}]},{"group":"Runs","expanded":true,"pages":[{"openapi":"get /v2/data_sync/runs","title":"List runs","href":"/platform/api-reference/v2/data-sync/list-runs"},{"openapi":"get /v2/data_sync/runs/{id}","title":"Get a run","href":"/platform/api-reference/v2/data-sync/get-a-run"}]}]},{"group":"Logs","icon":"file-lines","expanded":true,"pages":[{"openapi":"post /logs","title":"List Logs","href":"/platform/api-reference/logs/list-logs"},{"openapi":"post /logs/platform","title":"List Platform Logs","href":"/platform/api-reference/logs/list-platform-logs"},{"openapi":"post /logs/provider","title":"List Provider Logs","href":"/platform/api-reference/logs/list-provider-logs"},{"group":"Action Logs","expanded":true,"pages":[{"openapi":"post /logs/actions","title":"List Action Logs","href":"/platform/api-reference/logs/list-action-logs"},{"openapi":"get /logs/actions/{actionRunId}","title":"Get Action Log","href":"/platform/api-reference/logs/get-action-log"},{"openapi":"get /logs/actions/{actionRunId}/advanced","title":"Get Action Advanced Log","href":"/platform/api-reference/logs/get-action-advanced-log"},{"openapi":"get /logs/actions/{actionRunId}/defender","title":"Get Action Defender Log","href":"/platform/api-reference/logs/get-action-defender-log"}]},{"group":"Step Logs","expanded":true,"pages":[{"openapi":"post /logs/steps","title":"List Step Logs","href":"/platform/api-reference/logs/list-step-logs"},{"openapi":"get /logs/actions/{actionRunId}/steps","title":"List Action Step Logs","href":"/platform/api-reference/logs/list-action-step-logs"},{"openapi":"get /logs/actions/{actionRunId}/steps/{stepIndex}","title":"Get Step Log","href":"/platform/api-reference/logs/get-step-log"},{"openapi":"get /logs/actions/{actionRunId}/steps/{stepIndex}/advanced","title":"Get Step Advanced Log","href":"/platform/api-reference/logs/get-step-advanced-log"}]},{"group":"Stats","expanded":true,"pages":[{"openapi":"post /logs/stats/aggregate","title":"Get Logs Stats Aggregate","href":"/platform/api-reference/logs/get-logs-stats-aggregate"},{"openapi":"post /logs/stats/dimensions","title":"Get Logs Stats Dimensions","href":"/platform/api-reference/logs/get-logs-stats-dimensions"}]}]},{"group":"MCP","icon":"plug","expanded":true,"pages":[{"openapi":"post /mcp","title":"Send MCP JSON-RPC message","href":"/platform/api-reference/mcp/send-mcp-json-rpc-message"}]},{"group":"Webhooks","icon":"webhook","expanded":true,"pages":[{"openapi":"get /v2/webhooks","title":"List webhooks","href":"/platform/api-reference/v2/webhooks/list-webhooks"},{"openapi":"get /v2/webhooks/{id}","title":"Get a webhook","href":"/platform/api-reference/v2/webhooks/get-a-webhook"},{"openapi":"post /v2/webhooks","title":"Create a webhook","href":"/platform/api-reference/v2/webhooks/create-a-webhook"},{"openapi":"patch /v2/webhooks/{id}","title":"Update a webhook","href":"/platform/api-reference/v2/webhooks/update-a-webhook"},{"openapi":"delete /v2/webhooks/{id}","title":"Delete a webhook","href":"/platform/api-reference/v2/webhooks/delete-a-webhook"},{"openapi":"post /v2/webhooks/events","title":"Send webhook events","href":"/platform/api-reference/v2/webhooks/send-webhook-events"}]}]}]},"basePath":"","title":"Get Connect Session - Stackone","buildId":"dpl_DqYu5MPb49gWBBbUGgpHQUmCHY3P","deploymentId":"dpl_DqYu5MPb49gWBBbUGgpHQUmCHY3P","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-CybtLBIt.js","utils-BMLj2fvV.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-B6In562Y.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-Dr8Mfhp9.js","snippetPresets-2rmQvMVl.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-WMqJYdZj.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-CJ-MlPHu.js","shallow-dY3TMRCk.js","getApiPlaygroundDisplay-v-1B2bKm.js","CodeSnippet-BDhiTB7U.js","CodeSnippets-D9hnzQcS.js","Page-C4GwDT3_.js","getPastedJson-Th2V45jI.js","icon-BQXch1W9.js","MethodPill-BCqUneP3.js","DuplicateIcon-Q_-bhurZ.js","createIcon-DUjLHRqp.js","DynamicMarkdown-B-f2cqXQ.js","SectionHeading-Da5NsV4v.js","axios-vUo_bRtp.js","Markdown-D13FWkIM.js","clsx-D3Isdib3.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-C-XZBk9h.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink--qIqmmVG.js"]}