---
title: "Create reconnection link"
method: POST
path: "/integrations/{integration_id}/relink"
tags: ["General"]
---

# Create reconnection link

`POST /integrations/{integration_id}/relink`

Create a link that will allow the user to reconnect an integration. This is useful if you want to allow your users to update the credentials if the old ones for example expired.

Embed this the same way you would [embed the connect link](/connect/embedded-flow). By default, the link will be valid for 1 hour.

### Example Request Body

```json
{
  "language": "en",
  "scope_config_id": "9Pv6aCFwNDEzPNmwjSsY9SQx",
  "link_type": "EMBEDDED"
}
```

## Path parameters

- `integration_id` string, required

## Request body

- PostIntegrationsIntegrationIdRelinkRequestBody
  - `language` 'en' | 'de' | 'fr' | 'it' | 'es', nullable — Language of the connection flow UI.
  - `scope_config_id` string, nullable — Specify a scope config which the integration will start using once the reconnection flow has been completed. This can be useful if you want to update the permissions of an integration, but only want the change to take effect once the user has updated their API credentials to prevent sync issues.
  - `link_type` 'EMBEDDED' | 'MAGIC_LINK' — 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 (there are valid for 1 year). This defaults to `EMBEDDED`, which is our recommended method of implementing the connection flow for a seamless user experience.

## Response `200`

POST /integrations/:integration_id/relink Positive response

- PostIntegrationsIntegrationIdRelinkPositiveResponse
  - `status` 'success', required
  - `data` object, required
    - `link` string, uri, required

## 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/149bf44faf1a/schema)