---
title: "Import Organization Snapshot"
method: POST
path: "/admin/organizations/import-snapshot"
tags: ["organization-admin"]
---

# Import Organization Snapshot

`POST /admin/organizations/import-snapshot`

## Request

- Base URL: `https://api.traversal.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.traversal.com/admin/organizations/import-snapshot`
- Auth: none declared

Import an existing organization's DB-only provisioning rows.

Platform admin only. This preserves source IDs and does not provision
Auth0 resources.

## Request body

- ImportOrganizationSnapshotRequest: Request to import an existing organization's provisioning rows.
  - `organization` OrganizationSnapshot, required: Organization row included in an organization snapshot import.
    - `id` string, required
    - `name` string, required
    - `display_name` string, nullable, required
    - `config_name` string, required
    - `auth0_id` string, nullable, required
    - `auth_provider` string, nullable
    - `org_identifier` string, nullable
    - `created_at` string, date-time, nullable
    - `archived_at` string, date-time, nullable
    - `is_invite_only` boolean
    - `metadata` object, nullable
  - `email_domains` EmailDomainInput[]
    - `domain` string, required: Email domain (e.g., 'example.com')
  - `auth_methods` AuthMethodInput[]
    - `name` string, required: Friendly name for the auth method (e.g., 'Google')
    - `connection_id` string, required: Auth0 connection ID (e.g., 'google-oauth2', 'con_abc123')
  - `org_connectors` OrgConnectorInput[]
    - `name` string, required: Connector display name
    - `url` string, required: Connector URL
    - `description` string, nullable: Optional description

## Response `200`

Successful Response

- ImportOrganizationSnapshotResponse: Response after importing an organization snapshot.
  - `organization` OrganizationDetail, required: Detailed organization information for admin views.
    - `id` string, required
    - `name` string, required
    - `display_name` string, nullable, required
    - `config_name` string, required
    - `auth0_id` string, nullable, required
    - `auth_provider` string, nullable, required
    - `org_identifier` string, nullable, required
    - `created_at` string, date-time, required
    - `archived_at` string, date-time, nullable, required
    - `is_invite_only` boolean
    - `email_domains` EmailDomain[], required
      - `id` string, required
      - `domain` string, required
      - `created_at` string, date-time, required
    - `auth_methods` AuthMethod[], required
      - `id` string, required
      - `name` string, required
      - `connection_id` string, required
      - `created_at` string, date-time, required
    - `metadata` object, nullable, required
  - `imported` boolean, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/traversal/apis/traversal-api.md) - [All operations](https://skmtc.dev/traversal/apis/traversal-api/llms.txt) - [OpenAPI document](https://skmtc.dev/traversal/apis/traversal-api/revisions/31e1a8b7cf89?raw)