# Pingdom

> Monitor uptime checks, results, outages, alert contacts and maintenance windows.

App · 20 actions. Web page: https://docs.lodol.com/docs/integrations/pingdom

## Actions

### 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 (`name`, text, required): Check name
- Host (`host`, text, required): Target host
- Paused (`paused`, true/false): Paused. Default: `false`.
- Resolution (`resolution`, number): How often should the check be tested? (minutes). One of: `1`, `5`, `15`, `30`, `60`. Default: `5`.

**Outputs**

- `data` (object): Response.

**Example output**

```json
{
  "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 (`description`, text, required): Description
- Start time (`start_time`, date and time, required): Start time.
- End time (`end_time`, date and time, required): End time.
- Uptimeids (`uptimeids`, list): Identifiers of uptime checks to assign to the maintenance window - Comma separated Integers

**Outputs**

- `data` (object): Response.

**Example output**

```json
{
  "data": {
    "maintenance": {
      "id": 1
    }
  }
}
```

### Delete check

Deletes a check by its check ID, which stops its monitoring.

**Inputs**

- Check (`check_id`, number, required): Check ID.

**Outputs**

- `data` (object): Response.

**Example output**

```json
{
  "data": {}
}
```

### Delete maintenance

Deletes a maintenance window by its ID, so its checks are no longer paused during that time.

**Inputs**

- Maintenance ID (`maintenance_id`, number, required): Maintenance ID.

**Outputs**

- `data` (object): Response.

**Example output**

```json
{
  "data": {}
}
```

### Get check

Gets one check by its check ID, including its host, type, status, resolution and last test results.

**Inputs**

- Check (`check_id`, number, required): Check ID.
- Include teams (`include_teams`, true/false): Include teams. Default: `false`.

**Outputs**

- `data` (object): Response.

**Example output**

```json
{
  "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_id`, number, required): Contact ID.

**Outputs**

- `data` (object): Response.

**Example output**

```json
{
  "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**

- `data` (object): Response.

**Example output**

```json
{
  "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_id`, number, required): Maintenance ID.

**Outputs**

- `data` (object): Response.

**Example output**

```json
{
  "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_id`, number, required): Check ID.
- From time (`from_time`, date and time): From time.
- To time (`to_time`, date and time): To time.
- Resolution (`resolution`, text): Resolution. One of: `hour`, `day`, `week`. Default: `hour`.
- Includeuptime (`includeuptime`, true/false): Includeuptime. Default: `false`.
- Probes (`probes`, text): Probes.
- Order (`order`, text): Order. One of: `asc`, `desc`. Default: `asc`.

**Outputs**

- `data` (object): Response.

**Example output**

```json
{
  "data": {}
}
```

### Get team

Gets one alerting team by its team ID, including its name and members.

**Inputs**

- Alert team ID (`alert_team_id`, number, required): Alert team ID.

**Outputs**

- `data` (object): Response.

**Example output**

```json
{
  "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_id`, number, required): Check ID.
- From time (`from_time`, date and time): From time.
- To time (`to_time`, date and time): To time.
- Probes (`probes`, text): Probes.
- Includeuptime (`includeuptime`, true/false): Includeuptime. Default: `false`.
- Bycountry (`bycountry`, true/false): Bycountry. Default: `false`.
- Byprobe (`byprobe`, true/false): Byprobe. Default: `false`.

**Outputs**

- `data` (object): Response.

**Example output**

```json
{
  "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_time`, date and time): From time.
- To time (`to_time`, date and time): To time.
- Limit (`limit`, number): Limit. From 1 to 100. Default: `100`.
- Offset (`offset`, number): Offset. From 0 to 1000000. Default: `0`.
- Checkids (`checkids`, text): Checkids.
- Userids (`userids`, text): Userids.
- Status (`status`, text): Status.
- Via (`via`, text): Via.

**Outputs**

- `data` (object): Response.

**Example output**

```json
{
  "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 (`limit`, number): Limit. From 1 to 100. Default: `100`.
- Offset (`offset`, number): Offset. From 0 to 1000000. Default: `0`.
- Showencryption (`showencryption`, true/false): Showencryption. Default: `false`.
- Include tags (`include_tags`, true/false): Include tags. Default: `false`.
- Include severity (`include_severity`, true/false): Include severity. Default: `false`.
- Tags (`tags`, text): Tags.

**Outputs**

- `data` (object): Response.

**Example output**

```json
{
  "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**

- `data` (object): Response.

**Example output**

```json
{
  "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 (`limit`, number): Limit. From 1 to 100. Default: `100`.
- Offset (`offset`, number): Offset. From 0 to 1000000.
- Orderby (`orderby`, text): Orderby. One of: `description`, `from`, `to`, `effectiveto`.
- Order (`order`, text): Order. One of: `asc`, `desc`. Default: `asc`.

**Outputs**

- `data` (object): Response.

**Example output**

```json
{
  "data": {
    "maintenance": []
  }
}
```

### List outages

Lists the up and down periods of a check, by check ID, within an optional time range.

**Inputs**

- Check (`check_id`, number, required): Check ID.
- From time (`from_time`, date and time): From time.
- To time (`to_time`, date and time): To time.
- Order (`order`, text): Order. One of: `asc`, `desc`. Default: `asc`.

**Outputs**

- `data` (object): Response.

**Example output**

```json
{
  "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 (`limit`, number): Limit. From 1 to 100. Default: `100`.
- Offset (`offset`, number): Offset. From 0 to 1000000. Default: `0`.
- Onlyactive (`onlyactive`, true/false): Onlyactive. Default: `false`.
- Includedeleted (`includedeleted`, true/false): Includedeleted. Default: `false`.

**Outputs**

- `data` (object): Response.

**Example output**

```json
{
  "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_id`, number, required): Check ID.
- To time (`to_time`, date and time): To time.
- From time (`from_time`, date and time): From time.
- Probes (`probes`, text): Default: all probes
- Status (`status`, text): Default: all statuses
- Limit (`limit`, number): Limit. From 1 to 100. Default: `100`.
- Offset (`offset`, number): Offset. From 0 to 1000000. Default: `0`.
- Includeanalysis (`includeanalysis`, true/false): Includeanalysis. Default: `false`.
- Maxresponse (`maxresponse`, number): Maxresponse.
- Minresponse (`minresponse`, number): Minresponse.

**Outputs**

- `data` (object): Response.

**Example output**

```json
{
  "data": {}
}
```

### List teams

Lists the alerting teams in your account, with each team's ID, name and members.

**Inputs**: None.

**Outputs**

- `data` (object): Response.

**Example output**

```json
{
  "data": {
    "teams": []
  }
}
```

### Update check

Changes a check's name, host, test interval or paused state, by its check ID.

**Inputs**

- Check (`check_id`, number, required): Check ID.
- Name (`name`, text): Check name
- Host (`host`, text): Target host
- Paused (`paused`, true/false): Paused. Default: `false`.
- Resolution (`resolution`, number): How often should the check be tested? (minutes). One of: `1`, `5`, `15`, `30`, `60`. Default: `5`.

**Outputs**

- `data` (object): Response.

**Example output**

```json
{
  "data": {}
}
```
