Import monitors from CSV, Uptime Kuma, UptimeRobot, Better Stack, Pingdom or StatusCake

Bulk-create monitors from a CSV file, an Uptime Kuma backup or an UptimeRobot, Better Stack, Pingdom or StatusCake API export. Preview every row, then confirm.

Updated By the Uptime Tracker team
  1. Open the import pageGo to Monitors → Import.
  2. Pick a source formatUnder Source format, select CSV, Uptime Kuma, UptimeRobot, Better Stack, Pingdom or StatusCake.
  3. Export from the other toolFor a competitor, run the command shown for that format with your own read-only API key to download a JSON file.
  4. Upload or paste the fileUse "Upload a file" or paste the contents into the text box.
  5. Preview the importChoose "Preview import" and review each row: create, duplicate, unsupported or invalid.
  6. ConfirmFix any invalid rows, then choose "Create N monitors". Copy new heartbeat URLs, which are shown only once.

You can create many monitors at once from a CSV file, an Uptime Kuma backup, or an export from UptimeRobot, Better Stack, Pingdom or StatusCake. Import is available on every plan. Nothing is created until you confirm, and imports are all-or-nothing.

Before you start

  • Any plan, and the owner, admin or operator role. Imported monitors count toward your plan's monitor and heartbeat slots.
  • Up to 200 monitors per file. Larger setups can be imported in several files.
  • For a competitor export: an API key for that tool (read-only where offered), and a terminal with curl and, for some tools, jq. Uptime Tracker never calls other vendors with your keys; you download the export yourself and upload the file.

CSV format

The CSV format is monitors.csv/v1. Required columns are name, kind and interval_seconds. Optional columns are target, http_method, dns_record_type, expected_value, timeout_seconds, heartbeat_grace_seconds and tags (separated by ;).

name,kind,interval_seconds,target,http_method,dns_record_type,expected_value,timeout_seconds,heartbeat_grace_seconds,tags
Homepage,http,300,https://www.example.com/,GET,,Welcome,10,,web;public
Postgres,tcp,300,db.example.com:5432,,,,10,,database
MX record,dns,600,example.com,,MX,mail.example.com,10,,dns
Nightly sync,heartbeat,3600,,,,,,600,jobs

The easiest way to get a valid file is Export current monitors (CSV) on the same page: an export can be re-imported unchanged.

Uptime Kuma backup

In Uptime Kuma, go to Settings → Backup → Export and download the JSON file. Then pick Uptime Kuma and upload it. HTTP and keyword monitors become HTTP(S) monitors, port monitors TCP, ping monitors Ping (ICMP), DNS monitors DNS record, push monitors heartbeats, and gRPC monitors gRPC health checks.

UptimeRobot

  1. In UptimeRobot, open My Settings → API and create a read-only API key.
  2. Download your monitors:
    curl -X POST https://api.uptimerobot.com/v2/getMonitors -d 'api_key=YOUR_READ_ONLY_KEY&format=json&limit=50' > uptimerobot.json
  3. With more than 50 monitors, repeat with &offset=50, 100 and so on into separate files, then combine them with jq -s . page*.json > uptimerobot.json.
  4. Pick UptimeRobot and upload the file.

HTTP, keyword, ping, port and heartbeat monitors are converted. Keywords were case-insensitive in UptimeRobot and are matched exactly here; custom status rules and request bodies are not imported.

Better Stack

  1. In Better Stack, copy an Uptime API token.
  2. Download monitors and heartbeats into one file:
    (curl -s -H "Authorization: Bearer $TOKEN" https://incidents.betterstack.com/api/v2/monitors; \
     curl -s -H "Authorization: Bearer $TOKEN" https://incidents.betterstack.com/api/v2/heartbeats) | jq -s . > betterstack.json
  3. With more than 50 monitors, also fetch each pagination.next URL and include those responses.
  4. Pick Better Stack and upload the file.

HTTP status, expected status code, keyword, keyword absence, ping, TCP, SMTP, IMAP, DNS and heartbeat monitors are converted. Heartbeat grace periods longer than an hour are shortened to one hour, and domain-expiry alerts are not imported (add a domain-expiry monitor instead).

Pingdom

  1. In Pingdom, create a read-only API token.
  2. Download every check with its details:
    curl -s -H "Authorization: Bearer $TOKEN" "https://api.pingdom.com/api/3.1/checks?include_tags=true" \
      | jq -r '.checks[].id' \
      | while read id; do curl -s -H "Authorization: Bearer $TOKEN" "https://api.pingdom.com/api/3.1/checks/$id"; done \
      | jq -s . > pingdom.json
  3. Pick Pingdom and upload the file.

HTTP, TCP, ping, DNS, SMTP and IMAP checks are converted. The plain /checks list also works, but it lacks URL paths, keywords and TCP ports, so the per-check details above give an exact copy. POST data is not imported; such checks are imported as GET.

StatusCake

  1. In StatusCake, create an API token.
  2. Download every uptime test with its details:
    curl -s -H "Authorization: Bearer $TOKEN" "https://api.statuscake.com/v1/uptime?limit=100" \
      | jq -r '.data[].id' \
      | while read id; do curl -s -H "Authorization: Bearer $TOKEN" "https://api.statuscake.com/v1/uptime/$id"; done \
      | jq -s . > statuscake.json
  3. Pick StatusCake and upload the file.

HTTP, HEAD, TCP, SSH, SMTP, ping and DNS tests are converted; SSH tests become TCP connection checks. The plain list also works but lacks keywords and ports.

What every competitor import does

  • Credentials and custom headers are never imported. Add them again as encrypted stored secrets on the monitor.
  • Monitors that were paused in the other tool are imported active.
  • Checks slower than hourly are imported with a 1-hour interval, the slowest here.
  • DNS checks use Uptime Tracker's resolvers; a specific nameserver from the other tool is not queried.
  • Types with no equivalent are listed as unsupported and skipped.

Review the preview

After Preview import, each row shows a status and any problems or notes:

  • create: will be created.
  • duplicate: matches an existing monitor and is skipped.
  • unsupported: a type that cannot be converted, skipped.
  • invalid: an error you must fix, for example an interval faster than your plan allows, a check type your plan does not include (ping needs Pro; gRPC, SMTP and IMAP need Team), or more monitors than your remaining slots. While any row is invalid, nothing is created.

The preview also shows the remaining standard and heartbeat slots on your plan, so you can see whether everything fits before you confirm.

Heartbeat URLs

Imported heartbeats get new URLs; old URLs from another tool do not carry over. After the import, the New heartbeat URLs table is shown only once. Use Copy all heartbeat URLs and update your jobs.

Troubleshooting

  • "The file is larger than 1024 KiB": split the export into several files of up to 200 monitors.
  • A row is invalid because of the interval or the check type: the source checked faster than your plan allows (5 minutes on Free, 60 seconds on Pro, 30 seconds on Team) or uses a check type your plan lacks. Edit or remove those entries in the file, or upgrade, then preview again.
  • The file is not recognized: make sure the selected source format matches the tool, and upload the raw JSON response (or a jq -s array of responses), not an edited copy.
  • Everything shows duplicate: those monitors were already imported. Duplicates are skipped safely.
FAQ

Frequently asked questions

How many monitors can I import at once?

Up to 200 per file, within the remaining monitor slots on your plan.

Does Uptime Tracker need my UptimeRobot or Pingdom API key?

No. You run the export command yourself with your own key and upload the resulting file. Uptime Tracker never calls other vendors with your keys.

Are passwords and headers imported?

No. Credentials and custom headers are never imported. Add them again as encrypted stored secrets.

Do my old heartbeat or push URLs keep working?

No. Imported heartbeats get new URLs, which are shown once after the import; copy them into your jobs.

Uptime Tracker

Start monitoring in under five minutes

Start on the free plan — commercial use allowed. No credit card required.

  • Free forever plan
  • No credit card
  • Cancel anytime