---
title: "Start connecting a Stripe account"
method: GET
path: "/integrations/stripe/connect"
tags: ["Integrations"]
---

# Start connecting a Stripe account

`GET /integrations/stripe/connect`

## Request

- Base URL: `https://ledgerhq.pro/api/v1`
- URL: `https://ledgerhq.pro/api/v1/integrations/stripe/connect`
- Auth: one of:
  - HTTP bearer and API key in header `x-organization-id`
  - HTTP bearer and API key in header `x-organization-id`

Returns a Stripe Connect OAuth URL for the selected firm or company workspace. Open it in a browser; the callback stores the connection and returns to Settings > Stripe on the initiating host. The original connection remains the default for bookkeeping, new payments, and onboarding. Sentinel may add subscription_links accounts for existing subscription links and portal card updates only, with no bookkeeping sync. Each Stripe account belongs to only one workspace. Existing connections created through onboarding remain the same records. The callback is a browser redirect target and is never called directly.

## Query parameters

- `purpose` 'accounting' | 'firm_payments' | 'subscription_links'
- `label` string
- `organizationId` string, uuid
- `redirect` '1'

## Response `200`

Stripe authorization URL

## Other responses

- `302`: Redirect to Stripe when redirect=1
- `500`: Stripe Connect is not configured
- `default`: Error response

---

[API](https://skmtc.dev/ledgerhq-pro/apis/ledgerhq-bookkeeping-api.md) · [All operations](https://skmtc.dev/ledgerhq-pro/apis/ledgerhq-bookkeeping-api/llms.txt) · [OpenAPI document](https://skmtc.dev/ledgerhq-pro/apis/ledgerhq-bookkeeping-api/revisions/9a8269f0a586?raw)