---
title: "Migrate Connection"
method: POST
path: "/v2/businesses/{uuid}/connection/migrate"
tags: ["Businesses"]
---

# Migrate Connection

`POST /v2/businesses/{uuid}/connection/migrate`

## Request

- Base URL: `https://api.railz.ai`
- URL: `https://api.railz.ai/v2/businesses/{uuid}/connection/migrate`
- Auth: HTTP bearer

## Path parameters

- `uuid` string, required

## Request body

- ConnectionMigrationDto
  - `serviceName` 'quickbooks' | 'xero' | 'freshbooks' | 'dynamicsBusinessCentral' | 'sageBusinessCloud' | 'zohoBooks' | 'wave' | 'plaid', required
  - `accessToken` string
  - `refreshToken` string
  - `accountId` string
  - `location` 'com' | 'eu' | 'in' | 'au' | 'jp' | 'ca'

## Response `200`

- ConnectionMigrationResponseDto
  - `connectionUuid` string, required

## Other responses

- `400`: Bad Request Error - Thrown if fields sent via query does not follow specifications
- `401`: Unauthorized - Not logged in or log in expired
- `403`: Forbidden - Not enough permission
- `500`: Server Error

## Changes

- **2026-08-10** `5cdfae3fa1fa`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/railz/apis/fis-accounting-data-as-a-service-api/changes/v2/businesses/:uuid/connection/migrate/post.md)

---

[API](https://skmtc.dev/railz/apis/fis-accounting-data-as-a-service-api.md) - [All operations](https://skmtc.dev/railz/apis/fis-accounting-data-as-a-service-api/llms.txt) - [OpenAPI document](https://skmtc.dev/railz/apis/fis-accounting-data-as-a-service-api/revisions/1383b9a47ac9?raw)
