---
title: "Start the Stripe install flow"
method: POST
path: "/companies/{companyId}/integrations/stripe/install-link"
tags: ["Stripe Connect"]
---

# Start the Stripe install flow

`POST /companies/{companyId}/integrations/stripe/install-link`

## Request

- Base URL: `https://api.medianfi.com/api/v1`
- URL: `https://api.medianfi.com/api/v1/companies/{companyId}/integrations/stripe/install-link`
- Auth: HTTP bearer

## Request body

- StripeInstallLinkInput
  - `entityId` string, uuid: Model A legal entity to bind the connection to. Omitted when the company has a single entity.
  - `frontendReturnUri` string: Relative app path the install callback returns the user to.

## Response `200`

Stripe install URL

- StripeInstallLinkResponse
  - `success` true, required
  - `data` object, required
    - `installUrl` string, uri, required
    - `authorizationUrl` string, uri, required: Alias of installUrl, kept for the generic provider-connect client.

## Other responses

- `401`: Authentication required
- `403`: Insufficient permissions or not a company member
- `409`: The Stage-A Stripe GL compatibility guard refused the call (STRIPE_GL_ACCOUNT_REBIND_REQUIRED). No connection, account, or journal entry was changed. `extensions.accountCodes` lists the codes an accountant must review and rebind; `extensions.adoptableCodes` lists codes that conform on accounting shape and self-heal on the next sync.
- `503`: Required sandbox provider configuration or service is unavailable

---

[API](https://skmtc.dev/medianfi/apis/median-api.md) · [All operations](https://skmtc.dev/medianfi/apis/median-api/llms.txt) · [OpenAPI document](https://skmtc.dev/medianfi/apis/median-api/revisions/20090ea32b0d?raw)