Skip to main content

List the caller's connected accounts

POST 

/api/v1/integrations/pipedream/list-accounts

Lists connected accounts for the authenticated beneficiary. An app can have multiple accounts; select the intended account ID explicitly. healthy === true reflects the returned provider connection state, not current action consent or authorization. An unhealthy account can need reconnection. The response does not directly return the stored third-party credential. Continue using provider pagination rather than treating an empty data page alone as exhaustion.

The following access conditions are preserved as declared intent and are not implemented by generated code: Authorized scoped domain action.

Use this in a guide: Let your assistant answer questions about a customer’s calendar

Request​

Responses​

A page of the caller's connected accounts

List accounts belonging to the authenticated end user.​

Section ID: DOC-IN-tools-connections-apps-api-pipedreamListAccountsForCurrentUser#example-connected-apps-pipedreamListAccountsForCurrentUser-request

Request example

{}

Guide request for Confirm the account before showing Connected. Replace example resource identifiers with your own authorized values.​

Section ID: DOC-IN-tools-connections-apps-api-pipedreamListAccountsForCurrentUser#example-cookbook-integrations-tools-connections-connected-apps-03-request

Request example

{
"app": "google_calendar"
}

Illustrative response shape; omitted default fields and actual outcomes depend on the operation.​

Section ID: DOC-IN-tools-connections-apps-api-pipedreamListAccountsForCurrentUser#example-connected-apps-pipedreamListAccountsForCurrentUser-response

Response example

{
"data": [
{
"id": "example_123",
"name": "example",
"externalUserId": "example_123",
"healthy": true,
"app": "example",
"oauthAppId": "example_123",
"createdAt": "2026-09-16T12:00:00Z",
"updatedAt": "2026-09-16T12:00:00Z",
"credentialsLastRefreshedAt": "2026-09-16T12:00:00Z",
"credentialsExpiresAt": "2026-09-16T12:00:00Z",
"error": "example",
"lastRefreshedAt": "2026-09-16T12:00:00Z",
"nextRefreshAt": "2026-09-16T12:00:00Z"
}
],
"pageInfo": {
"count": 1,
"totalCount": 1,
"startCursor": "example",
"endCursor": "example"
}
}

Illustrative response for Confirm the account before showing Connected. Replace example resource identifiers with your own authorized values.​

Section ID: DOC-IN-tools-connections-apps-api-pipedreamListAccountsForCurrentUser#example-cookbook-integrations-tools-connections-connected-apps-json-03-response

Response example

{
"data": [
{
"id": "apn_kAHeAr9",
"name": "user@example.com",
"app": "google_calendar",
"healthy": true,
"createdAt": "2026-08-10T09:14:52Z"
}
],
"pageInfo": {
"count": 1,
"totalCount": 1
}
}

Document ID: DOC-IN-tools-connections-apps-api-pipedreamListAccountsForCurrentUser. Section identities and revisions.

SectionStable reference
List the caller's connected accountsDOC-IN-tools-connections-apps-api-pipedreamListAccountsForCurrentUser#overview
RequestDOC-IN-tools-connections-apps-api-pipedreamListAccountsForCurrentUser#request
ResponsesDOC-IN-tools-connections-apps-api-pipedreamListAccountsForCurrentUser#responses