# Nylas App migration API

**Canonical:** https://apis.io/apis/nylas/nylas-app-migration-api/  
**Provider:** Nylas — https://apis.io/providers/nylas/  
**Base URL:** https://api.us.nylas.com  
**Documentation:** https://developer.nylas.com/docs/reference/api/applications/

Nylas App migration API is one of 40 APIs that [Nylas](https://apis.io/providers/nylas/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include App migration. The published artifact set on APIs.io includes an OpenAPI specification, an API reference, API documentation, a getting-started guide, authentication docs, and rate-limit docs.

Before you begin, you should already have: - Linked your v2 and v3 Nylas organizations. If you're not sure if your organizations are linked and you have a contract with us, [contact Nylas Support](/docs/support/#contact-nylas-support). - Created v3 applications to serve as the destinations for your v2 settings and connected account information. - [Set up equivalent provider auth apps as needed](/docs/v2/upgrade-to-v3/upgrade/auth/), especially if your users are authenticating with Microsoft. - [Set up v3 notification infrastructure](/docs/v2/upgrade-to-v3/upgrade/webhooks/). You'll use this to keep track of object that update while you're migrating your applications. You make Migration API requests using the v3 API route, using an API key from the destination v3 application. For each application to be migrated: 1. [Link apps](#post-/v3/migration-tools/link-v2v3-apps) 2. [Import app settings](#post-/v3/migration-tools/import-v2-app) 3. [Migrate a test user](#post-/v3/migration-tools/grants/-account_id-/clone) and/or [Start a batch migration](#post-/v3/migration-tools/snapshot-batch-clone) <div id="admonition-warning"><strong>Make sure you use the correct region!</strong> In Nylas v3, you mange applications for both the U.S. and E.U. regions using the same Dashboard. If you're migrating a v2 application to a v3 one, make sure you create the v3 application in the correct region. </div>

## Operations (5)

| Method | Path | Summary |
|---|---|---|
| POST | `/v3/migration-tools/link-v2v3-apps` | Link a v2 app to a v3 app |
| POST | `/v3/migration-tools/import-v2-app` | Import v2 app settings to linked v3 app |
| POST | `/v3/migration-tools/grants/{account_id}/clone` | Migrate v2 account to v3 grant |
| POST | `/v3/migration-tools/snapshot-batch-clone` | Batch clone v2 accounts to v3 grants |
| GET | `/v3/migration-tools/jobs` | Get migration jobs |

## Machine-readable artifacts (17)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/nylas/refs/heads/main/openapi/nylas-app-migration-api-openapi.yml
- **APIReference** — https://developer.nylas.com/docs/reference/notifications/
- **Documentation** — https://developer.nylas.com/docs/v3/notifications/
- **Documentation** — https://developer.nylas.com/docs/
- **APIReference** — https://developer.nylas.com/docs/reference/api/
- **GettingStarted** — https://developer.nylas.com/docs/v3/getting-started/
- **Authentication** — https://developer.nylas.com/docs/v3/auth/
- **RateLimits** — https://developer.nylas.com/docs/dev-guide/platform/rate-limits/
- **ErrorCodes** — https://developer.nylas.com/docs/api/errors/
- **Pricing** — https://www.nylas.com/pricing/
- **Signup** — https://dashboard-v3.nylas.com/register
- **StatusPage** — https://status.nylas.com/
- **SDKs** — https://github.com/nylas/nylas-nodejs
- **SDKs** — https://github.com/nylas/nylas-python
- **SDKs** — https://github.com/nylas/nylas-ruby
- **SDKs** — https://github.com/nylas/nylas-java
- **APIReference** — https://developer.nylas.com/docs/reference/api/application-level-templates/

## Other Nylas APIs (12)

- [Nylas Contacts API](https://apis.io/apis/nylas/nylas-contacts-api/)
- [Nylas Drafts API](https://apis.io/apis/nylas/nylas-drafts-api/)
- [Nylas Events API](https://apis.io/apis/nylas/nylas-events-api/)
- [Nylas Messages API](https://apis.io/apis/nylas/nylas-messages-api/)
- [Nylas Threads API](https://apis.io/apis/nylas/nylas-threads-api/)
- [Nylas Notetaker API](https://apis.io/apis/nylas/nylas-notetaker-api/)
- [Nylas Amazon SNS Notifications API](https://apis.io/apis/nylas/nylas-amazon-sns-notifications-api/)
- [Nylas Application-level templates API](https://apis.io/apis/nylas/nylas-application-level-templates-api/)
- [Nylas Application-level workflows API](https://apis.io/apis/nylas/nylas-application-level-workflows-api/)
- [Nylas Applications API](https://apis.io/apis/nylas/nylas-applications-api/)
- [Nylas Attachments API](https://apis.io/apis/nylas/nylas-attachments-api/)
- [Nylas Authentication APIs API](https://apis.io/apis/nylas/nylas-authentication-apis-api/)

## Tags

App migration

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/nylas/nylas-app-migration-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/nylas/.