---
title: "Hosted Stripe Connect onboarding link for receivables collection"
method: POST
path: "/companies/{companyId}/receivables/stripe-connect/onboarding-link"
tags: ["Receivables"]
---

# Hosted Stripe Connect onboarding link for receivables collection

`POST /companies/{companyId}/receivables/stripe-connect/onboarding-link`

## Request

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

Wave 3b (#1153/#1154). DARK — 404s unless ar_ap_items_enabled. Member role required. Reuses the existing Stripe App install-link plumbing (no hand-rolled Stripe); webhook/callback completion of that flow flips stripe_connections.status, which the next GET payment-settings reflects. Returns { onboardingUrl }. Responds 503 STRIPE_INSTALL_NOT_CONFIGURED when the Stripe install flow is not configured for the environment.

## Request body

- object
  - `entityId` string, uuid

## Response `200`

{ onboardingUrl }

## Other responses

- `401`: Authentication required
- `403`: Insufficient permissions or not a company member
- `404`: AR/AP items not enabled for this company
- `503`: STRIPE_INSTALL_NOT_CONFIGURED — Stripe install flow not configured

---

[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)