Back to blog
Tutorials

Bulk-Importing Monitors from a CSV (From Any Provider)

Vantaj's CSV importer creates HTTP, ping, TCP, and SMTP monitors from a four-column spreadsheet - the universal escape hatch from Site24x7, Uptime.com, Freshping, Uptime Kuma, or any tool without a one-click importer.

Theo Cummings · July 5, 2026 · 6 min read

The one-click importers cover UptimeRobot, Pingdom, StatusCake, and Better Stack. But maybe you're coming from Site24x7, Uptime.com, Freshping, HetrixTools, or a self-hosted Uptime Kuma. Maybe your "monitoring tool" is a spreadsheet someone in ops maintains, or a Terraform file, or an infrastructure inventory that's never been monitored at all.

For all of those, there's the universal escape hatch: CSV bulk import. Every monitoring tool, spreadsheet, or inventory system can produce a CSV - and Vantaj can turn one into monitors in a single upload. The flow:

  • Build a CSV with four columns: name,type,target,interval (or download the in-app template)
  • Upload it under Settings → Import Monitors → Bulk import from CSV
  • Review the validated rows - errors are flagged per-row, duplicates deselected
  • Click Import and monitoring starts immediately

The format: four columns, one of them optional

The CSV is deliberately minimal so any source can produce it:

ColumnWhat goes in it
nameWhatever you want the monitor called
typehttp, ping, port, or smtp
targetA URL for http; a hostname or IP for ping and smtp; host:port for port
intervalOptional - like 30s, 1m, or 1h. Defaults to 5m

The header row is optional too. A complete, working example:

name,type,target,interval
Marketing site,http,https://acme.com,1m
API health,http,https://api.acme.com/health,30s
Office router,ping,203.0.113.7,5m
Postgres,port,db.acme.com:5432,1m
Mail server,smtp,mail.acme.com,5m

Don't want to start from a blank file? There's a downloadable template in-app: Settings → Import Monitors → Bulk import from CSV → Download template.

Upload, review, import

Upload the file and Vantaj validates every row before creating anything:

  • Errors are reported per-row. A malformed URL on line 7 doesn't block the other 40 rows - valid rows still import, and each bad row tells you exactly what's wrong with it.
  • Duplicates are auto-deselected. Rows matching monitors that already exist in Vantaj are flagged and unchecked, so re-uploading a CSV never creates copies.
  • Plan limits are enforced up front. If the file has more monitors than your plan allows, you find out before anything is created - not halfway through a partial import.

Click Import, and checks start immediately from multiple regions for every monitor created.

What CSV import doesn't carry

Honesty section. A four-column CSV carries monitor identity, not provider-specific configuration:

Keyword assertions, custom headers, expected status codes. These don't fit in the minimal format. Add them after import on the monitors that need them - or use a one-click importer if you're coming from a provider that has one, since those translate assertions automatically.

Heartbeats. Cron monitors need a ping URL generated per-monitor, so they can't come from a CSV. Create them in Heartbeats - it's a name and a schedule.

Alert channels and history. Same as every migration: set up Alerts & Notifications once in Vantaj and they apply to every monitor, and your uptime history starts fresh at import time.

Getting a CSV out of common tools

The export side is usually easier than people expect:

  • Uptime Kuma has a JSON backup (Settings → Backup). A ten-line script - or one prompt to an LLM with the JSON pasted in - converts it to the four-column format.
  • Most SaaS dashboards (Site24x7, Uptime.com, Freshping, HetrixTools) render their monitor list as a table you can select and paste straight into a spreadsheet, then rearrange into the four columns and export as CSV.
  • Anything with an API can be scripted: fetch the monitor list, print name,type,target,interval per line, done. The format is small enough that the script is trivial.
  • No tool at all? An infrastructure inventory, a DNS zone file, or a list of production URLs in a doc is a fine starting point - this is a chance to get things monitored that never were.

Why we built this

One-click importers are the best experience, but they'll never cover every source - there's a long tail of monitoring tools, and the longest tail of all is "a spreadsheet and good intentions." The CSV importer means no one is stuck re-typing URLs into a form, no matter where they're coming from.

Coming from a supported provider? The one-click importers carry more detail: UptimeRobot, Pingdom, StatusCake, and Better Stack.

Ready to try it? Create a free Vantaj account - 20 monitors free, no credit card - and see the full CSV import guide in the docs.