---
title: "Import v2 app settings to linked v3 app"
method: POST
path: "/v3/migration-tools/import-v2-app"
tags: ["App migration"]
---

# Import v2 app settings to linked v3 app

`POST /v3/migration-tools/import-v2-app`

Import the settings from a v2 Nylas application to its linked v3 application. Before you use this
endpoint, make sure you
[link a v2 application to a v3 application](/docs/reference/api/app-migration/migration_link_v2v3_apps/).

This endpoint imports the following v2 settings, and sets them to the corresponding v3 application
settings:

  - Your website URL.
  - Your icon URL (used to customize the Hosted OAuth page).
  - Redirect URIs for OAuth.
  - Integrations and their settings.
    - Nylas migrates Google integrations to equivalent v3 connectors.
    - If you have v2 Microsoft integrations, you should create a new Azure auth app and update the
    connector settings. For detailed instructions, see
    [Migrating Microsoft accounts](/docs/v2/upgrade-to-v3/upgrade/migrating-microsoft-accounts/).
    - Nylas migrates IMAP, iCloud, and EWS integrations to v3 connectors with auto-generated default
    values.

Nylas automatically detects your application ID from the API key and finds its linked v2
application to begin the import process.

This endpoint is rate limited to 20 requests per second, per Nylas application ID.

## Response `200`

Immedieately returns a list of two Jobs, Snapshot and BatchClone. Those Jobs continue to synchronously run in the background.

- object
  - `request_id` string — The request ID.
  - `data` string — Info message about success.

## Other responses

- `400` — Bad Request
- `401` — Not Authenticated

---

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