---
title: "POST /api/v1.0/{appId}/customconnect/{stripeConnectedAccountId}/create-account-link"
method: POST
path: "/api/v1.0/{appId}/customconnect/{stripeConnectedAccountId}/create-account-link"
tags: ["StripeCustomConnect"]
---

# POST /api/v1.0/{appId}/customconnect/{stripeConnectedAccountId}/create-account-link

`POST /api/v1.0/{appId}/customconnect/{stripeConnectedAccountId}/create-account-link`

## Request

- Base URL: `https://api.flipdish.co`
- URL: `https://api.flipdish.co/api/v1.0/{appId}/customconnect/{stripeConnectedAccountId}/create-account-link`
- Auth: OAuth 2 (implicit, authorization URL `https://api.flipdish.co/identity/connect/authorize`, scopes: `api`)

## Path parameters

- `appId` string, required
- `stripeConnectedAccountId` string, required

## Request body

- StripeAccountLinkRequest: Represents a request for Stripe account link creation
  - `StripeId` string: Stripe's own connected account identifier
  - `ReturnUrl` string: URL to be hit if link creation succeeds
  - `Collect` 'CurrentlyDue' | 'EventuallyDue': Which information to collect from users at this stage
  - `Type` 'Onboarding' | 'Update': Either onboarding or edit user information

## Response `200`

OK

- RestApiResultStripeConnectedAccount: Rest api result
  - `Data` StripeConnectedAccount, required: Represents a Stripe custom connected account
    - `FlipdishConnectedAccountId` integer: Flipdish connected account identifier
    - `StripeId` string: Stripe's own connected account identifier
    - `WhitelabelConfigId` integer: Id of the WhitelabelConfig the connected account is assigned to
    - `CardPaymentsStatus` 'Inactive' | 'Pending' | 'Active' | 'Unrequested': Card payments capability status (Inactive, Pending, Active, Unrequested)
    - `TransfersStatus` 'Inactive' | 'Pending' | 'Active' | 'Unrequested': Transfers capability status (Inactive, Pending, Active, Unrequested)
    - `AccountStatus` 'Disabled' | 'Enabled' | 'AdditionalInformationRequired' | 'PendingVerification' | 'Unverified' | 'Rejected' | 'UpdateExternalAccount' | 'PlatformPaused': Current status of the account
    - `PayoutsEnabled` boolean, nullable: Payouts Enabled status
    - `PaymentsEnabled` boolean, nullable: Payments Enabled status

## Other responses

- `400`: BadRequest
- `401`: Authentication has been denied for this request.
- `403`: Successful authentication, but authorization has been denied for this request.

---

[API](https://skmtc.dev/flipdish/apis/flipdish-open-api-v1-0.md) · [All operations](https://skmtc.dev/flipdish/apis/flipdish-open-api-v1-0/llms.txt) · [OpenAPI document](https://skmtc.dev/flipdish/apis/flipdish-open-api-v1-0/revisions/4d8c2b9e1c13?raw)