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

# Manage Connection

> Manage your Stripe connection in Finta. Update your API key, understand required permissions, and troubleshoot connection issues.

Stripe connections are managed from the **Accounts** page in the Finta dashboard. The connection shows your Stripe account name and the last sync time.

## Connection status

Stripe syncs in real time via webhooks. New charges, invoices, and account activity come in automatically.

If your API key is revoked, rotated, or loses permissions, syncs start failing. Fix it by updating the key.

## Updating your API key

1. Go to the **Accounts** page in the [Finta dashboard](https://app.finta.io)
2. Click the **three-dot menu** (⋮) on your Stripe connection
3. Select **Update API Key**
4. In the [Stripe Dashboard](https://dashboard.stripe.com/apikeys), create a new restricted key with the permissions listed below
5. Copy the new key (it starts with `rk_live_`) and paste it into the dialog
6. Click **Update Key**

Syncing picks back up once the new key is validated.

## Required permissions

| Permission            | Access |
| --------------------- | ------ |
| All Core resources    | Read   |
| All Connect resources | Read   |
| All Billing resources | Read   |
| Webhook Endpoints     | Write  |

<Warning>
  Use a restricted key (`rk_live_...`), not a secret key (`sk_live_...`). Finta only needs the permissions listed above.
</Warning>

## Other actions

Click the **three-dot menu** (⋮) on any connection card to access these options:

### View syncs

See a history of all syncs for this connection, including timestamps and whether they succeeded or failed. Useful for troubleshooting if data seems out of date.

### Set sync start date

Control how far back Finta pulls historical data. If you only need recent data, set a more recent start date to keep your destination focused.

### Remove connection

Permanently disconnect Stripe from Finta. This removes the connection and all associated data.

<Warning>
  Removing a connection is permanent. You'll need to create a new restricted key and go through the setup process again if you want to reconnect.
</Warning>

## Troubleshooting

**"API Key is invalid":** Make sure you copied the full key. Restricted keys start with `rk_live_`. If you just rotated the key, the old one is already invalidated.

**"Missing permissions":** Double-check your restricted key in the Stripe Dashboard. The most commonly missed permission is **Write** on **Webhook Endpoints** — Finta needs it to receive real-time updates.

**Syncs failing after key rotation:** The old key Finta was using is gone. Use **Update API Key** from the three-dot menu to add the new one.

## Next steps

<CardGroup cols={2}>
  <Card title="Bank Connections Overview" icon="building-columns" href="/bank-connections/overview">
    See all supported providers
  </Card>

  <Card title="Create a Destination" icon="plus" href="/destinations/create-destination">
    Set up where your data syncs to
  </Card>
</CardGroup>
