Skip to main content

​
Overview

Custom Sources let you monitor services that aren’t part of StatusStack’s 5,200+ pre-built integrations. This includes internal APIs, private infrastructure, and unlisted status page providers that your organization depends on.

URL-Based Sources

Point to any status page URL and StatusStack auto-detects the provider type

Manual Sources

Create sources for internal services without public status pages

​
Source Types

​
URL-Based Sources

If the service you want to monitor has a status page that isn’t already tracked by StatusStack, you can add it by providing the URL. StatusStack automatically detects the status page type and begins monitoring. Auto-detected providers:
  • Statuspage.io
  • BetterStack (BetterUptime)
  • Instatus
  • AWS Health Dashboard
  • Google Cloud Status
  • Microsoft Azure Status
  • GitHub Status
  • Cachet

​
Manual Sources

For internal services that don’t have a public status page, create a manual source. You manage the status of these sources directly from the dashboard or via the API. Common use cases:
  • Internal microservices and APIs
  • On-premise infrastructure
  • Private SaaS tools without public status pages
  • Development and staging environments

​
Creating a Custom Source

1

Navigate to My Services

In the customer dashboard, go to Monitoring → My Services or visit /dash/custom-sources.
2

Click Create

Click the Create Custom Source button to open the creation form.
3

Choose Source Type

Select whether this is a URL-based source (has a status page) or a Manual source (no public page).
4

Configure Details

Provide the source name and, for URL-based sources, the status page URL. StatusStack validates the URL and auto-detects the provider type.
5

Save and Monitor

Save the source. StatusStack begins polling URL-based sources immediately. Manual sources start in an Operational state.

​
URL Validation and Security

StatusStack validates all custom source URLs to prevent abuse:
  • URLs must use http:// or https:// protocols
  • Private and reserved IP ranges are blocked (e.g., 10.x.x.x, 192.168.x.x, 127.0.0.1)
  • DNS resolution is performed to detect encoded IP attacks
  • Both IPv4 and IPv6 addresses are validated
Custom source URLs must point to publicly accessible status pages. StatusStack cannot monitor URLs behind VPNs or firewalls. For internal services without public endpoints, use Manual sources instead.

​
Managing Custom Sources

Once created, custom sources appear in your My Services dashboard alongside any relevant details:

​
Viewing Source Status

Each custom source displays:
  • Current operational status
  • Status page type (for URL-based sources)
  • Last checked timestamp
  • Component breakdown (if applicable)

​
Editing a Source

Update the source name, URL, or configuration from the edit page. Changes to URLs trigger a fresh detection of the status page type.

​
Deleting a Source

Remove sources you no longer need. This also removes the source from any Stacks it was added to.

​
Organization Limits

Each organization can create up to 10 custom sources by default. This limit applies across all teams within the organization.
PlanCustom Source Limit
Free10
Pro10
EnterpriseCustom (contact sales)
Need more custom sources? Contact our sales team to discuss enterprise limits.

​
Adding Custom Sources to Stacks

Custom sources work like any other source in StatusStack. After creating one, you can add it to your Stacks:
  1. Navigate to the Stack you want to add the source to
  2. Click Add Component
  3. Search for your custom source by name
  4. Select the source and its components
  5. The source status now contributes to the Stack’s overall health

​
Best Practices

Use clear, descriptive names that identify the service and environment:
  • Internal User API (Production)
  • Warehouse Management System
  • Partner Portal Status Page
If the service has any kind of status page, prefer URL-based sources over manual ones. This gives you automated monitoring without manual status updates.
For internal services, pair a manual custom source with a Custom Monitor pointing to the service’s health endpoint. This gives you both status tracking and uptime monitoring.
Custom sources are scoped to your organization. Coordinate with your team to avoid creating duplicate sources for the same internal service.

Sources Concept

Understanding sources in StatusStack

Custom Monitoring

Set up website and API health checks

Creating Stacks

Organize sources into Stacks

Adding Services

Add sources and components to your Stacks