Skip to main content

Documentation

Complete guide to setting up website monitoring with PingZen. API documentation, code examples, and best practices.

Workspaces

Workspaces let you separate monitoring into isolated spaces. Each workspace has its own monitors, alerts, incidents, and status pages.

When to Use

Projects and contexts

Different products, client projects, personal versus work, a hobby thing on the side. Each workspace has its own list of monitors, and from inside one you do not see the other.

webapi

Environments

Production, staging and development in separate workspaces: the monitors and alerts of a staging box never mix with the real ones, and its incidents stay out of the shared feed.

prodstagingdev

Clients

For an agency, one workspace per client. You can invite a client into their own workspace and only that one — the rest stay invisible to them.

client-aclient-b

Features

Full isolation

Monitors, alerts and incidents do not overlap between workspaces.

prodstaging

Quick switching

Switch between workspaces with one click in the sidebar.

prodstagingdev

Default workspace

Set the workspace that opens when you log in.

prodstagingdev

How to Create

  1. Click on the current workspace name in the sidebar
  2. Select “Manage Workspaces”
  3. Click “Add Workspace”
  4. Enter a name and description
  5. Switch to the new workspace and add monitors

Export & Import Monitors (CSV)

On the Workspaces page you can save your monitors to a file, and add many monitors at once from a file.

  • Export monitors (button at the top) — saves every monitor from all your workspaces to one CSV file. The download icon on a workspace card saves just that one workspace. Anyone can export, even viewers. Passwords and tokens are never put in the file.
  • Import monitors (button at the top) — opens the import window. Drop a CSV file (or click to choose one) and pick where the monitors go: one workspace, or by the workspace column in the file. You then see a preview: which rows will be added, which already exist, and which will fail — and why. Nothing is added until you click to confirm.

The preview is only a guess. Two things are checked during the real import: a monitor name that is already used, and your plan limit. A big import is done one row at a time and can take a few minutes — keep the window open.

You only need a url column. To import, you must be the owner or an editor of the workspace. A file can have up to 500 rows / 1 MB. If some rows fail, click Download error rows to get only those rows with the reason, fix them, and upload again. For the full list of columns and the API, see the API Reference.

Move from another service

You can import files from other tools without changing anything — you do not need to rename columns, and both , and ; are detected automatically.

Moving fromWhere to get the fileWhat comes acrossWhat does not
PingZen (backup or move)Export monitors hereeverything except passwords/tokenspasswords, tokens, Authorization headers
StatusCakeExport Settings on the test list (a ; file)name, URL, type, check rate, keyword (and do-not-find), confirmation, timeoutcontact groups, locations, tags, basic-auth password
UptimeRobotsee the note belowname, URL/IP, type (word or number), interval, keyword, porttags, alert contacts, maintenance windows
HetrixToolstheir monitor CSV (Name,Target,Keyword,Port)name, target, keyword, port—

Steps (for any tool):

  1. Get the file from the other tool. Or make your own CSV — you only need a url column.
  2. Open Import monitors, drop the file, and look at the preview. It shows what will be added, skipped, or fail.
  3. Click to confirm. If some rows fail, use Download error rows, fix them, and upload again.

About UptimeRobot: their dashboard can only export logs, not the monitor settings. Instead, use a file in their bulk-upload format (Type, Friendly Name, URL/IP, Interval, Keyword Value, Port). Number types work too: 1 = HTTP, 2 = Keyword, 3 = Ping, 4 = Port.

Not yet supported: Uptime Kuma and Pingdom / Better Stack files (these are JSON — coming later). Excel files (.xlsx) are not accepted — save them as CSV UTF-8 first.

Team & Sharing

Share a workspace with colleagues so you can monitor together. Available on every plan, the Free one included.

Everyone works inside the workspace owner’s plan limits — a teammate on the Free plan still operates within your monitor and alert quotas while inside your workspace.

How Many People You Can Add

PlanTotal seatsColleagues
Free32
Pro54
Business1514
Enterprise5049

The owner takes one seat. Unclaimed invitations hold a seat too, until they are accepted, revoked, or expire.

Roles

ActionOwnerEditorViewer
View dashboard, monitors, incidents, statistics✅✅✅
Create / edit / delete monitors, run checks, reorder✅✅—
Create and manage their own alerts✅✅✅
See or edit other members’ alerts———
Status pages, maintenance, scheduled reports✅——
Invite / remove members, change roles✅——

Alerts are personal — each member configures and receives their own notifications, and no one can see another member’s alerts.

Heartbeat monitors follow the same roles: a viewer sees them, an editor creates, edits, pauses, and deletes them.

How to Add a User

  1. Open the workspace selector in the sidebar, then “Manage Workspaces”.
  2. On a workspace you own, click the members (👥) icon.
  3. Click “Invite member”, pick a role, and choose one of the two ways.

By email — when your colleague already has a PingZen account on that address. Access is granted right away.

We send them no email — tell them yourself, otherwise they simply won’t notice the new workspace in their switcher.

By link — when they have no account yet, or you don’t know which email they signed up with. PingZen gives you a one-time link valid for 14 days; send it over any messenger. Your colleague signs in with email, Google, Yandex, or Telegram, confirms joining on the screen that follows, and lands in the workspace. The link is shown once, so copy it immediately.

Removing a Member or Revoking an Invitation

Remove a member from the same dialog. Access is revoked immediately, and any alerts they created in that workspace are deactivated.

An unused invite link can be revoked in the same place — it stops working at once and frees the seat.

Workspaces API

Manage workspaces via REST API.

GET/api/v1/workspaces

List user's workspaces

POST/api/v1/workspaces

Create workspace

PUT/api/v1/workspaces/:id

Update workspace

DELETE/api/v1/workspaces/:id

Delete workspace (empty only)

POST/api/v1/workspaces/:id/set-default

Set default workspace

GET/api/v1/workspaces/:id/members

List workspace members

POST/api/v1/workspaces/:id/members

Invite a member by email (owner only)

PATCH/api/v1/workspaces/:id/members/:member_id

Change a member's role (owner only)

DELETE/api/v1/workspaces/:id/members/:member_id

Remove a member or revoke an invitation (owner only)

POST/api/v1/workspaces/:id/invites

Create a one-time invite link valid for 14 days — works for people without an account yet (owner only)

POST/api/v1/workspaces/invites/accept

Accept an invite link

Common Questions

What protocols can I monitor?

PingZen supports 23 protocols: HTTP/HTTPS, WebSocket (WS/WSS), TCP, UDP, ICMP Ping, gRPC, DNS, WHOIS, TLS/SSL certificates, Email (SMTP/IMAP/POP3), FTP/FTPS, DNSBL, PageSpeed, SOCKS5, MTProxy, API Check, and Transaction. You can monitor websites, APIs, servers, databases, and any network service.

How fast can I get alerts?

Telegram alerts are delivered within 1-2 seconds of detection. Slack and Discord notifications arrive almost instantly. You can configure multiple alert channels for redundancy.

Can I organize monitors by project?

Yes! PingZen supports workspaces, which let you organize monitors by project, environment, or team. Each workspace can have its own alert configurations and team members.

Is there an API for automation?

Absolutely. PingZen provides a full REST API with OpenAPI documentation. You can create, update, and delete monitors programmatically.

How do status pages work?

Status pages are public, branded pages showing your services' uptime. You can display real-time status and allow customers to subscribe for updates.

What happens if I reach my monitor limit?

We'll notify you when approaching your limit. You can pause some monitors or contact us for increased capacity. We never stop monitoring without warning, ensuring your critical services stay protected.

Ready to stop missing downtime?

Join thousands of teams who trust PingZen. Setup takes 30 seconds.