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 accountStore a user's OAuth tokens or API key for one connection. | / | Store a user's OAuth tokens or API key for one connection. | 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 accountStore new tokens or an API key for an account, or change its settings. | / | Store new tokens or an API key for an account, or change its settings. | 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 |