Connected accounts
A connected account is one user's link to one connection, and holds that user's credentials for the app. See Manage connected accounts for when to check, refresh or delete one.
SDK helpers. get_or_create_connected_account (Python) and getOrCreateConnectedAccount (Node.js) get the user's connected account for a connection, or create it without credentials when there isn't one; Authorize a user and Manage connected accounts use them. actions.providers.list_providers (Python) and actions.providers.listProviders (Node.js) list connectors with their identifier, as Create a connector shows.
| Method | Endpoint | Path | What it does | SDKs |
|---|---|---|---|---|
| POST | Create a connected accountCreate a user's connected account with credentials you already hold. | / | Create a user's connected account with credentials you already hold. | PythonNode.js |
| GET | Get a connected accountGet an account's status, connection and settings, without its credentials. | / | Get an account's status, connection and settings, without its credentials. | PythonNode.js: REST only |
| GET | List connected accountsList accounts, filtered by connection, user, provider or organization. | / | List accounts, filtered by connection, user, provider or organization. | PythonNode.js |
| GET | Search connected accountsFind accounts whose identifier, provider or connection matches a text query. | / | Find accounts whose identifier, provider or connection matches a text query. | Python: REST onlyNode.js: REST only |
| PUT | Update a connected accountChange an account's settings, or import new credentials for it. | / | Change an account's settings, or import new credentials for it. | PythonNode.js |
| GET | Get a connected account's credentialsGet an account with its OAuth tokens or API key, to call the app yourself. | / | Get an account with its OAuth tokens or API key, to call the app yourself. | PythonNode.js |
| POST | Delete a connected accountDelete an account and the user's stored credentials. | / | Delete an account and the user's stored credentials. | PythonNode.js |