---
title: "Create Setup Flow link"
method: POST
path: "/integrations/{integration_id}/setup-link"
tags: ["General"]
---

# Create Setup Flow link

`POST /integrations/{integration_id}/setup-link`

Create a link that lets your customer run the [Setup Flow](/hris/features/setup-flow/introduction) for an integration. Use this to send customers back into setup steps like field mapping or employee filtering without having to go through the initial connection flow again. Pass the returned URL to `showKomboConnect` from the Kombo Connect SDK, the same way you do with a connection link.

The integration must have at least one Setup Flow step enabled (e.g. field mapping or employee filtering); otherwise this endpoint returns a `PLATFORM.INPUT_INVALID` error. Steps can be enabled from the Integration Settings tab in the dashboard or via the [Create Connection Link endpoint](./post-connect-create-link).

## Path parameters

- `integration_id` string, required

## Request body

- PostIntegrationsIntegrationIdSetupLinkRequestBody
  - `language` 'en' | 'de' | 'fr' | 'it' | 'es', nullable — Language of the setup flow UI.
  - `link_type` 'EMBEDDED' | 'MAGIC_LINK', required — The type of link you want to create. `EMBEDDED` is for the [embedded flow](../guides/connect/embedded-flow) using the Kombo Connect SDK (these links are valid for 1 hour) and `MAGIC_LINK` is for [magic links](../guides/connect/magic-links) which you send out manually to customers (these are valid for 1 year).

## Response `200`

POST /integrations/:integration_id/setup-link Positive response

- PostIntegrationsIntegrationIdSetupLinkPositiveResponse
  - `status` 'success', required
  - `data` object, required
    - `link` string, uri, required — The setup link URL to pass to the Kombo Connect SDK.

## Other responses

- `default` — The standard error response with just the platform error codes.

---

[API](https://skmtc.net/kombo/apis/kombo-api.md) · [All operations](https://skmtc.net/kombo/apis/kombo-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/kombo/kombo-api/revisions/1e45035b96d3/schema)