> ## Documentation Index
> Fetch the complete documentation index at: https://docs.checkfu.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Connections

> Connect an external account and grant explicit access to it.

A **Connection** is a Workspace-scoped, nonsecret handle to one external
account or provider capability. The Agent can use the account through a
governed call path without receiving its credential.

## Connect and assign access

1. Use [Connect Center](/concepts/capabilities#connect-center) to choose a qualified offering and start a ConnectionSession
2. Let the account owner complete the trusted handoff
3. Observe completion, review the tools, and assign access explicitly

A completed connection is not an access grant. Connected calls still require
PermissionAssignments, ActionPolicy evaluation, any required ActionApproval,
and a live authority and revocation check at the trusted effect boundary.
See [permissions and governance](/concepts/tenancy-and-governance).

ConnectionSession completion is asynchronous. Use the ConnectionSession
operations or Connect Center controller to observe the handoff.
[Connection resource webhooks](/guides/receive-webhooks) report creation,
revocation, and refresh failure; they do not replace observing the
ConnectionSession. The [provider-account guide](/guides/connect-a-providers-account)
walks through the integration.

## Keep accounts and secrets separate

[Vaults and Credentials](/concepts/vaults) explain secret custody. A
ConnectionVault groups Connections and compiles member access into ordinary
PermissionAssignments; its row grants no runtime authority.

Read the [integration details](/concepts/capabilities#connections) for native
and runtime-backed custody, reconnect, concurrency, role restrictions, and
revocation. Check [capability status](/getting-started/status) for the
deployment and Workspace before depending on an execution path.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.