Import monitors
Create many monitors at once from a JSON file.
Overview
Checkmate imports monitors from a JSON file. Use it to restore a backup or to move monitors from another Checkmate instance. The file format is the one Export monitors produces, so the easiest way to start is to export first and edit that file.
CSV files are not supported.
Importing monitors
- Navigate to Settings in the sidebar
- Open the Data tab
- In Import / Export monitors, click Import from JSON
- Select your
.jsonfile

The monitors are created in your current team and start checking right away.
Only Admins and Superadmins can import monitors.
File format
The file is a JSON array with one object per monitor. Each monitor needs a name and a type. Fields you leave out get default values, for example a 60-second check interval.
[
{
"name": "Marketing site",
"type": "http",
"url": "https://example.com",
"interval": 60000
},
{
"name": "Database port",
"type": "port",
"url": "db.example.com",
"port": 5432
}
]interval is in milliseconds. The full field list is in the OpenAPI spec at /api-docs on your Checkmate server, under POST /monitors/import/json.
Things to know
- Every import creates new monitors. Existing monitors are not matched or updated, so importing the same file twice gives you two copies of each monitor.
- IDs are replaced. Any
id,teamIdoruserIdin the file is ignored. The new monitors belong to your team and to you. - Notification channels are linked by ID. After importing into a different Checkmate instance, open each monitor and pick its notification channels again.
- Heartbeat slugs must be unique. The import stops if two heartbeat monitors in the file share a slug or if a slug is already in use in your team. Nothing is imported in that case.