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
Different Projects
Separate monitoring between different projects or products.
Environments
Production, Staging, Development — each in its own workspace.
Separation
Separate monitoring by context — personal, work, hobby projects.
Clients
For agencies: a separate workspace for each client.
Features
Full Isolation
Monitors, alerts, and incidents don’t overlap between workspaces.
Quick Switching
Switch between workspaces with one click in the sidebar.
Default Workspace
Set the workspace that opens when you log in.
How to Create
- Click on the current workspace name in the sidebar
- Select “Manage Workspaces”
- Click “Add Workspace”
- Enter a name and description
- Switch to the new workspace and add monitors
Export & Import Monitors (CSV)
The Workspaces page is also the home of monitor backup and migration:
- Export monitors (header button) — downloads every monitor from all your workspaces as one CSV file. The per-card download icon exports just that workspace. Available to every role, including viewers; secret fields (passwords, tokens) are never included.
- Import monitors (header button) — opens the import dialog. Drop a CSV (or browse), pick a target — a specific workspace or route by the file’s
workspacecolumn — and the dialog immediately shows a preview: which rows would be created, skipped as duplicates, or fail, and why. Nothing is created until you confirm.
The preview is an estimate — monitor-name conflicts and plan limits are checked during the actual import. A large import runs row by row and can take a few minutes; keep the window open.
Files from UptimeRobot (bulk-upload template), StatusCake (Export Settings) and HetrixTools are accepted as-is — no column renaming. Only the url column is required. Importing needs the owner or editor role in the target workspace; up to 500 rows / 1 MB per file. If some rows fail, Download error rows gives you just the failures with reasons — fix and re-upload. Details and the API endpoints: API Reference.
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
| Plan | Total seats | Colleagues |
|---|---|---|
| Free | 3 | 2 |
| Pro | 5 | 4 |
| Business | 15 | 14 |
| Enterprise | 50 | 49 |
The owner takes one seat. Unclaimed invitations hold a seat too, until they are accepted, revoked, or expire.
Roles
| Action | Owner | Editor | Viewer |
|---|---|---|---|
| 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
- Open the workspace selector in the sidebar, then “Manage Workspaces”.
- On a workspace you own, click the members (👥) icon.
- 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.
List user's workspaces
Create workspace
Update workspace
Delete workspace (empty only)
Set default workspace
List workspace members
Invite a member by email (owner only)
Change a member's role (owner only)
Remove a member or revoke an invitation (owner only)
Create a one-time invite link valid for 14 days — works for people without an account yet (owner only)
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, 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.