Connected accounts

Connected accounts for agent workflows

Manage connected accounts for agent tool access (AgentKit-style connections from the Python SaaSKit surface).

Prefer the AgentKit SDK docs when building agent product flows; use these methods when integrating from the Python SaaS client.

list_connected_accounts

clientConnectedAccountshttps://github.com/scalekit-inc/scalekit-sdk-python/blob/main/scalekit/connected_accounts.py

#asynclist_connected_accounts

Runs list_connected_accounts and returns the result.

paramorganization_idOptional[str]

Organization ID.

paramuser_idOptional[str]

Scalekit user ID (usr_...).

paramconnectorOptional[str]

Connector slug.

paramidentifierOptional[str]

End-user identifier.

paramproviderOptional[str]

Identity provider.

parampage_sizeOptional[int]

Results per page.

parampage_tokenOptional[str]

Pagination token.

paramconnection_namesOptional[List[str]]

Connector slug filter.

returnsListConnectedAccountsResponse

Paginated connected accounts.

response = scalekit_client.connected_accounts.list_connected_accounts(
    organization_id='org_123456',
    user_id='usr_123456',
    page_size=50
)

for account in response[0].connected_accounts:
    print(f'Account: {account.id}')

get_connected_account_by_identifier

clientConnectedAccountshttps://github.com/scalekit-inc/scalekit-sdk-python/blob/main/scalekit/connected_accounts.py

#asyncget_connected_account_by_identifier

Method to get connected account by identifier

paramconnectorstr

Connector identifier

paramidentifierstr

Identifier for the connector

paramorganization_idOptional[str]

Optional. Organization ID

paramuser_idOptional[str]

Optional. User ID

paramconnected_account_idOptional[str]

Optional. ID of the connected account

returnsGetConnectedAccountByIdentifierResponse

Get Connected Account By Identifier Response

response = scalekit_client.connected_accounts.get_connected_account_by_identifier(
    'slack',
    'workspace_id',
    organization_id='org_123456',
    user_id='usr_123456'
)

create_connected_account

clientConnectedAccountshttps://github.com/scalekit-inc/scalekit-sdk-python/blob/main/scalekit/connected_accounts.py

#asynccreate_connected_account

Method to create a connected account

paramconnectorstr

Connector identifier

paramidentifierstr

Identifier for the connector

paramconnected_accountCreateConnectedAccount

Connected account details

paramorganization_idOptional[str]

Optional. Organization ID

paramuser_idOptional[str]

Optional. User ID

returnsCreateConnectedAccountResponse

Create Connected Account Response

from scalekit.v1.connected_accounts.connected_accounts_pb2 import CreateConnectedAccount

account = CreateConnectedAccount()

response = scalekit_client.connected_accounts.create_connected_account(
    'slack',
    'workspace_id',
    account,
    organization_id='org_123456',
    user_id='usr_123456'
)

update_connected_account

clientConnectedAccountshttps://github.com/scalekit-inc/scalekit-sdk-python/blob/main/scalekit/connected_accounts.py

#asyncupdate_connected_account

Method to update a connected account

paramconnectorstr

Connector identifier

paramidentifierstr

Identifier for the connector

paramconnected_accountUpdateConnectedAccount

Updated connected account details

paramorganization_idOptional[str]

Optional. Organization ID

paramuser_idOptional[str]

Optional. User ID

paramconnected_account_idOptional[str]

Optional. ID of the connected account to update

returnsUpdateConnectedAccountResponse

Update Connected Account Response

from scalekit.v1.connected_accounts.connected_accounts_pb2 import UpdateConnectedAccount

account = UpdateConnectedAccount()

response = scalekit_client.connected_accounts.update_connected_account(
    'slack',
    'workspace_id',
    account,
    organization_id='org_123456',
    user_id='usr_123456'
)

delete_connected_account

clientConnectedAccountshttps://github.com/scalekit-inc/scalekit-sdk-python/blob/main/scalekit/connected_accounts.py

#asyncdelete_connected_account

Method to delete a connected account

paramconnectorstr

Connector identifier

paramidentifierstr

Identifier for the connector

paramorganization_idOptional[str]

Optional. Organization ID

paramuser_idOptional[str]

Optional. User ID

paramconnected_account_idOptional[str]

Optional. ID of the connected account to delete

returnsDeleteConnectedAccountResponse

Delete Connected Account Response

scalekit_client.connected_accounts.delete_connected_account(
    'slack',
    'workspace_id',
    organization_id='org_123456',
    user_id='usr_123456'
)

get_magic_link_for_connected_account

clientConnectedAccountshttps://github.com/scalekit-inc/scalekit-sdk-python/blob/main/scalekit/connected_accounts.py

#asyncget_magic_link_for_connected_account

Runs get_magic_link_for_connected_account and returns the result.

paramconnectorstr

Connector.

paramidentifierstr

Identifier.

paramorganization_idOptional[str]

Organization ID.

paramuser_idOptional[str]

Scalekit user ID (usr_...).

paramconnected_account_idOptional[str]

Connected account ID.

paramstateOptional[str]

Opaque state string.

paramuser_verify_urlOptional[str]

Post-auth verify URL.

returnsGetMagicLinkForConnectedAccountResponse

Authorization magic link.

response = scalekit_client.connected_accounts.get_magic_link_for_connected_account(
    'slack',
    'workspace_id',
    organization_id='org_123456',
    user_id='usr_123456'
)

print(f'Magic Link: {response[0].magic_link}')

get_connected_account_details_by_identifier

clientConnectedAccountshttps://github.com/scalekit-inc/scalekit-sdk-python/blob/main/scalekit/connected_accounts.py

#asyncget_connected_account_details_by_identifier

Method to get connected account details (without auth credentials) by identifier

paramconnectorstr

Connector identifier

paramidentifierstr

Identifier for the connector

paramorganization_idOptional[str]

Optional. Organization ID

paramuser_idOptional[str]

Optional. User ID

paramconnected_account_idOptional[str]

Optional. ID of the connected account

returnsGetConnectedAccountByIdentifierResponse

The response payload for this operation.

verify_connected_account_user

clientConnectedAccountshttps://github.com/scalekit-inc/scalekit-sdk-python/blob/main/scalekit/connected_accounts.py

#asyncverify_connected_account_user

Method to verify a connected account user after OAuth callback

paramauth_request_idstr

Auth request ID as base64url-encoded opaque token from the

paramidentifierstr

Current logged in user’s connected account identifier

returnsVerifyConnectedAccountUserResponse

Verify Connected Account User Response