# Import from PagerDuty, JSM or Opsgenie

Migrate teams, users, rotations, schedules, and escalation policies from existing on-call providers into OnCallAlert in minutes. The migration tool operates in read-only mode against your existing tool—nothing in your current provider is modified or deleted.

## Supported Providers

- **PagerDuty**: Full migration of users, schedules, rotations, escalation policies, and services.
- **Jira Service Management (JSM)**: Migration of on-call teams, schedules, and default routing rules.
- **Opsgenie**: Migration of teams, rotations, escalation policies, and alert routing rules.

## Step 1: Gather API Credentials

- **PagerDuty**: Generate a Global REST API Key under **Integrations &rarr; API Access Keys** (read-only access).
- **Atlassian JSM**: Generate an Atlassian API Token from your Atlassian account profile and note your account email and organization domain.
- **Opsgenie**: Generate an API Key under **Settings &rarr; Integration list &rarr; API** (read access).

## Step 2: Run the Importer Preview

1. Sign in to OnCallAlert as an administrator.
2. Open **Admin &rarr; Migration** (`/admin/import`).
3. Select your source provider and input your credentials.
4. Click **Preview Migration**. OnCallAlert inspects your source configuration and displays a complete preview showing:
   - Users to be created
   - Schedules and rotations to be mapped
   - Escalation policies and services to be generated

## Step 3: Execute Migration

Click **Start Import**. The importer creates the corresponding entities inside your OnCallAlert database.

## Key Behaviors & Safety Guarantees

- **Safe to Re-Run**: Running the import multiple times skips already imported resources and only imports newly created items.
- **Non-Destructive**: Existing OnCallAlert services and schedules are preserved. Conflicts append a distinguishing suffix (e.g. `Primary - PagerDuty`).
- **User Roles**: Imported responders are assigned the standard user role. Administrators can promote specific users to Admin or Owner.
- **Mobile Push Configuration**: Mobile push device tokens cannot be copied across platforms. Responders install the OnCallAlert mobile app to pair their phones.
