To get a user’s connected accounts, use List user accounts. It is the fastest way to retrieve account details and credentials for one user. It returns up to 100 accounts, and you can filter by app.
To retrieve credentials for OAuth apps (Slack, Google Sheets, etc), the connected account must be using your own OAuth client.
The credentials associated with the account, if the include_credentials parameter was set to true in the request (only applicable for BYOA apps). In addition to the well-known OAuth fields listed below, this object may contain app-specific custom fields (e.g. base_url).
The date and time the account will next be refreshed, an ISO 8601 formatted string
Was this page helpful?
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Pipedream","colors":{"primary":"#095c32","light":"#19f995","dark":"#0f9954"},"logo":{"light":"https://mintcdn.com/pipedream/J-J7n6QGsUEW1AZY/logo/pipedream_workday_lockup.png?fit=max\u0026auto=format\u0026n=J-J7n6QGsUEW1AZY\u0026q=85\u0026s=20f01e899a0e49424e3d16d1e84adc60","dark":"https://mintcdn.com/pipedream/J-J7n6QGsUEW1AZY/logo/pipedream_workday_lockup_dark.png?fit=max\u0026auto=format\u0026n=J-J7n6QGsUEW1AZY\u0026q=85\u0026s=cc9220550d73764499689dbac60a3615","href":"https://pipedream.com/docs"},"favicon":"https://mintcdn.com/pipedream/l2pOewTBZm3Zi3d2/logo/pipedream_icon.svg?fit=max\u0026auto=format\u0026n=l2pOewTBZm3Zi3d2\u0026q=85\u0026s=561dca46a7ea8017f3146eb1899554a6","api":{"playground":{"display":"interactive"},"examples":{"defaults":"all","languages":["curl","typescript","python","java","go"]},"mdx":{"auth":{"method":"bearer"},"server":"https://api.pipedream.com/v1"}},"appearance":{"default":"system"},"background":{"decoration":"grid"},"navbar":{"links":[{"icon":"slack","href":"https://pipedream.com/join-slack","label":"Join community"}],"primary":{"type":"button","label":"Sign up for free","href":"https://pipedream.com/auth/signup"}},"footer":{"socials":{"github":"https://github.com/PipedreamHQ/pipedream","twitter":"https://twitter.com/pipedream","slack":"https://pipedream.com/join-slack"}},"seo":{"metatags":{"robots":"index, follow","charset":"UTF-8","viewport":"width=device-width, initial-scale=1.0","description":"Pipedream provides the toolkit to add thousands of integrations to your app and enables you to automate any process.","keywords":"api, mcp, ai, integrations, pipedream, workflow, automation, connect, apis","author":"Pipedream","googlebot":"index, follow","language":"en","og:type":"website","og:url":"https://pipedream.com","og:description":"Pipedream provides the toolkit to add thousands of integrations to your app and enables you to automate any process.","og:site_name":"Pipedream","og:locale":"en_US","twitter:card":"summary","twitter:site":"@pipedream","twitter:creator":"@pipedream","twitter:title":"Pipedream","twitter:description":"Pipedream provides the toolkit to add thousands of integrations to your app and enables you to automate any process.","twitter:image":"https://pipedream.com/image.jpg","twitter:image:alt":"Pipedream Logo","canonical":"https://pipedream.com/docs"}},"fonts":{"family":"Geist Sans","source":"https://cdn.jsdelivr.net/npm/geist@1.3.1/dist/fonts/geist-sans/Geist-Variable.woff2","format":"woff2"},"styling":{"eyebrows":"breadcrumbs","latex":false},"contextual":{"options":["copy","view","chatgpt","claude","mcp"],"display":"header"},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"pipedream","hasAudioNarration":false,"actualSubdomain":"pipedream","customDomains":["pipedream.com"],"gitSource":{"_id":"6ad7fa91692c7c940ff17a0e","type":"github","owner":"pipedreamhq","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true,"agentFeedback":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"REMOVE_BRANDING":{"status":"ENABLED"},"CONTEXTUAL_FEEDBACK":{"status":"ENABLED"},"CODE_SNIPPET_FEEDBACK":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6aeec9ad0a8f67c3b927e879","clientVersion":"0.0.4087","searchFilterCounts":[{"language":"default","tag":"Connect","count":218},{"language":"default","tag":"Documentation","count":126},{"language":"default","tag":"Conduit","count":77},{"language":"default","tag":"Connect API","count":63},{"language":"default","tag":"Workflows","count":62},{"language":"default","tag":"Guides","count":41},{"language":"default","tag":"Building Workflows","count":39},{"language":"default","tag":"API","count":35},{"language":"default","tag":"Write your own code","count":22},{"language":"default","tag":"Platform","count":21}]},"assistantConfig":{"enableStarterQuestions":true,"deflection":{"enabled":true,"email":"support@pipedream.com"}},"basePath":"/docs","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"comment-mode","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"starterQuestions":[{"_id":"68eabbe039150a938c8e901c","deploymentId":"6852099e30dd5c4192fd61e1","questionText":"How do I get started with Pipedream Connect?","status":"active","generatedBy":"manual","createdAt":"2025-10-11T20:19:44.842Z","updatedAt":"2025-10-11T20:19:44.842Z","__v":0}],"googleFontsInlined":false},"customCss":[{"filePath":"styles/custom.css","content":"#banner{min-height:64px;display:flex;align-items:center;justify-content:center;gap:10px;padding:12px 24px;position:relative;background-color:rgba(239, 246, 255, 0.9)!important;border-top:1px solid rgb(191, 219, 254);border-bottom:1px solid rgb(191, 219, 254);box-shadow:0 1px 2px rgba(15, 23, 42, 0.08);transition:all 0.5s ease-out}:is(html.dark,body.dark) #banner{background-color:rgb(15, 23, 42)!important;border-top-color:rgb(51, 65, 85);border-bottom-color:rgb(51, 65, 85)}@media (max-width: 639px){#banner{flex-direction:row;align-items:center;gap:6px;padding:10px 10px}#banner::before{flex:0 0 auto;margin-right:2px}}#banner::before{content:\"\";width:120px;height:28px;background-image:url(\"https://pipedream.com/docs/images/wday_logo_no-TM_primary-RGB.svg\");background-size:contain;background-repeat:no-repeat;background-position:center;flex:0 0 auto}:is(html.dark,body.dark) #banner::before{background-image:url(\"https://pipedream.com/docs/images/wday_logo_no-TM_reversed-RGB.svg\")}@media (max-width: 639px){#banner::before{width:100px;height:24px}}#banner button{position:absolute;right:20px;top:50%;transform:translateY(-50%);padding:6px;border-radius:999px;color:rgb(37, 99, 235)!important;background:transparent;transition:color 0.2s ease, background-color 0.2s ease}#banner button svg{color:inherit;stroke:currentColor}#banner button:hover{background-color:rgba(191, 219, 254, 0.4);color:rgb(29, 78, 216)!important}:is(html.dark,body.dark) #banner button{color:rgb(191, 219, 254)!important}:is(html.dark,body.dark) #banner button:hover{background-color:rgba(51, 65, 85, 0.6);color:rgb(226, 232, 240)!important}@media (max-width: 639px){#banner button{top:12px;right:12px;transform:none}}#banner>div,#banner>div>p{display:flex!important;align-items:center;justify-content:center;flex-wrap:wrap;gap:6px;text-align:center;max-width:720px}#banner p{display:inline;margin:0}@media (max-width: 639px){#banner>div{width:100%;max-width:none;flex-direction:column;align-items:flex-start;justify-content:flex-start;gap:2px;text-align:left}#banner>div>p{display:block!important;width:100%;text-align:left}#banner p,#banner strong{text-align:left;line-height:1.3}}#banner,#banner *,#banner p,#banner strong,#banner p strong{color:rgb(71, 85, 105)!important;font-weight:500;font-size:1rem}#banner p strong{font-weight:500}:is(html.dark,body.dark) #banner,:is(html.dark,body.dark) #banner *,:is(html.dark,body.dark) #banner p,:is(html.dark,body.dark) #banner strong,:is(html.dark,body.dark) #banner p strong{color:rgb(219, 234, 254)!important}@media (min-width: 640px){#banner strong,#banner p strong{font-size:1.125rem}}#banner a[href*=\"newsroom.workday.com\"]:nth-of-type(1){display:inline-flex!important;align-items:center;justify-content:center;padding:8px 16px;height:36px;background-color:rgb(59, 130, 246);color:white!important;border-radius:6px;text-decoration:none!important;font-weight:500;font-size:1rem;transition:background-color 0.2s ease;margin-left:36px;flex-shrink:0;white-space:nowrap;box-shadow:0 1px 2px rgba(15, 23, 42, 0.12)}#banner a[href*=\"newsroom.workday.com\"]:nth-of-type(1):hover{background-color:rgb(29, 78, 216)}:is(html.dark,body.dark) #banner a[href*=\"newsroom.workday.com\"]:nth-of-type(1){background-color:rgb(59, 130, 246)}:is(html.dark,body.dark) #banner a[href*=\"newsroom.workday.com\"]:nth-of-type(1):hover{background-color:rgb(37, 99, 235)}@media (max-width: 639px){#banner a[href*=\"newsroom.workday.com\"]:nth-of-type(1){display:inline!important;align-self:flex-start;padding:0;height:auto;margin-left:0;background-color:transparent;color:rgb(37, 99, 235)!important;text-decoration:underline;text-decoration-thickness:1px;border-radius:0;box-shadow:none;white-space:normal}#banner a[href*=\"newsroom.workday.com\"]:nth-of-type(1):hover{background-color:transparent}}#banner-content{display:flex;align-items:center;gap:8px;flex-wrap:wrap;justify-content:center;text-align:center}.nav-logo{height:2.5rem}"}],"page":{"pagePath":"connect/api-reference/retrieve-account","slug":"/connect/api-reference/retrieve-account","pageMetadata":{"openapi":"get /v1/connect/{project_id}/accounts/{account_id}","title":"Retrieve account","description":"Get the details for a specific connected account","href":"/connect/api-reference/retrieve-account"},"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: \"Get the details for a specific connected account\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,p:`p`,strong:`strong`,..._provideComponents(),...props.components},{Note,Tip,Warning}=_components;if(!Note)_missingMdxReference(`Note`,true);if(!Tip)_missingMdxReference(`Tip`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsx(Tip,{children:_jsxs(_components.p,{children:[`To get a user’s connected accounts, use `,_jsx(_components.a,{href:`/connect/api-reference/list-accounts-for-external-user`,children:`List user accounts`}),`. It is the fastest way to retrieve account details and credentials for one user. It returns up to 100 accounts, and you can filter by app.`]})}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`To retrieve credentials for OAuth apps (Slack, Google Sheets, etc), `,_jsxs(_components.strong,{children:[`the connected account must be using `,_jsx(_components.a,{href:`/connect/managed-auth/oauth-clients/#using-a-custom-oauth-client`,children:`your own OAuth client`})]}),`.`]})}),`\n`,_jsx(Warning,{children:_jsx(_components.p,{children:`Never return user credentials to the client`})})]})}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":{"openapi":"get /v1/connect/{project_id}/accounts/{account_id}","title":"Retrieve account","description":"Get the details for a specific connected account","href":"/connect/api-reference/retrieve-account"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"summary":"Retrieve account","description":"Get the details for a specific connected account","parameters":["781210b4-4f73-4218-88e5-3e52b442bbd8","5daa97b8-80f1-443e-a515-65b551eb41cb"],"operationId":"retrieveAccount","x-fern-sdk-group-name":"accounts","x-fern-sdk-method-name":"retrieve","security":["ec134d3b-f0ba-4520-ae02-9bef4e14cd15","5712dde6-72b8-4c01-ac04-e153742e3c69"],"responses":{"200":"c6394b83-dbc8-486f-90a3-3a35ce808ff6","429":"55fd3cdc-8f63-451e-9035-5e045f2aef77"},"x-codeSamples":[{"lang":"java","label":"Java SDK","source":"package com.example.usage;\n\nimport com.pipedream.api.BaseClient;\nimport com.pipedream.api.resources.accounts.requests.AccountsRetrieveRequest;\n\npublic class Example {\n public static void main(String[] args) {\n BaseClient client = BaseClient.withCredentials(\"\u003cclientId>\", \"\u003cclientSecret>\")\n .projectId(\"YOUR_PROJECT_ID\")\n .build()\n ;\n\n client.accounts().retrieve(\n \"account_id\",\n AccountsRetrieveRequest\n .builder()\n .includeCredentials(true)\n .build()\n );\n }\n}\n"},{"lang":"python","label":"Python SDK","source":"from pipedream import Pipedream\n\nclient = Pipedream(\n project_id=\"YOUR_PROJECT_ID\",\n client_id=\"YOUR_CLIENT_ID\",\n client_secret=\"YOUR_CLIENT_SECRET\",\n)\nclient.accounts.retrieve(\n account_id=\"account_id\",\n include_credentials=True,\n)\n"},{"lang":"typescript","label":"TypeScript SDK","source":"import { PipedreamClient } from \"@pipedream/sdk\";\n\nconst client = new PipedreamClient({\n clientId: \"YOUR_CLIENT_ID\",\n clientSecret: \"YOUR_CLIENT_SECRET\",\n projectEnvironment: \"YOUR_PROJECT_ENVIRONMENT\",\n projectId: \"YOUR_PROJECT_ID\"\n});\nawait client.accounts.retrieve(\"account_id\", {\n includeCredentials: true\n});\n"}],"method":"get","type":"path","servers":["94d370e2-2341-427f-9133-eaddb7c7a172"],"path":"/v1/connect/{project_id}/accounts/{account_id}","baseUrlOptions":["https://api.pipedream.com"],"title":"Retrieve account","codeSamples":[{"label":"Java SDK","lang":"java","source":"package com.example.usage;\n\nimport com.pipedream.api.BaseClient;\nimport com.pipedream.api.resources.accounts.requests.AccountsRetrieveRequest;\n\npublic class Example {\n public static void main(String[] args) {\n BaseClient client = BaseClient.withCredentials(\"\u003cclientId>\", \"\u003cclientSecret>\")\n .projectId(\"YOUR_PROJECT_ID\")\n .build()\n ;\n\n client.accounts().retrieve(\n \"account_id\",\n AccountsRetrieveRequest\n .builder()\n .includeCredentials(true)\n .build()\n );\n }\n}\n"},{"label":"Python SDK","lang":"python","source":"from pipedream import Pipedream\n\nclient = Pipedream(\n project_id=\"YOUR_PROJECT_ID\",\n client_id=\"YOUR_CLIENT_ID\",\n client_secret=\"YOUR_CLIENT_SECRET\",\n)\nclient.accounts.retrieve(\n account_id=\"account_id\",\n include_credentials=True,\n)\n"},{"label":"TypeScript SDK","lang":"typescript","source":"import { PipedreamClient } from \"@pipedream/sdk\";\n\nconst client = new PipedreamClient({\n clientId: \"YOUR_CLIENT_ID\",\n clientSecret: \"YOUR_CLIENT_SECRET\",\n projectEnvironment: \"YOUR_PROJECT_ENVIRONMENT\",\n projectId: \"YOUR_PROJECT_ID\"\n});\nawait client.accounts.retrieve(\"account_id\", {\n includeCredentials: true\n});\n"}],"requestExampleLanguages":["bash","typescript","python","java","go"],"requiredOnlyExamples":false,"requestExampleType":"codeSamples","responseExampleType":"generated"},"dependencies":{"parameters":{"781210b4-4f73-4218-88e5-3e52b442bbd8":{"name":"x-pd-environment","in":"header","required":true,"description":"The environment in which the server client is running","schema":{"type":"string","description":"The environment in which the server client is running","enum":["development","production"],"isRequired":true,"uniqueKey":"","typeLabel":"enum\u003cstring>"}},"5daa97b8-80f1-443e-a515-65b551eb41cb":{"name":"include_credentials","in":"query","description":"Whether to retrieve the account's credentials or not","schema":{"type":"boolean","description":"Whether to retrieve the account's credentials or not","uniqueKey":"","typeLabel":"boolean"}},"22140c21-c36f-4760-beca-11620b71f771":{"name":"project_id","in":"path","required":true,"description":"The project ID, which starts with `proj_`.","schema":{"type":"string","pattern":"^proj_[a-zA-Z0-9]+$","isRequired":true,"description":"The project ID, which starts with `proj_`.","uniqueKey":"","typeLabel":"string"},"x-fern-sdk-variable":"project_id"},"936b6383-6a9c-4c9d-9cf2-3bf0dde2cc5f":{"name":"account_id","in":"path","required":true,"schema":{"type":"string","isRequired":true,"uniqueKey":"","typeLabel":"string"}}},"responses":{"c6394b83-dbc8-486f-90a3-3a35ce808ff6":{"description":"account retrieved","content":{"application/json":{"schema":{"type":"object","description":"End user account data, returned from the API.","required":["id"],"properties":{"id":{"type":"string","description":"The unique ID of the account.","pattern":"^apn_[a-zA-Z0-9]+$","isRequired":true,"uniqueKey":"id","typeLabel":"string"},"name":{"oneOf":[{"type":"string","description":"The custom name of the account if set.","uniqueKey":"name.oneOf.0","typeLabel":"string"},{"type":"null","description":"The custom name of the account if set.","uniqueKey":"name.oneOf.1","typeLabel":"null"}],"uniqueKey":"name","typeLabel":"string | null"},"external_id":{"type":"string","description":"The external ID associated with the account.","uniqueKey":"external_id","typeLabel":"string"},"healthy":{"type":"boolean","description":"Indicates if the account is healthy. Pipedream will periodically retry token refresh and test requests for unhealthy accounts","uniqueKey":"healthy","typeLabel":"boolean"},"dead":{"oneOf":[{"type":"boolean","description":"Indicates if the account is no longer active","uniqueKey":"dead.oneOf.0","typeLabel":"boolean"},{"type":"null","description":"Indicates if the account is no longer active","uniqueKey":"dead.oneOf.1","typeLabel":"null"}],"uniqueKey":"dead","typeLabel":"boolean | null"},"app":{"type":"object","description":"Response object for a Pipedream app's metadata","required":["name_slug","name","img_src","custom_fields_json","categories","featured_weight","scope_profiles"],"properties":{"name_slug":{"type":"string","description":"The name slug of the target app (see https://pipedream.com/docs/connect/quickstart#find-your-apps-name-slug)","isRequired":true,"uniqueKey":"app.name_slug","typeLabel":"string"},"name":{"type":"string","description":"The human-readable name of the app","isRequired":true,"uniqueKey":"app.name","typeLabel":"string"},"img_src":{"type":"string","description":"The URL to the app's logo","isRequired":true,"uniqueKey":"app.img_src","typeLabel":"string"},"custom_fields_json":{"oneOf":[{"type":"string","description":"A JSON string representing the custom fields for the app","isRequired":true,"uniqueKey":"app.custom_fields_json.oneOf.0","typeLabel":"string"},{"type":"null","description":"A JSON string representing the custom fields for the app","isRequired":true,"uniqueKey":"app.custom_fields_json.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"app.custom_fields_json","typeLabel":"string | null"},"categories":{"type":"array","items":{"type":"string","uniqueKey":"app.categories.items.[INDEX]","typeLabel":"string"},"description":"Categories associated with the app","isRequired":true,"uniqueKey":"app.categories","typeLabel":"string[]"},"featured_weight":{"type":"number","description":"A rough directional ordering of app popularity, subject to changes by Pipedream","isRequired":true,"uniqueKey":"app.featured_weight","typeLabel":"number"},"scope_profiles":{"type":"array","description":"Named subsets of the app's OAuth scopes that may be requested when users connect their accounts (via the `oauth_scope_profile` parameter). Empty for apps that don't define any.","items":{"type":"object","required":["name","scopes"],"properties":{"name":{"type":"string","enum":["read_only","read_write","admin"],"description":"The profile name. Pass this back as `oauth_scope_profile` when starting the OAuth flow for this app.","isRequired":true,"uniqueKey":"app.scope_profiles.items.[INDEX].name","typeLabel":"enum\u003cstring>"},"scopes":{"type":"array","items":{"type":"string","uniqueKey":"app.scope_profiles.items.[INDEX].scopes.items.[INDEX]","typeLabel":"string"},"description":"The actual OAuth scopes of the upstream API that the user will be asked to authorize when this profile is selected.","isRequired":true,"uniqueKey":"app.scope_profiles.items.[INDEX].scopes","typeLabel":"string[]"}},"uniqueKey":"app.scope_profiles.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"app.scope_profiles","typeLabel":"object[]"},"id":{"oneOf":[{"type":"string","description":"ID of the app. Only applies for OAuth apps.","uniqueKey":"app.id.oneOf.0","typeLabel":"string"},{"type":"null","description":"ID of the app. Only applies for OAuth apps.","uniqueKey":"app.id.oneOf.1","typeLabel":"null"}],"uniqueKey":"app.id","typeLabel":"string | null"},"auth_type":{"oneOf":[{"type":"string","enum":["keys","oauth","none"],"description":"The authentication type used by the app","uniqueKey":"app.auth_type.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","enum":["keys","oauth","none"],"description":"The authentication type used by the app","uniqueKey":"app.auth_type.oneOf.1","typeLabel":"null"}],"uniqueKey":"app.auth_type","typeLabel":"enum\u003cstring> | null"},"description":{"oneOf":[{"type":"string","description":"A short description of the app","uniqueKey":"app.description.oneOf.0","typeLabel":"string"},{"type":"null","description":"A short description of the app","uniqueKey":"app.description.oneOf.1","typeLabel":"null"}],"uniqueKey":"app.description","typeLabel":"string | null"},"oauth_app_id":{"oneOf":[{"type":"string","description":"ID of the app's Pipedream official OAuth client, or null if the app doesn't use OAuth or has no official client. Useful for retrieving the OAuth client's `client_id` and redirect URI with the Retrieve OAuth client endpoint.","uniqueKey":"app.oauth_app_id.oneOf.0","typeLabel":"string"},{"type":"null","description":"ID of the app's Pipedream official OAuth client, or null if the app doesn't use OAuth or has no official client. Useful for retrieving the OAuth client's `client_id` and redirect URI with the Retrieve OAuth client endpoint.","uniqueKey":"app.oauth_app_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"app.oauth_app_id","typeLabel":"string | null"},"scopes":{"oneOf":[{"type":"array","items":{"type":"string","uniqueKey":"app.scopes.oneOf.0.items.[INDEX]","typeLabel":"string"},"description":"The OAuth scopes requested when an account connects through this OAuth client, or, on an app, through the app's Pipedream official OAuth client and no `oauth_scope_profile`. `null` when the app doesn't use OAuth or has no official client. Absent when the app is embedded in another resource, such as an account.","uniqueKey":"app.scopes.oneOf.0","typeLabel":"string[]"},{"type":"null","items":{"type":"string"},"description":"The OAuth scopes requested when an account connects through this OAuth client, or, on an app, through the app's Pipedream official OAuth client and no `oauth_scope_profile`. `null` when the app doesn't use OAuth or has no official client. Absent when the app is embedded in another resource, such as an account.","uniqueKey":"app.scopes.oneOf.1","typeLabel":"null"}],"uniqueKey":"app.scopes","typeLabel":"string[] | null"},"additional_scopes":{"oneOf":[{"type":"array","items":{"type":"string","uniqueKey":"app.additional_scopes.oneOf.0.items.[INDEX]","typeLabel":"string"},"description":"A second list of scopes requested alongside `scopes`. The connection does not require the user to grant them. `scope_labels` names both lists. `null` when there are none, or when the app doesn't use OAuth or has no official client. Absent when the app is embedded in another resource, such as an account.","uniqueKey":"app.additional_scopes.oneOf.0","typeLabel":"string[]"},{"type":"null","items":{"type":"string"},"description":"A second list of scopes requested alongside `scopes`. The connection does not require the user to grant them. `scope_labels` names both lists. `null` when there are none, or when the app doesn't use OAuth or has no official client. Absent when the app is embedded in another resource, such as an account.","uniqueKey":"app.additional_scopes.oneOf.1","typeLabel":"null"}],"uniqueKey":"app.additional_scopes","typeLabel":"string[] | null"},"scope_labels":{"oneOf":[{"type":"object","required":["scopes","additional_scopes"],"description":"Display names for `scopes` and `additional_scopes`; their meaning depends on the app. `null` when the app doesn't use OAuth or has no official client. Absent when the app is embedded in another resource, such as an account.","properties":{"scopes":{"type":"string","description":"The display name of `scopes`. `Scopes` by default.","isRequired":true,"uniqueKey":"app.scope_labels.oneOf.0.scopes","typeLabel":"string"},"additional_scopes":{"type":"string","description":"The display name of `additional_scopes`. `Additional scopes` by default.","isRequired":true,"uniqueKey":"app.scope_labels.oneOf.0.additional_scopes","typeLabel":"string"}},"uniqueKey":"app.scope_labels.oneOf.0","typeLabel":"object"},{"type":"null","required":["scopes","additional_scopes"],"description":"Display names for `scopes` and `additional_scopes`; their meaning depends on the app. `null` when the app doesn't use OAuth or has no official client. Absent when the app is embedded in another resource, such as an account.","properties":{"scopes":{"type":"string","description":"The display name of `scopes`. `Scopes` by default."},"additional_scopes":{"type":"string","description":"The display name of `additional_scopes`. `Additional scopes` by default."}},"uniqueKey":"app.scope_labels.oneOf.1","typeLabel":"null"}],"uniqueKey":"app.scope_labels","typeLabel":"object | null"}},"uniqueKey":"app","typeLabel":"object"},"created_at":{"type":"string","description":"The date and time the account was created, an ISO 8601 formatted string","format":"date-time","uniqueKey":"created_at","typeLabel":"string\u003cdate-time>"},"updated_at":{"type":"string","description":"The date and time the account was last updated, an ISO 8601 formatted string","format":"date-time","uniqueKey":"updated_at","typeLabel":"string\u003cdate-time>"},"authorized_scopes":{"type":"array","items":{"type":"string","uniqueKey":"authorized_scopes.items.[INDEX]","typeLabel":"string"},"description":"The OAuth scopes effectively granted to this account. Empty for non-OAuth apps.","uniqueKey":"authorized_scopes","typeLabel":"string[]"},"credentials":{"oneOf":[{"type":"object","description":"The credentials associated with the account, if the `include_credentials` parameter was set to true in the request (only applicable for BYOA apps). In addition to the well-known OAuth fields listed below, this object may contain app-specific custom fields (e.g. `base_url`).","additionalProperties":true,"properties":{"oauth_client_id":{"type":"string","description":"The OAuth client ID for the app, if applicable","uniqueKey":"credentials.oneOf.0.oauth_client_id","typeLabel":"string"},"oauth_access_token":{"type":"string","description":"The OAuth access token","uniqueKey":"credentials.oneOf.0.oauth_access_token","typeLabel":"string"},"oauth_refresh_token":{"type":"string","description":"The OAuth refresh token","uniqueKey":"credentials.oneOf.0.oauth_refresh_token","typeLabel":"string"},"oauth_uid":{"type":"string","description":"The unique OAuth user identifier","uniqueKey":"credentials.oneOf.0.oauth_uid","typeLabel":"string"},"oauth_signer_uri":{"type":"string","description":"The OAuth signer URI, if the app uses a custom OAuth signer","uniqueKey":"credentials.oneOf.0.oauth_signer_uri","typeLabel":"string"}},"uniqueKey":"credentials.oneOf.0","typeLabel":"object"},{"type":"null","description":"The credentials associated with the account, if the `include_credentials` parameter was set to true in the request (only applicable for BYOA apps). In addition to the well-known OAuth fields listed below, this object may contain app-specific custom fields (e.g. `base_url`).","additionalProperties":true,"properties":{"oauth_client_id":{"type":"string","description":"The OAuth client ID for the app, if applicable"},"oauth_access_token":{"type":"string","description":"The OAuth access token"},"oauth_refresh_token":{"type":"string","description":"The OAuth refresh token"},"oauth_uid":{"type":"string","description":"The unique OAuth user identifier"},"oauth_signer_uri":{"type":"string","description":"The OAuth signer URI, if the app uses a custom OAuth signer"}},"uniqueKey":"credentials.oneOf.1","typeLabel":"null"}],"uniqueKey":"credentials","typeLabel":"object | null"},"expires_at":{"type":"string","description":"The date and time the account's credentials expiration, an ISO 8601 formatted string","format":"date-time","uniqueKey":"expires_at","typeLabel":"string\u003cdate-time>"},"error":{"oneOf":[{"type":"string","description":"The error message if the account is unhealthy or dead, null otherwise","uniqueKey":"error.oneOf.0","typeLabel":"string"},{"type":"null","description":"The error message if the account is unhealthy or dead, null otherwise","uniqueKey":"error.oneOf.1","typeLabel":"null"}],"uniqueKey":"error","typeLabel":"string | null"},"last_refreshed_at":{"oneOf":[{"type":"string","description":"The date and time the account was last refreshed, an ISO 8601 formatted string","format":"date-time","uniqueKey":"last_refreshed_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","description":"The date and time the account was last refreshed, an ISO 8601 formatted string","format":"date-time","uniqueKey":"last_refreshed_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"last_refreshed_at","typeLabel":"string\u003cdate-time> | null"},"next_refresh_at":{"oneOf":[{"type":"string","description":"The date and time the account will next be refreshed, an ISO 8601 formatted string","format":"date-time","uniqueKey":"next_refresh_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","description":"The date and time the account will next be refreshed, an ISO 8601 formatted string","format":"date-time","uniqueKey":"next_refresh_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"next_refresh_at","typeLabel":"string\u003cdate-time> | null"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"id":"\u003cstring>","name":"\u003cstring>","external_id":"\u003cstring>","healthy":true,"dead":true,"app":{"name_slug":"\u003cstring>","name":"\u003cstring>","img_src":"\u003cstring>","custom_fields_json":"\u003cstring>","categories":["\u003cstring>"],"featured_weight":123,"scope_profiles":[{"name":"read_only","scopes":["\u003cstring>"]}],"id":"\u003cstring>","auth_type":"keys","description":"\u003cstring>","oauth_app_id":"\u003cstring>","scopes":["\u003cstring>"],"additional_scopes":["\u003cstring>"],"scope_labels":{"scopes":"\u003cstring>","additional_scopes":"\u003cstring>"}},"created_at":"2023-11-07T05:31:56Z","updated_at":"2023-11-07T05:31:56Z","authorized_scopes":["\u003cstring>"],"credentials":{"oauth_client_id":"\u003cstring>","oauth_access_token":"\u003cstring>","oauth_refresh_token":"\u003cstring>","oauth_uid":"\u003cstring>","oauth_signer_uri":"\u003cstring>"},"expires_at":"2023-11-07T05:31:56Z","error":"\u003cstring>","last_refreshed_at":"2023-11-07T05:31:56Z","next_refresh_at":"2023-11-07T05:31:56Z"}}},"exampleType":"generated"}},"exampleType":"generated"},"55fd3cdc-8f63-451e-9035-5e045f2aef77":{"description":"too many requests","headers":{"Retry-After":{"description":"Number of seconds until the rate limit resets","schema":{"type":"integer"}},"X-RateLimit-Limit":{"schema":{"type":"integer"},"description":"The rate limit threshold"},"X-RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Number of requests remaining (always 0 when throttled)"},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Unix timestamp when the rate limit resets"}},"content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","example":"Throttled","uniqueKey":"error","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"Throttled"}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"ec134d3b-f0ba-4520-ae02-9bef4e14cd15":{"ConnectToken":{"description":"A short-lived Connect token for client-side requests on behalf of an end user. Generate one via the Create Connect token endpoint.","type":"http","scheme":"bearer","bearerFormat":"^ctok_[0-9a-f]{32}$","scopes":[],"schemeName":"ConnectToken"}},"5712dde6-72b8-4c01-ac04-e153742e3c69":{"OAuth2":{"description":"A short-lived OAuth access token for server-side requests. Generate one via the Generate OAuth Token flow or automatically when initializing the SDK client.","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.pipedream.com/v1/oauth/token","scopes":{"*":"Full access to every OAuth-protected endpoint.","connect:*":"Full access to all Connect API endpoints (components, projects, triggers, accounts, etc.).","connect:actions:*":"Full access to Connect actions.","connect:triggers:*":"Full access to Connect triggers.","connect:accounts:read":"List and fetch Connect accounts for an external user.","connect:accounts:write":"Create or remove Connect accounts.","connect:deployed_triggers:read":"Read deployed triggers and related data like events, pipelines and webhooks.","connect:deployed_triggers:write":"Modify or delete deployed triggers.","connect:users:read":"List and fetch external users","connect:users:write":"Delete external users.","connect:projects:read":"List and fetch projects owned by the workspace.","connect:projects:write":"Create, update, or delete projects owned by the workspace.","connect:oauth_apps:read":"List and fetch custom OAuth clients, and fetch Pipedream official clients.","connect:oauth_apps:write":"Create, update, or delete custom OAuth clients.","connect:app_overrides:read":"List and fetch app overrides.","connect:app_overrides:write":"Create, update, or delete app overrides.","connect:usage:read":"List Connect usage records for a time window.","connect:tokens:create":"Create Connect session tokens.","connect:proxy":"Invoke the Connect proxy.","connect:workflow:invoke":"Invoke Connect workflows on behalf of a user."}}},"scopes":[],"schemeName":"OAuth2"}}},"servers":{"94d370e2-2341-427f-9133-eaddb7c7a172":{"url":"https://api.pipedream.com"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"description":"A short-lived Connect token for client-side requests on behalf of an end user. Generate one via the Create Connect token endpoint.","type":"http","scheme":"bearer","bearerFormat":"^ctok_[0-9a-f]{32}$","scopes":[],"schemeName":"ConnectToken"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"A short-lived Connect token for client-side requests on behalf of an end user. Generate one via the Create Connect token endpoint.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"ConnectToken","name":"Authorization"}],"title":"ConnectToken"},{"schemes":[{"scheme":{"description":"A short-lived OAuth access token for server-side requests. Generate one via the Generate OAuth Token flow or automatically when initializing the SDK client.","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.pipedream.com/v1/oauth/token","scopes":{"*":"Full access to every OAuth-protected endpoint.","connect:*":"Full access to all Connect API endpoints (components, projects, triggers, accounts, etc.).","connect:actions:*":"Full access to Connect actions.","connect:triggers:*":"Full access to Connect triggers.","connect:accounts:read":"List and fetch Connect accounts for an external user.","connect:accounts:write":"Create or remove Connect accounts.","connect:deployed_triggers:read":"Read deployed triggers and related data like events, pipelines and webhooks.","connect:deployed_triggers:write":"Modify or delete deployed triggers.","connect:users:read":"List and fetch external users","connect:users:write":"Delete external users.","connect:projects:read":"List and fetch projects owned by the workspace.","connect:projects:write":"Create, update, or delete projects owned by the workspace.","connect:oauth_apps:read":"List and fetch custom OAuth clients, and fetch Pipedream official clients.","connect:oauth_apps:write":"Create, update, or delete custom OAuth clients.","connect:app_overrides:read":"List and fetch app overrides.","connect:app_overrides:write":"Create, update, or delete app overrides.","connect:usage:read":"List Connect usage records for a time window.","connect:tokens:create":"Create Connect session tokens.","connect:proxy":"Invoke the Connect proxy.","connect:workflow:invoke":"Invoke Connect workflows on behalf of a user."}}},"scopes":[],"schemeName":"OAuth2"},"schema":{"title":"OAuth2 Auth","type":"string","isRequired":true,"description":"A short-lived OAuth access token for server-side requests. Generate one via the Generate OAuth Token flow or automatically when initializing the SDK client.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"OAuth2","name":"Authorization"}],"title":"OAuth2"}]},"originalFileLocation":"pipedream_openapi_swagger.json"},"subdomain":"pipedream","siteName":"Pipedream","title":"Retrieve account - Pipedream","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-20T15:23:27.534Z","originalFileLocation":"connect/api-reference/retrieve-account.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Get the details for a specific connected account\">\u003cmeta data-mint-head name=\"keywords\" content=\"api, mcp, ai, integrations, pipedream, workflow, automation, connect, apis\">\u003cmeta data-mint-head name=\"application-name\" content=\"Pipedream\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003cmeta data-mint-head name=\"robots\" content=\"index, follow\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/pipedream/BXAUbH3bs99htewI/_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=\"/docs/mintlify-assets/_mintlify/favicons/pipedream/BXAUbH3bs99htewI/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/pipedream/BXAUbH3bs99htewI/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/pipedream/BXAUbH3bs99htewI/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/pipedream/BXAUbH3bs99htewI/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/pipedream/BXAUbH3bs99htewI/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/pipedream/BXAUbH3bs99htewI/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/pipedream/BXAUbH3bs99htewI/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/pipedream/BXAUbH3bs99htewI/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Retrieve account - Pipedream\">\u003cmeta data-mint-head property=\"og:description\" content=\"Pipedream provides the toolkit to add thousands of integrations to your app and enables you to automate any process.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Pipedream\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://pipedream.com/docs/connect/api-reference/retrieve-account\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://pipedream.mintlify.site/docs/_mintlify/api/og/v2?division=Accounts\u0026amp;title=Retrieve+account\u0026amp;description=Get+the+details+for+a+specific+connected+account\u0026amp;theme=0d4512b4a13a7a889c737c15\u0026amp;signature=a939ee205ef1cc6b066f32331e27e54776349484b6825d2b6f8214fe1821fa52\">\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=\"Pipedream\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Pipedream provides the toolkit to add thousands of integrations to your app and enables you to automate any process.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://pipedream.mintlify.site/docs/_mintlify/api/og/v2?division=Accounts\u0026amp;title=Retrieve+account\u0026amp;description=Get+the+details+for+a+specific+connected+account\u0026amp;theme=0d4512b4a13a7a889c737c15\u0026amp;signature=a939ee205ef1cc6b066f32331e27e54776349484b6825d2b6f8214fe1821fa52\">\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=\"/docs/mintlify-assets/_mintlify/favicons/pipedream/BXAUbH3bs99htewI/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Pipedream\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#095c32\">\u003cmeta data-mint-head name=\"og:locale\" content=\"en_US\">\u003cmeta data-mint-head name=\"charset\" content=\"UTF-8\">\u003cmeta data-mint-head name=\"viewport\" content=\"width=device-width, initial-scale=1.0\">\u003cmeta data-mint-head name=\"author\" content=\"Pipedream\">\u003cmeta data-mint-head name=\"googlebot\" content=\"index, follow\">\u003cmeta data-mint-head name=\"language\" content=\"en\">\u003cmeta data-mint-head name=\"twitter:creator\" content=\"@pipedream\">\u003cmeta data-mint-head name=\"twitter:image:alt\" content=\"Pipedream Logo\">\u003clink data-mint-head rel=\"canonical\" href=\"https://pipedream.com/docs/connect/api-reference/retrieve-account\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/docs/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/docs/connect/api-reference/retrieve-account.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://pipedream.com/#organization\",\"name\":\"Pipedream\",\"url\":\"https://pipedream.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/pipedream/J-J7n6QGsUEW1AZY/logo/pipedream_workday_lockup.png?fit=max\u0026auto=format\u0026n=J-J7n6QGsUEW1AZY\u0026q=85\u0026s=20f01e899a0e49424e3d16d1e84adc60\"}},{\"@type\":\"WebSite\",\"@id\":\"https://pipedream.com/docs#website\",\"name\":\"Pipedream\",\"url\":\"https://pipedream.com/docs\",\"publisher\":{\"@id\":\"https://pipedream.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://pipedream.com/docs/connect/api-reference/retrieve-account#webpage\",\"url\":\"https://pipedream.com/docs/connect/api-reference/retrieve-account\",\"name\":\"Retrieve account\",\"description\":\"Get the details for a specific connected account\",\"dateModified\":\"2026-10-20T15:23:27.534Z\",\"isPartOf\":{\"@id\":\"https://pipedream.com/docs#website\"},\"breadcrumb\":{\"@id\":\"https://pipedream.com/docs/connect/api-reference/retrieve-account#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://pipedream.com/docs/connect/api-reference/retrieve-account#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Accounts\",\"item\":\"https://pipedream.com/docs/connect/api-reference/list-accounts-for-external-user\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Retrieve account\",\"item\":\"https://pipedream.com/docs/connect/api-reference/retrieve-account\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://pipedream.com/docs/connect/api-reference/retrieve-account#apireference\",\"headline\":\"Retrieve account\",\"name\":\"Retrieve account\",\"description\":\"Get the details for a specific connected account\",\"url\":\"https://pipedream.com/docs/connect/api-reference/retrieve-account\",\"mainEntityOfPage\":{\"@id\":\"https://pipedream.com/docs/connect/api-reference/retrieve-account#webpage\"},\"dateModified\":\"2026-10-20T15:23:27.534Z\",\"publisher\":{\"@id\":\"https://pipedream.com/#organization\"},\"isPartOf\":{\"@id\":\"https://pipedream.com/docs#website\"}}]}\u003c/script>","siteName":"Pipedream","nav":{"global":null,"products":[{"product":"Connect","icon":"https://mintlify.s3.us-west-1.amazonaws.com/pipedream/logo/pipedream_icon.svg","description":"Integration layer for AI agents","tabs":[{"tab":"Documentation","icon":"book","pages":[{"title":"Documentation","href":""}]},{"tab":"Connect API","icon":"square-terminal","pages":[{"title":"Introduction","sidebarTitle":"Introduction","icon":"book-open","href":"/connect/api-reference/introduction"},{"title":"SDKs","icon":"layer-group","href":"/connect/api-reference/sdks"},{"title":"Authentication","sidebarTitle":"Authentication","icon":"lock","href":"/connect/api-reference/authentication"},{"title":"Rate Limits","sidebarTitle":"Rate Limits","icon":"gauge","href":"/connect/api-reference/rate-limits"},{"title":"SDK Migration Guide","icon":"swap","href":"/connect/api-reference/sdk-migration"},{"group":"Tokens","pages":[{"openapi":"post /v1/oauth/token","title":"Generate OAuth Token","href":"/connect/api-reference/create-oauth-token"},{"title":"Create Connect token","openapi":"post /v1/connect/{project_id}/tokens","href":"/connect/api-reference/create-connect-token"}]},{"group":"Apps","pages":[{"openapi":"get /v1/connect/apps","title":"List apps","href":"/connect/api-reference/list-apps"},{"openapi":"get /v1/connect/apps/{app_id}","title":"Retrieve app","href":"/connect/api-reference/retrieve-app"},{"openapi":"get /v1/connect/app_categories","title":"List app categories","href":"/connect/api-reference/list-app-categories"}]},{"group":"Accounts","pages":[{"title":"List user accounts","openapi":"get /v1/connect/{project_id}/users/{external_user_id}/accounts","description":"List all connected accounts for a specific external user. Equivalent to GET /accounts with external_user_id filter but uses path-based routing.","href":"/connect/api-reference/list-accounts-for-external-user"},{"openapi":"get /v1/connect/{project_id}/accounts/{account_id}","title":"Retrieve account","href":"/connect/api-reference/retrieve-account"},{"openapi":"delete /v1/connect/{project_id}/accounts/{account_id}","title":"Delete account","description":"Remove a connected account and its associated credentials","href":"/connect/api-reference/delete-account"},{"openapi":"delete /v1/connect/{project_id}/apps/{app_id}/accounts","title":"Delete accounts by app","href":"/connect/api-reference/delete-accounts-by-app"}]},{"group":"External Users","pages":[{"title":"List external users","openapi":"get /v1/connect/{project_id}/users","href":"/connect/api-reference/list-users"},{"openapi":"delete /v1/connect/{project_id}/users/{external_user_id}","title":"Delete external user","href":"/connect/api-reference/delete-external-user"}]},{"group":"Actions","pages":[{"openapi":"get /v1/connect/{project_id}/actions","title":"List actions","href":"/connect/api-reference/list-actions"},{"openapi":"get /v1/connect/{project_id}/actions/{component_id}","title":"Retrieve action","href":"/connect/api-reference/retrieve-action"},{"openapi":"post /v1/connect/{project_id}/actions/configure","title":"Configure action prop","href":"/connect/api-reference/configure-action-prop"},{"openapi":"post /v1/connect/{project_id}/actions/props","title":"Reload action props","href":"/connect/api-reference/reload-action-props"},{"openapi":"post /v1/connect/{project_id}/actions/run","title":"Run action","href":"/connect/api-reference/run-action"}]},{"group":"Triggers","pages":[{"openapi":"get /v1/connect/{project_id}/triggers","title":"List triggers","href":"/connect/api-reference/list-triggers"},{"openapi":"get /v1/connect/{project_id}/triggers/{component_id}","title":"Retrieve trigger","href":"/connect/api-reference/retrieve-trigger"},{"openapi":"post /v1/connect/{project_id}/triggers/configure","title":"Configure trigger prop","href":"/connect/api-reference/configure-trigger-prop"},{"openapi":"post /v1/connect/{project_id}/triggers/props","title":"Reload trigger props","href":"/connect/api-reference/reload-trigger-props"},{"openapi":"post /v1/connect/{project_id}/triggers/deploy","title":"Deploy trigger","href":"/connect/api-reference/deploy-trigger"}]},{"group":"Deployed Triggers","pages":[{"openapi":"get /v1/connect/{project_id}/deployed-triggers","title":"List deployed triggers","href":"/connect/api-reference/list-deployed-triggers"},{"openapi":"get /v1/connect/{project_id}/deployed-triggers/{trigger_id}","title":"Get deployed trigger","href":"/connect/api-reference/get-deployed-trigger"},{"openapi":"put /v1/connect/{project_id}/deployed-triggers/{trigger_id}","title":"Update deployed trigger","href":"/connect/api-reference/update-deployed-trigger"},{"openapi":"delete /v1/connect/{project_id}/deployed-triggers/{trigger_id}","title":"Delete deployed trigger","href":"/connect/api-reference/delete-deployed-trigger"},{"openapi":"get /v1/connect/{project_id}/deployed-triggers/{trigger_id}/events","title":"List trigger events","href":"/connect/api-reference/list-trigger-events"},{"openapi":"get /v1/connect/{project_id}/deployed-triggers/{trigger_id}/webhooks","title":"List trigger webhooks","href":"/connect/api-reference/list-trigger-webhooks"},{"openapi":"get /v1/connect/{project_id}/deployed-triggers/{trigger_id}/webhooks/{webhook_id}","title":"Get trigger webhook","href":"/connect/api-reference/get-trigger-webhook"},{"openapi":"put /v1/connect/{project_id}/deployed-triggers/{trigger_id}/webhooks","title":"Update trigger webhooks","href":"/connect/api-reference/update-trigger-webhooks"},{"openapi":"post /v1/connect/{project_id}/deployed-triggers/{trigger_id}/webhooks/{webhook_id}/regenerate_signing_key","title":"Regenerate trigger webhook signing key","href":"/connect/api-reference/regenerate-trigger-webhook-signing-key"},{"openapi":"post /v1/connect/{project_id}/deployed-triggers/{trigger_id}/webhooks/{webhook_id}/reset_delivery_state","title":"Reset trigger webhook delivery state","href":"/connect/api-reference/reset-trigger-webhook-delivery-state"}]},{"group":"Components","pages":[{"openapi":"get /v1/connect/{project_id}/components","title":"List components","href":"/connect/api-reference/list-components"},{"openapi":"get /v1/connect/{project_id}/components/{component_id}","title":"Retrieve component","href":"/connect/api-reference/retrieve-component"},{"openapi":"post /v1/connect/{project_id}/components/configure","title":"Configure component prop","href":"/connect/api-reference/configure-component-prop"},{"openapi":"post /v1/connect/{project_id}/components/props","title":"Reload component props","href":"/connect/api-reference/reload-component-props"}]},{"group":"OAuth Clients","pages":[{"openapi":"get /v1/connect/{project_id}/oauth_apps","title":"List OAuth clients","href":"/connect/api-reference/list-oauth-clients"},{"openapi":"post /v1/connect/{project_id}/oauth_apps","title":"Create OAuth client","href":"/connect/api-reference/create-oauth-client"},{"openapi":"get /v1/connect/{project_id}/oauth_apps/{id}","title":"Retrieve OAuth client","href":"/connect/api-reference/retrieve-oauth-client"},{"openapi":"put /v1/connect/{project_id}/oauth_apps/{id}","title":"Update OAuth client","href":"/connect/api-reference/update-oauth-client"},{"openapi":"delete /v1/connect/{project_id}/oauth_apps/{id}","title":"Delete OAuth client","href":"/connect/api-reference/delete-oauth-client"}]},{"group":"App Overrides","pages":[{"openapi":"get /v1/connect/{project_id}/app_overrides","title":"List app overrides","href":"/connect/api-reference/list-app-overrides"},{"openapi":"post /v1/connect/{project_id}/app_overrides","title":"Create app override","href":"/connect/api-reference/create-app-override"},{"openapi":"get /v1/connect/{project_id}/app_overrides/{id}","title":"Retrieve app override","href":"/connect/api-reference/retrieve-app-override"},{"openapi":"put /v1/connect/{project_id}/app_overrides/{id}","title":"Update app override","href":"/connect/api-reference/update-app-override"},{"openapi":"delete /v1/connect/{project_id}/app_overrides/{id}","title":"Delete app override","href":"/connect/api-reference/delete-app-override"}]},{"group":"Projects","pages":[{"openapi":"get /v1/connect/projects","title":"List projects","href":"/connect/api-reference/list-projects"},{"openapi":"post /v1/connect/projects","title":"Create project","href":"/connect/api-reference/create-project"},{"openapi":"get /v1/connect/projects/{project_id}","title":"Retrieve project","href":"/connect/api-reference/retrieve-project"},{"openapi":"patch /v1/connect/projects/{project_id}","title":"Update project","href":"/connect/api-reference/update-project"},{"openapi":"delete /v1/connect/projects/{project_id}","title":"Delete project","href":"/connect/api-reference/delete-project"},{"openapi":"post /v1/connect/projects/{project_id}/logo","title":"Update project logo","href":"/connect/api-reference/update-project-logo"},{"openapi":"get /v1/connect/{project_id}/projects/info","title":"Get project info","href":"/connect/api-reference/get-project-info"}]},{"group":"Project Webhooks","pages":[{"openapi":"get /v1/connect/{project_id}/webhook","title":"Get project environment webhook","href":"/connect/api-reference/get-project-environment-webhook"},{"openapi":"put /v1/connect/{project_id}/webhook","title":"Set project environment webhook","href":"/connect/api-reference/set-project-environment-webhook"},{"openapi":"delete /v1/connect/{project_id}/webhook","title":"Delete project environment webhook","href":"/connect/api-reference/delete-project-environment-webhook"},{"openapi":"post /v1/connect/{project_id}/webhook/regenerate_signing_key","title":"Regenerate webhook signing key","href":"/connect/api-reference/regenerate-webhook-signing-key"}]},{"group":"Connect Usage","pages":[{"openapi":"get /v1/connect/usage","title":"List usage records","href":"/connect/api-reference/list-usage-records"}]},{"group":"File Stash","pages":[{"openapi":"get /v1/connect/{project_id}/file_stash/download","title":"Download file","href":"/connect/api-reference/download-file"}]}]},{"tab":"Changelog","icon":"bullhorn","pages":[{"title":"Changelog","href":"/changelog"}]}]},{"product":"Conduit","icon":"https://mintlify.s3.us-west-1.amazonaws.com/pipedream/images/conduit/conduit-mark.svg","description":"Enterprise MCP Gateway","pages":[{"title":"Conduit","href":"/conduit"}]}]},"basePath":"","title":"Retrieve account - Pipedream","buildId":"dpl_BSPUBxEoKhhK7HzXVDPxdPvWx4xc","deploymentId":"dpl_BSPUBxEoKhhK7HzXVDPxdPvWx4xc","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-Do6EtGSl.js","utils-id4tQ6My.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-Byrixac4.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-nakYa3Zl.js","snippetPresets-Bq-pUS7h.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-CujTC_9K.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-FneVUsVu.js","shallow-DY9WpUCz.js","getApiPlaygroundDisplay-Bz8WpPfA.js","CodeSnippet-DgCuJg4G.js","CodeSnippets-Dub9c4T0.js","Page-CePXnjd1.js","getPastedJson-xdI8y2XB.js","icon--yVw5vkr.js","MethodPill-C47t7MdS.js","DuplicateIcon-BzwJ2LeC.js","createIcon-BzggGy84.js","DynamicMarkdown-AlxJK8VR.js","SectionHeading-CMlwFxdK.js","axios-vUo_bRtp.js","Markdown-BNgNrPsi.js","clsx-apD-Q0Oo.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-qmLwQyWY.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-Dc4qTkWx.js"]}