---
title: "Create an Onboarding Form Link"
method: POST
path: "/onboarding_forms/{onboarding_form_id}/links"
tags: ["Onboarding Forms"]
---

# Create an Onboarding Form Link

`POST /onboarding_forms/{onboarding_form_id}/links`

Create a link that lets users resume their `Onboarding Form`.

## Headers

- `Finix-Version` string
- `Content-Type` string

## Request body

- OnboardingLinkDetails — The information of the initial onboarding link. This is only provided when creating an `onboarding_form`.
  - `expiration_in_minutes` integer, required — How long (in minutes) the link should be valid for. Defaults to 60 minutes.
  - `expired_session_url` string, required — The URL users get sent to if the bearer token expires.
  - `fee_details_url` string, required — The URL of the page where you display the fees related to processing payments (for more info, see [Onboarding Forms](/guides/platform-payments/onboarding-sellers/seller-onboarding-forms/)).
  - `merchant_max_transaction_amount` integer — The maximum transaction amount for the merchant's card payment processing.
  - `merchant_ach_max_transaction_amount` integer — The maximum transaction amount for the merchant's ACH payment processing.
  - `return_url` string, required — The URL users get sent to after completing the onboarding flow.
  - `terms_of_service_url` string, required — Your Terms of Service URL. The URL is provided to users for consent along with Finix's Terms of Service.

## Response `201`

A single Onboarding Link

- OnboardingLink — The information of the initial onboarding link. This is only provided when creating an `onboarding_form`.
  - `expires_at` string — A UTC timestamp detailing when the onboarding form expires and will no longer be available via `link_url`. To generate a new link to the same form, see [Get an Onboarding Form URL](/guides/platform-payments/onboarding-sellers/seller-onboarding-forms/#fetching-an-onboarding-form-link).
  - `link_url` string — The URL of the user's Finix Onboarding Form. Users can use the `link_url` to return to the form until the link expires.

## Other responses

- `400` — Bad Request. The server cannot process the request due to malformed syntax or invalid data.
- `401` — Unauthorized. Authentication is required and has failed or has not been provided.
- `403` — Forbidden. The client is authenticated but does not have permission to access the resource.
- `406` — Not Acceptable. The server could not accept the submitted request. Confirm how the request was formatted and submitted.

---

[API](https://skmtc.dev/finix/apis/finix-api-reference.md) · [All operations](https://skmtc.dev/finix/apis/finix-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/finix/finix-api-reference/revisions/0cf4cdf27361/schema)