A Connection is a way of authenticating into a third party service, either via OAuth 2.0 or a secret. While an app can technically have one of each kind of connection, it will be very rare. There are two types of Connections:

User Connections

A User Connection is a connection set up by a specific user to a third party that is specific to a particular user. e.g. Connecting one user’s calendar to Attio. On the server side, the secret or auth token for a User Connection is achieved by calling getUserConnection().

Workspace Connections

A Workspace Connection is a connection that is valid for an entire workspace. e.g. Connecting an entire workspace to a third party SaaS product. On the server side, the secret or auth token for a Workspace Connection is achieved by calling getWorkspaceConnection().