---
title: "Migrate financial connection"
method: POST
path: "/v1/financial_connections/migrate"
tags: ["Financial Connections"]
---

# Migrate financial connection

`POST /v1/financial_connections/migrate`

This endpoint migrates financial connections from Plaid or MX into the unified Fuse API. It accepts a POST request with connection data, aggregator, entity, and Fuse products, and responds with a JSON payload containing the migrated connection's data, access token, ID, and request ID.

## Headers

- `Fuse-Client-Id` string, required
- `Fuse-Api-Key` string, required
- `Plaid-Client-Id` string
- `Plaid-Secret` string
- `Teller-Application-Id` string
- `Teller-Certificate` string
- `Teller-Private-Key` string
- `Teller-Token-Signing-Key` string
- `Teller-Signing-Secret` string
- `Mx-Client-Id` string
- `Mx-Api-Key` string
- `Snaptrade-Client-Id` string
- `Snaptrade-Consumer-Key` string
- `Flinks-Ca-Customer-Id` string
- `Flinks-Us-Customer-Id` string
- `Flinks-Us-Instance-Id` string
- `Flinks-Ca-Instance-Id` string
- `Mono-Public-Key` string
- `Mono-Secret-Key` string
- `Mono-Webhook-Secret` string
- `TrueLayer-Client-Id` string
- `TrueLayer-Client-Secret` string
- `Finverse-Client-Id` string
- `Finverse-Client-Secret` string
- `Belvo-Secret-Id` string
- `Belvo-Secret-Password` string
- `Finicity-Partner-Secret` string
- `Finicity-Partner-Id` string
- `Finicity-App-Key` string
- `Basiq-Api-Key` string
- `Akoya-Client-Id` string
- `Akoya-Client-Secret` string
- `SaltEdge-App-Id` string
- `SaltEdge-App-Secret` string

## Request body

- MigrateFinancialConnectionsTokenRequest
  - `connection_data` MigrateFinancialConnectionsAggregatorConnectionData, required — The input data for the financial connections to be migrated into the unified Fuse API.
    - `plaid` object — Details of the Plaid connection to migrate into the unified Fuse API.
      - `access_token` string, required — The Plaid access token associated with the user's financial accounts.
      - `use_item_webhook` boolean — If true, any webhooks received for this new financial connection will be sent to the webhook url used when the item was created. If false, the webhook url set at the organization sandbox/production environment level will be used instead.
    - `mx` object — Details of the MX connection to migrate into the unified Fuse API.
      - `user_guid` string, required — The unique identifier (GUID) of the user within the MX platform.
      - `member_guid` string — The unique identifier (GUID) of the member (connection) associated with the user within the MX platform.
    - `teller` object — Details of the Teller connection to migrate into the unified Fuse API.
      - `access_token` string, required — The Teller access token associated with the user's financial accounts.
  - `aggregator` 'plaid' | 'mx' | 'teller', required — The aggregator being migrated (either 'plaid', 'mx' or 'teller).
  - `entity` object, required
    - `id` string — The unique identifier of the entity (user or business) associated with the financial connections.
  - `fuse_products` string[], required — A list of Fuse products that the migrated connection will have access to.

## Response `200`

Success

- MigrateFinancialConnectionsTokenResponse
  - `connection_data` MigrateFinancialConnectionsAggregatorConnectionData, required — The input data for the financial connections to be migrated into the unified Fuse API.
    - `plaid` object — Details of the Plaid connection to migrate into the unified Fuse API.
      - `access_token` string, required — The Plaid access token associated with the user's financial accounts.
      - `use_item_webhook` boolean — If true, any webhooks received for this new financial connection will be sent to the webhook url used when the item was created. If false, the webhook url set at the organization sandbox/production environment level will be used instead.
    - `mx` object — Details of the MX connection to migrate into the unified Fuse API.
      - `user_guid` string, required — The unique identifier (GUID) of the user within the MX platform.
      - `member_guid` string — The unique identifier (GUID) of the member (connection) associated with the user within the MX platform.
    - `teller` object — Details of the Teller connection to migrate into the unified Fuse API.
      - `access_token` string, required — The Teller access token associated with the user's financial accounts.
  - `fuse_access_token` string, required — Fuse access token for the fuse connection
  - `fuse_financial_connection_id` string, required — Financial connection id for the fuse connection
  - `request_id` string — An identifier that is exclusive to the request and can serve as a means for investigating and resolving issues.

---

[API](https://skmtc.net/letsfuse/apis/sessions.md) · [All operations](https://skmtc.net/letsfuse/apis/sessions/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/letsfuse/sessions/revisions/816323e226dc/schema)