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

# Integrations overview

> Connect bank accounts through Plaid for payout setup

Use the Integrations API when a business links a bank account through Plaid
during payout setup. This path issues a Link token, then exchanges the public
token so Guile can attach verified accounts.

## What you do first

1. [Create a Plaid Link token](/api-reference/integrations/create-a-plaid-link-token)
   for the authenticated business session.
2. Run Plaid Link in your client with that token.
3. [Exchange a Plaid public token](/api-reference/integrations/exchange-a-plaid-public-token)
   after the user finishes Link.
4. [Access Plaid accounts](/api-reference/integrations/access-plaid-accounts)
   when you need the account list Guile can attach for payouts.

## States that matter

| Surface        | What it means for the next call                                 |
| -------------- | --------------------------------------------------------------- |
| Link token     | Short-lived; create a new one if Link was abandoned             |
| Public token   | Single-use for exchange; do not store it as a long-lived secret |
| Linked account | Ready to attach on the business payout setup path               |

## When a call fails

Failures come back as problem documents. Open the `type` link for the cause,
the fix, and whether retrying is safe. Common ones include an invalid Plaid
token and an account id that does not match the Link session.

## Related paths

* Attaching financial accounts and reading balance live under
  [Businesses](/api-reference/Businesses/overview).
* Cash-out after setup lives under [Payouts](/api-reference/Payouts/overview).