Pingdom
App · 20 actions
Monitor uptime checks, results, outages, alert contacts and maintenance windows.
Actions
| Action | What it does |
|---|---|
| Create http check | Creates an HTTP uptime check for a host with a name, and optionally how often it runs and whether it starts paused. |
| Create maintenance | Creates a maintenance window with a description, start and end time, and optionally the checks to pause during it. |
| Delete check | Deletes a check by its check ID, which stops its monitoring. |
| Delete maintenance | Deletes a maintenance window by its ID, so its checks are no longer paused during that time. |
| Get check | Gets one check by its check ID, including its host, type, status, resolution and last test results. |
| Get contact | Gets one alerting contact by its contact ID, including their email and phone notification targets. |
| Get credits | Gets your Pingdom account's credits, such as how many checks and SMS alerts you have used and have left. |
| Get maintenance | Gets one maintenance window by its ID, including its description, start and end times and the checks it covers. |
| Get performance | Gets a check's response times and uptime grouped by hour, day or week over a time range, by check ID. |
| Get team | Gets one alerting team by its team ID, including its name and members. |
| Get uptime summary | Gets a check's average response time over a time range, by check ID, optionally with uptime totals and broken down by country or probe. |
| List alerts | Lists the alerts Pingdom has sent, optionally filtered by time, check, user, delivery status or channel. |
| List checks | Lists the uptime checks in your Pingdom account, optionally filtered by tags, with each check's ID, name, host and current status. |
| List contacts | Lists the alerting contacts in your account, with each contact's ID, name and how they are notified. |
| List maintenance | Lists your maintenance windows, sorted as you choose, with each window's ID, description, times and checks. |
| List outages | Lists the up and down periods of a check, by check ID, within an optional time range. |
| List probes | Lists the probe servers Pingdom tests from, optionally only active ones, with each probe's location and IP address. |
| List results | Lists the raw test results of a check, by check ID, optionally filtered by time, probe, status or response time. |
| List teams | Lists the alerting teams in your account, with each team's ID, name and members. |
| Update check | Changes a check's name, host, test interval or paused state, by its check ID. |
Create http check
Creates an HTTP uptime check for a host with a name, and optionally how often it runs and whether it starts paused. Returns the new check's ID.
Inputs
- Name
nametextRequired - Check name
- Host
hosttextRequired - Target host
- Paused
pausedtrue/false - Paused.Default:
false. - Resolution
resolutionnumber - How often should the check be tested? (minutes)One of:
1,5,15,30,60. Default:5.
Outputs
dataobject- Response.
Example output
{
"data": {
"check": {
"id": 1,
"name": "example"
}
}
}Create maintenance
Creates a maintenance window with a description, start and end time, and optionally the checks to pause during it. Returns the new window's ID.
Inputs
- Description
descriptiontextRequired - Description
- Start time
start_timedate and timeRequired - Start time.
- End time
end_timedate and timeRequired - End time.
- Uptimeids
uptimeidslist - Identifiers of uptime checks to assign to the maintenance window - Comma separated Integers
Outputs
dataobject- Response.
Example output
{
"data": {
"maintenance": {
"id": 1
}
}
}Delete check
Deletes a check by its check ID, which stops its monitoring.
Inputs
- Check
check_idnumberRequired - Check ID.
Outputs
dataobject- Response.
Example output
{
"data": {}
}Delete maintenance
Deletes a maintenance window by its ID, so its checks are no longer paused during that time.
Inputs
- Maintenance ID
maintenance_idnumberRequired - Maintenance ID.
Outputs
dataobject- Response.
Example output
{
"data": {}
}Get check
Gets one check by its check ID, including its host, type, status, resolution and last test results.
Inputs
- Check
check_idnumberRequired - Check ID.
- Include teams
include_teamstrue/false - Include teams.Default:
false.
Outputs
dataobject- Response.
Example output
{
"data": {
"check": {
"hostname": "example",
"id": 1,
"name": "example",
"paused": false,
"resolution": 1,
"status": "example"
}
}
}Get contact
Gets one alerting contact by its contact ID, including their email and phone notification targets.
Inputs
- Contact ID
contact_idnumberRequired - Contact ID.
Outputs
dataobject- Response.
Example output
{
"data": {}
}Get credits
Gets your Pingdom account's credits, such as how many checks and SMS alerts you have used and have left.
Inputs
None.
Outputs
dataobject- Response.
Example output
{
"data": {}
}Get maintenance
Gets one maintenance window by its ID, including its description, start and end times and the checks it covers.
Inputs
- Maintenance ID
maintenance_idnumberRequired - Maintenance ID.
Outputs
dataobject- Response.
Example output
{
"data": {
"maintenance": {
"description": "example",
"id": 1
}
}
}Get performance
Gets a check's response times and uptime grouped by hour, day or week over a time range, by check ID.
Inputs
- Check
check_idnumberRequired - Check ID.
- From time
from_timedate and time - From time.
- To time
to_timedate and time - To time.
- Resolution
resolutiontext - Resolution.One of:
hour,day,week. Default:hour. - Includeuptime
includeuptimetrue/false - Includeuptime.Default:
false. - Probes
probestext - Probes.
- Order
ordertext - Order.One of:
asc,desc. Default:asc.
Outputs
dataobject- Response.
Example output
{
"data": {}
}Get team
Gets one alerting team by its team ID, including its name and members.
Inputs
- Alert team ID
alert_team_idnumberRequired - Alert team ID.
Outputs
dataobject- Response.
Example output
{
"data": {}
}Get uptime summary
Gets a check's average response time over a time range, by check ID, optionally with uptime totals and broken down by country or probe.
Inputs
- Check
check_idnumberRequired - Check ID.
- From time
from_timedate and time - From time.
- To time
to_timedate and time - To time.
- Probes
probestext - Probes.
- Includeuptime
includeuptimetrue/false - Includeuptime.Default:
false. - Bycountry
bycountrytrue/false - Bycountry.Default:
false. - Byprobe
byprobetrue/false - Byprobe.Default:
false.
Outputs
dataobject- Response.
Example output
{
"data": {}
}List alerts
Lists the alerts Pingdom has sent, optionally filtered by time, check, user, delivery status or channel. Returns one page; use the paging fields for the next page.
Inputs
- From time
from_timedate and time - From time.
- To time
to_timedate and time - To time.
- Limit
limitnumber - Limit.From 1 to 100. Default:
100. - Offset
offsetnumber - Offset.From 0 to 1000000. Default:
0. - Checkids
checkidstext - Checkids.
- Userids
useridstext - Userids.
- Status
statustext - Status.
- Via
viatext - Via.
Outputs
dataobject- Response.
Example output
{
"data": {}
}List checks
Lists the uptime checks in your Pingdom account, optionally filtered by tags, with each check's ID, name, host and current status. Returns one page; use the paging fields for the next page.
Inputs
- Limit
limitnumber - Limit.From 1 to 100. Default:
100. - Offset
offsetnumber - Offset.From 0 to 1000000. Default:
0. - Showencryption
showencryptiontrue/false - Showencryption.Default:
false. - Include tags
include_tagstrue/false - Include tags.Default:
false. - Include severity
include_severitytrue/false - Include severity.Default:
false. - Tags
tagstext - Tags.
Outputs
dataobject- Response.
Example output
{
"data": {
"checks": []
}
}List contacts
Lists the alerting contacts in your account, with each contact's ID, name and how they are notified.
Inputs
None.
Outputs
dataobject- Response.
Example output
{
"data": {
"contacts": []
}
}List maintenance
Lists your maintenance windows, sorted as you choose, with each window's ID, description, times and checks. Returns one page; use the paging fields for the next page.
Inputs
- Limit
limitnumber - Limit.From 1 to 100. Default:
100. - Offset
offsetnumber - Offset.From 0 to 1000000.
- Orderby
orderbytext - Orderby.One of:
description,from,to,effectiveto. - Order
ordertext - Order.One of:
asc,desc. Default:asc.
Outputs
dataobject- Response.
Example output
{
"data": {
"maintenance": []
}
}List outages
Lists the up and down periods of a check, by check ID, within an optional time range.
Inputs
- Check
check_idnumberRequired - Check ID.
- From time
from_timedate and time - From time.
- To time
to_timedate and time - To time.
- Order
ordertext - Order.One of:
asc,desc. Default:asc.
Outputs
dataobject- Response.
Example output
{
"data": {}
}List probes
Lists the probe servers Pingdom tests from, optionally only active ones, with each probe's location and IP address. Returns one page; use the paging fields for the next page.
Inputs
- Limit
limitnumber - Limit.From 1 to 100. Default:
100. - Offset
offsetnumber - Offset.From 0 to 1000000. Default:
0. - Onlyactive
onlyactivetrue/false - Onlyactive.Default:
false. - Includedeleted
includedeletedtrue/false - Includedeleted.Default:
false.
Outputs
dataobject- Response.
Example output
{
"data": {}
}List results
Lists the raw test results of a check, by check ID, optionally filtered by time, probe, status or response time. Returns one page; use the paging fields for the next page.
Inputs
- Check
check_idnumberRequired - Check ID.
- To time
to_timedate and time - To time.
- From time
from_timedate and time - From time.
- Probes
probestext - Default: all probes
- Status
statustext - Default: all statuses
- Limit
limitnumber - Limit.From 1 to 100. Default:
100. - Offset
offsetnumber - Offset.From 0 to 1000000. Default:
0. - Includeanalysis
includeanalysistrue/false - Includeanalysis.Default:
false. - Maxresponse
maxresponsenumber - Maxresponse.
- Minresponse
minresponsenumber - Minresponse.
Outputs
dataobject- Response.
Example output
{
"data": {}
}List teams
Lists the alerting teams in your account, with each team's ID, name and members.
Inputs
None.
Outputs
dataobject- Response.
Example output
{
"data": {
"teams": []
}
}Update check
Changes a check's name, host, test interval or paused state, by its check ID.
Inputs
- Check
check_idnumberRequired - Check ID.
- Name
nametext - Check name
- Host
hosttext - Target host
- Paused
pausedtrue/false - Paused.Default:
false. - Resolution
resolutionnumber - How often should the check be tested? (minutes)One of:
1,5,15,30,60. Default:5.
Outputs
dataobject- Response.
Example output
{
"data": {}
}