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().