> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Pingdom

> Pingdom is a web performance monitoring service that allows users to monitor the uptime and performance of websites, servers, and applications.

![Pingdom logo](https://mintcdn.com/composio-preview/HvfZXDijhFOaKyF5/images/toolkits/pingdom.svg?fit=max\&auto=format\&n=HvfZXDijhFOaKyF5\&q=85\&s=937e1ba12fc1ab0f8679d60df2a2607a)

* **Category:** server monitoring
* **Auth:** API\_KEY
* **Composio-managed OAuth available?** N/A
* **Tools:** 13
* **Triggers:** 0
* **Slug:** `PINGDOM`
* **Version:** 20261101\_00

## Tools

> [accordion] Get Pingdom Alert Actions
>
> **Slug:** `PINGDOM_GET_ACTIONS_ALERTS`
>
> Requests generated alert actions for the Pingdom account, with check, user, channel and time parameters. The response may be empty or fail validation for the documented API response format.
>
> #### Input Parameters
>
> **via** `array`
>
> List of notification delivery channels to filter by. Tested values: 'email', 'sms'. Note: Other integration types may not be supported by this filter parameter.
>
> **limit** `integer`
>
> Maximum number of alert actions to return per request. Valid range: 1-100.
>
> **start** `integer`
>
> Starting index for pagination (offset). Use with limit for paginating through results.
>
> **endtime** `integer`
>
> Filter actions created/triggered before this Unix timestamp (in seconds). Use with starttime for time-range queries.
>
> **userids** `array`
>
> List of user IDs to filter actions. Only returns actions created by or assigned to these specific users.
>
> **checkids** `array`
>
> List of check IDs to filter actions. Only returns actions associated with these specific uptime/transaction checks.
>
> **starttime** `integer`
>
> Filter actions created/triggered after this Unix timestamp (in seconds). Use for time-range queries.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Checks List
>
> **Slug:** `PINGDOM_GET_CHECKS_LIST`
>
> Retrieves a list of all uptime/monitoring checks configured in Pingdom with optional filtering and pagination. Use this to: view all monitoring checks, filter by status/type/tags, search by name, or paginate through large check lists. Returns check details including ID, name, hostname, status, type, resolution, and optional tags.
>
> #### Input Parameters
>
> **name** `string`
>
> Filter checks by name (partial match allowed)
>
> **tags** `string`
>
> Comma-separated list of tags to filter checks
>
> **team** `integer`
>
> Filter checks by team ID
>
> **type** `string`
>
> Type of check to filter (e.g., http, tcp, udp)
>
> **limit** `integer`
>
> Maximum number of checks to return (1-250)
>
> **offset** `integer`
>
> Index of the first check to return for pagination (zero-based)
>
> **status** `string`
>
> Filter checks by status (up, down, paused)
>
> **probeids** `string`
>
> Comma-separated list of probe IDs for filtering checks
>
> **transaction** `boolean`
>
> If true, only return transaction checks
>
> **include\_tags** `boolean`
>
> If true, include tag details with each check
>
> **integrationids** `string`
>
> Comma-separated list of integration IDs for filtering
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Contact Details
>
> **Slug:** `PINGDOM_GET_CONTACT_DETAILS`
>
> Retrieves comprehensive details of a specific Pingdom alerting contact by ID, including all configured notification methods (email, SMS), team memberships, contact type, and pause status. Use this when you need complete information about a contact's notification configuration.
>
> #### Input Parameters
>
> **contactid** `integer` *required*
>
> Unique identifier of the alerting contact to retrieve
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Contacts
>
> **Slug:** `PINGDOM_GET_CONTACTS`
>
> Retrieves alerting contacts and their notification targets from Pingdom.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Credits
>
> **Slug:** `PINGDOM_GET_CREDITS`
>
> Retrieves Pingdom account credits and resource usage, including check and SMS information. Responses missing fields required by the tool may fail validation.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Maintenance Occurrences
>
> **Slug:** `PINGDOM_GET_LIST_MAINTENANCE_OCCURRENCES`
>
> Lists Pingdom maintenance occurrences, with optional time-range and maintenance window ID parameters. Use it to inspect scheduled occurrences and their associated maintenance windows.
>
> #### Input Parameters
>
> **limit** `integer`
>
> Maximum number of occurrences to return
>
> **offset** `integer`
>
> Start listing from this occurrence offset
>
> **to\_time** `integer`
>
> Unix timestamp marking the end of the time range for occurrences
>
> **from\_time** `integer`
>
> Unix timestamp marking the start of the time range to retrieve occurrences
>
> **maintenancewindowid** `integer`
>
> Filter occurrences by a specific maintenance window ID
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Maintenance Windows
>
> **Slug:** `PINGDOM_GET_MAINTENANCE_WINDOWS`
>
> Lists a user's Pingdom maintenance windows, with optional pagination and time-range parameters. Results can be empty even when maintenance windows exist.
>
> #### Input Parameters
>
> **limit** `integer`
>
> Number of maintenance windows per page (1-1000)
>
> **offset** `integer`
>
> Offset for pagination (zero-based)
>
> **to\_time** `integer`
>
> Only maintenance windows starting before this Unix timestamp
>
> **from\_time** `integer`
>
> Only maintenance windows starting after this Unix timestamp
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Probes
>
> **Slug:** `PINGDOM_GET_PROBES`
>
> Lists Pingdom probe servers used for uptime and transaction checks, with location, IP address and availability information. Use the results to identify monitoring locations or probe addresses for allowlisting.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Reference Data
>
> **Slug:** `PINGDOM_GET_REFERENCE_DATA`
>
> Retrieves Pingdom reference data including regions, timezones, datetime formats, number formats, and countries. This data is used for configuring Pingdom account settings, checks, and understanding available formatting options. Use this when you need to know valid timezone IDs, region configurations, or country codes for Pingdom operations.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Single Check
>
> **Slug:** `PINGDOM_GET_SINGLE_CHECK`
>
> Perform a single on-demand Pingdom check against a target host. This executes an immediate test from a specified probe (or random probe if not specified) and returns the result. Use this when you need a quick connectivity or performance test of a website, server, or service. Example uses: "Test if google.com is reachable", "Check response time for example.com from a specific region", "Verify HTTP status of api.mysite.com".
>
> #### Input Parameters
>
> **url** `string`
>
> Full URL path for HTTP checks (e.g., '/status')
>
> **host** `string` *required*
>
> Hostname or IP address to test
>
> **port** `integer`
>
> Port number for tcp/udp checks (1-65535)
>
> **type** `string ("ping" | "http" | "tcp" | "udp" | "dns")` *required*
>
> Type of check to perform
>
> **probeid** `integer`
>
> Pingdom probe ID to execute the check from. If not specified, a random probe will be used
>
> **expectedip** `string`
>
> Expected IP address for DNS checks. Required when type is 'dns'
>
> **stringtosend** `string`
>
> String to send to the server for TCP/UDP checks. Required for UDP checks
>
> **stringtoexpect** `string`
>
> String to expect in response for TCP/UDP checks
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Team Details
>
> **Slug:** `PINGDOM_GET_TEAM_DETAILS`
>
> Tool to fetch detailed information for a specific alerting team. Use after listing teams to get full members and integrations details.
>
> #### Input Parameters
>
> **teamid** `integer` *required*
>
> Unique identifier of the Pingdom alerting team
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Teams
>
> **Slug:** `PINGDOM_GET_TEAMS`
>
> Tool to retrieve all alerting teams and their members. Use after authenticating to Pingdom to manage team configurations.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get TMS Transaction Checks List
>
> **Slug:** `PINGDOM_GET_TMS_TRANSACTION_CHECKS_LIST`
>
> Lists Pingdom transaction (TMS) checks in a paginated overview, including their IDs, names, types and statuses. Transaction checks monitor workflows by running sequences of user interactions; use this list to find checks and review their current status.
>
> #### Input Parameters
>
> **limit** `integer`
>
> Maximum number of transaction checks to return per page (1-1000). Defaults to 1000 if not specified.
>
> **offset** `integer`
>
> Zero-based index to start returning transaction checks from. Use with limit for pagination (e.g., offset=0 for first page, offset=100 for second page with limit=100).
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not
