Documentation

Everything you need to know to get started with Uptimely and monitor your services effectively.

Getting Started

Welcome to Uptimely! This guide will help you set up your first monitor and start tracking your website's uptime.

Creating Your First Monitor

  1. Log in to your Uptimely account
  2. Click the "Add Monitor" button on your dashboard
  3. Enter your website URL (e.g., https://example.com)
  4. Give your monitor a friendly name
  5. Select your check interval (1-5 minutes depending on your plan)
  6. Click "Create Monitor"

Your monitor will start checking immediately! You'll see the first results within your chosen interval.

Bulk Import Monitors

Need to add multiple monitors at once? Use the Bulk Add feature:

  1. Click "Bulk Add" from the Monitors page
  2. Enter one URL per line in the text area
  3. Set default settings for all monitors (interval, region, etc.)
  4. Click "Create All Monitors"

Understanding Checks

Check Results

Each check provides:

  • Status: UP, DOWN, or PENDING
  • Response Time: How long the server took to respond
  • Status Code: HTTP status code (200, 404, 500, etc.)
  • Summary: Brief description of the check result

Response Time Indicators

Green: Optimal (<1s)
Yellow: Moderate (1-2s)
Orange: Slow (>2s)
Red: Down or failed

Integrity Monitoring

Enable integrity monitoring to detect unexpected content changes. When enabled, Uptimely will alert you if your page content differs from the expected baseline.

Integrations

Slack Integration

Get instant notifications in your Slack workspace:

  1. Go to Settings → Alert Settings
  2. Create a Slack webhook at api.slack.com/messaging/webhooks
  3. Copy your webhook URL
  4. Paste it into the Slack Webhook URL field
  5. Click "Save Settings"
  6. Test with "Send Test Message"

Tip: You can create channel-specific webhooks to send alerts to different Slack channels based on monitor importance.

SMS Alerts

Receive critical alerts via SMS (Professional and Enterprise plans):

  1. Go to Settings → Alert Settings
  2. Scroll to the SMS Notifications section
  3. Enter phone numbers in international format (e.g., +1234567890)
  4. Add one number per line
  5. Click "Save Phone Numbers"
  6. Test with "Send Test SMS"

Note: Professional plans support 1 phone number, Enterprise supports up to 3.

Custom Webhooks

Trigger custom workflows when monitors change status:

Webhook requests include:

{
  "monitor_id": 123,
  "monitor_name": "My Website",
  "status": "DOWN",
  "response_time": 5234,
  "status_code": 500,
  "checked_at": "2025-11-03T10:30:00Z",
  "incident_id": 456
}

Incidents

What are Incidents?

An incident is created when a monitor detects downtime or issues. Incidents track the start time, duration, and resolution of outages.

Incident Lifecycle

  1. Opened: Monitor detects an issue (DOWN status or error)
  2. Alerts Sent: Notifications sent to configured channels
  3. Closed: Monitor returns to UP status
  4. Recovery Notification: Alert sent confirming recovery

Viewing Incidents

Access your incident history from:

  • Dashboard sidebar (recent incidents)
  • Incidents page (full history)
  • Individual monitor pages (monitor-specific incidents)

API Reference

Authentication

All API requests require authentication using your API key. Include it in the Authorization header:

Authorization: Bearer YOUR_API_KEY

Base URL

https://api.uptimely.co/v1

Example: List Monitors

GET /monitors

Response:
{
  "data": [
    {
      "id": 123,
      "name": "My Website",
      "url": "https://example.com",
      "status": "UP",
      "last_check": "2025-11-03T10:30:00Z"
    }
  ]
}

Need Full API Documentation?

Complete API documentation with all endpoints, parameters, and examples is available to authenticated users.

Contact us for API access