Nova Uptime

Referencia de la CLI

Monitoriza sitios web, comprueba la salud del email y gestiona toda tu cuenta de Nova Uptime desde la línea de comandos.

v1.0.0npm install -g novauptime
Quick Start

Quick Start

Get up and running in 30 seconds:

# Install globally
npm install -g novauptime

# Sign in with email OTP (no browser needed)
novauptime auth login

# Check your monitoring status
novauptime status

# List all domains
novauptime domains list

# Run an email health check
novauptime email-health check fliplink.me

# Add a new domain
novauptime domains add https://usegum.com --interval 300

Requires Node.js 18+ and a Nova Uptime account with a Pro or Agency plan. View plans

Installation

npm (recommended)

npm install -g novauptime

npx (no install)

npx novauptime status

Verify installation

novauptime --version

Authentication

Sign in directly from the CLI — no browser or dashboard required. Your API key is generated and saved automatically.

Option 1: Email OTP login (recommended)

novauptime auth login
# Choose "Sign in with email" → enter your email → enter the verification code
# Your API key is generated and saved automatically

Option 2: Environment variable

export NOVAUPTIME_API_KEY=your_key_here

Option 3: Per-command flag

novauptime status --api-key your_key_here

Priority: --api-key flag > NOVAUPTIME_API_KEY env > saved config

Global Options

FlagDescription
--api-key <key>API key (overrides config and env)
--jsonOutput as JSON (for scripting and piping)
--quietSuppress non-essential output
--versionShow CLI version
--helpShow help for any command
# JSON output for scripting
novauptime domains list --json | jq '.data[].url'

# Pipe to other tools
novauptime domains list --json --quiet | jq -r '.data[] | select(.currentState=="down") | .url'

Command Reference

13 command groups covering every Nova Uptime feature. Click to expand.

AuthenticationSign in or sign up via email OTP (no browser required)3 cmds
auth login

Sign in or sign up via email OTP, or enter an API key manually

novauptime auth login
$ novauptime auth login
? How would you like to authenticate?
  ❯ Sign in with email (existing or new account)
    Enter API key manually
? Enter your email: you@your-domain
  Verification code sent to your email.
? Enter the verification code: 1234
✓ Authenticated as you@your-domain
auth logout

Remove stored API key

novauptime auth logout
auth status

Show current authentication status

novauptime auth status
Status OverviewQuick overview of all your monitors1 cmd
status

Show monitoring status overview — domains up/down, recent incidents, email health grades

novauptime status
$ novauptime status

  Domains: 12 total | 11 up | 1 down
  URLs:     8 total |  8 active
  Recent:   2 incidents (last 24h)
  Email:    A avg grade
Domain MonitoringManage uptime monitors for your domains13 cmds
domains list

List all monitored domains

novauptime domains list [--page N] [--state up|down|degraded] [--tag TAG_ID]
  • ---page N — Page number (default 1)
  • ---state — Filter by state: up, down, degraded, unknown
  • ---tag — Filter by tag ID
domains get

Get domain details

novauptime domains get <id>
domains add

Add a new monitored domain

novauptime domains add <url> [--interval 300] [--timeout 30] [--name "My Site"]
  • ---interval — Check interval in seconds (59-86400)
  • ---timeout — Timeout in seconds
  • ---name — Display name
domains update

Update domain settings

novauptime domains update <id> [--interval 600] [--name "New Name"]
domains delete

Delete a monitored domain

novauptime domains delete <id>
domains pause

Pause monitoring

novauptime domains pause <id>
domains resume

Resume monitoring

novauptime domains resume <id>
domains history

Get check history (last 24h by default)

novauptime domains history <id> [--hours 48]
  • ---hours — Hours of history (max 720)
domains incidents

Get domain incidents

novauptime domains incidents <id> [--limit 10]
domains email-health

Run email health check for domain

novauptime domains email-health <id> [--fresh]
  • ---fresh — Skip cache, run fresh check
domains tag

Assign tags to domain

novauptime domains tag <id> <tagId1> [tagId2...]
domains bulk-update

Bulk update multiple domains

novauptime domains bulk-update --ids <id1,id2> [--interval 300]
domains bulk-delete

Delete multiple domains

novauptime domains bulk-delete --ids <id1,id2> [--confirm]
URL MonitoringMonitor URLs for content changes and screenshots13 cmds
urls list

List all monitored URLs

novauptime urls list [--page N] [--state active|changed|error]
urls get

Get URL details

novauptime urls get <id>
urls add

Add a new monitored URL

novauptime urls add <url> [--interval 3600] [--name "Pricing Page"]
urls update

Update URL settings

novauptime urls update <id> [--interval 10800]
urls delete

Delete a monitored URL

novauptime urls delete <id>
urls pause

Pause URL monitoring

novauptime urls pause <id>
urls resume

Resume URL monitoring

novauptime urls resume <id>
urls check-now

Trigger an immediate URL check

novauptime urls check-now <id>
urls changes

View content change history

novauptime urls changes <id> [--limit 20]
urls screenshots

View screenshot history

novauptime urls screenshots <id> [--limit 20]
urls tag

Assign tags to URL

novauptime urls tag <id> <tagId1> [tagId2...]
urls bulk-update

Bulk update multiple URLs

novauptime urls bulk-update --ids <id1,id2> [--interval 10800]
urls bulk-delete

Delete multiple URLs

novauptime urls bulk-delete --ids <id1,id2> [--confirm]
Email HealthCheck email deliverability for any domain1 cmd
email-health check

Run email health check — MX, SPF, DKIM, DMARC, Blacklist scan

novauptime email-health check <domain> [--fresh]
$ novauptime email-health check fliplink.me

  Score: 92/100 (A)
  MX:     ✓ 2 records found
  SPF:    ✓ v=spf1 ... -all
  DKIM:   ✓ Configured (google)
  DMARC:  ✓ p=reject
  Blacklist: ✓ Clean (0/60)
Free ChecksRun diagnostic checks without an account (no login required)6 cmds
check ssl

Check SSL certificate validity and expiry

novauptime check ssl <domain>
check expiry

Check domain registration expiry via WHOIS/RDAP

novauptime check expiry <domain>
check dns

Check a specific DNS record (spf, dkim, dmarc, mx)

novauptime check dns <type> <domain>
check inbox-risk

Inbox placement risk analysis for a domain

novauptime check inbox-risk <domain>
check domain-age

Domain age and registration date lookup

novauptime check domain-age <domain>
check campaign

Free campaign simulation (up to 20 domains)

novauptime check campaign --senders <domains> [--prospects <entries>]
Campaign SimulationRun cold email campaign simulations using credits5 cmds
campaign run

Run a campaign simulation

novauptime campaign run --senders <domains> [--prospects <entries>]
  • ---senders — Comma-separated sending domains
  • ---prospects — Comma-separated prospects or @filepath
campaign list

List recent simulation jobs

novauptime campaign list [--page N]
campaign status

Get status and results of a simulation job

novauptime campaign status <jobId>
campaign credits

Check your simulation credit balance

novauptime campaign credits
campaign download

Download CSV results

novauptime campaign download <jobId> <type>
  • -type — campaign, sender, or suggestion
Tags & FoldersOrganize domains with color-coded tags4 cmds
tags list

List all tags with domain counts

novauptime tags list
tags create

Create a new tag

novauptime tags create <name> [--color "#10b981"]
tags update

Update tag name or color

novauptime tags update <id> [--name "Production"] [--color "#ef4444"]
tags delete

Delete a tag

novauptime tags delete <id>
NotificationsView alerts and notification history5 cmds
notifications list

List notifications

novauptime notifications list [--type status_change] [--limit 20]
  • ---type — Filter: status_change, ssl_expiry, email_health_alert, url_content_change, ...
  • ---limit — Max results
notifications unread

Show unread notification count

novauptime notifications unread
notifications pause

Pause all notifications

novauptime notifications pause
notifications resume

Resume all notifications

novauptime notifications resume
notifications status

Show notification pause status

novauptime notifications status
IncidentsTrack downtime incidents across all domains1 cmd
incidents

List recent incidents with INC-XXXXXX codes

novauptime incidents [--limit 20]
$ novauptime incidents

  INC-A3F291  fliplink.me  DOWN  503  2h ago
  INC-B7E442  api.usegum.com  RESOLVED     5h ago
Team MembersInvite and manage team access4 cmds
team list

List team members and their access

novauptime team list
team invite

Invite a team member by email

novauptime team invite <email> [--domains <id1,id2>] [--write]
  • ---domains — Comma-separated domain IDs to grant access
  • ---write — Grant write access (default: read-only)
team remove

Remove a team member

novauptime team remove <membershipId>
team resend

Resend invite email

novauptime team resend <membershipId>
WebhooksManage HMAC-signed webhook integrations4 cmds
webhooks list

List webhooks for a domain

novauptime webhooks list --domain <id>
webhooks create

Create a webhook

novauptime webhooks create --domain <id> --url <endpoint> [--events status_change,ssl_expiry]
  • ---domain — Domain ID
  • ---url — Webhook endpoint URL
  • ---events — Comma-separated event types
webhooks delete

Delete a webhook

novauptime webhooks delete <id>
webhooks test

Send a test webhook payload

novauptime webhooks test <id>
AccountView account and plan info1 cmd
account

Show account details — email, plan, limits, usage

novauptime account
BillingView billing and payment history3 cmds
billing summary

Show current plan and usage

novauptime billing summary
billing history

Show payment history

novauptime billing history [--limit 10]
billing checkout

Create Stripe checkout link

novauptime billing checkout <pro|agency>
SettingsView and update account settings2 cmds
settings get

Show current settings

novauptime settings get
settings update

Update timezone or weekly report

novauptime settings update [--timezone America/New_York] [--weekly-report]
ConfigurationManage CLI settings3 cmds
config get

Get a config value

novauptime config get <key>
config set

Set a config value

novauptime config set <key> <value>
$ novauptime config set apiUrl https://api.novauptime.com
✓ Set apiUrl = https://api.novauptime.com
config path

Show config file location

novauptime config path

Common Use Cases

CI/CD Pipeline Check

# Post-deploy: verify site is up
novauptime domains get $DOMAIN_ID \
  --json --quiet | \
  jq -e '.data.currentState == "up"'

Bulk Add from File

# Add domains from a text file
cat domains.txt | while read url; do
  novauptime domains add "$url" \
    --interval 300 --quiet
done

Morning Health Check

# Quick status overview
novauptime status
novauptime incidents --limit 5

Email Audit Script

# Check email health for multiple domains
for d in fliplink.me usegum.com; do
  echo "--- $d ---"
  novauptime email-health check "$d"
done

Ready to get started?

Install the CLI and start monitoring from your terminal.

Get API KeyAPI Reference