# Migrate

Move enterprise connections and directories from Polis, WorkOS, Auth0, a CSV/SAML archive or an `ImportBundle` with the import API or the [`ohauthcat migrate`](/get-started/cli-commands/#ohauthcat-migrate) CLI. Every import is planned and reviewed before it creates organizations, connections and directories, and each organization switches, and rolls back, on its own.

1. Choose [Polis](/migrate/from-polis/), [WorkOS](/migrate/from-workos/), [Auth0](/migrate/from-auth0/) or [CSV/SAML metadata](/migrate/csv-saml/) and create a plan.
2. Review items, blockers and `plan.source_skipped`. A skipped source object is absent from the bundle; a blocker describes work needed for an included object.
3. Check [imported-profile limits](/migrate/imported-profile-limits/), then run the import. Resolve configuration requirements, verify domains, test sign-ins and activate connections.
4. [Switch one organization](/migrate/cutover-and-rollback/), watch sign-ins and keep the old provider available for rollback.

Use [migration levers](/migrate/levers/) to decide which IdP settings change. Apps owning their callback can use [forwarding](/migrate/from-home-grown-saml/). [Session cutover](/migrate/session-cutover/) maps imported profiles; [export](/migrate/export/) produces portable configuration.

Imported bundles never carry passwords, OIDC client secrets, SCIM bearer tokens or SP private keys. Auth0 source credentials are used only during the request that reads the tenant and are never stored. Domain verification and activation are not inherited. The [WorkOS compatibility bridge](/migrate/compat-workos/) and [imported SAML ACS aliases](/sso/custom-domains/) are implemented backend capabilities.

The SDK migration helpers read per-organization routing and resolve authenticated legacy sessions in your application. They do not move traffic or validate an old provider token for you. Review the [cutover checklist](/migrate/cutover-and-rollback/) and [session resolver contract](/migrate/session-cutover/) before enabling them.
