Skip to main content
Pingdom logo
  • Category: server monitoring
  • Auth: API_KEY
  • Composio-managed OAuth available? N/A
  • Tools: 13
  • Triggers: 0
  • Slug: PINGDOM
  • Version: 20261101_00

Tools

Slug: PINGDOM_GET_ACTIONS_ALERTSRequests 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

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.
integer
Maximum number of alert actions to return per request. Valid range: 1-100.
integer
Starting index for pagination (offset). Use with limit for paginating through results.
integer
Filter actions created/triggered before this Unix timestamp (in seconds). Use with starttime for time-range queries.
array
List of user IDs to filter actions. Only returns actions created by or assigned to these specific users.
array
List of check IDs to filter actions. Only returns actions associated with these specific uptime/transaction checks.
integer
Filter actions created/triggered after this Unix timestamp (in seconds). Use for time-range queries.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PINGDOM_GET_CHECKS_LISTRetrieves 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

string
Filter checks by name (partial match allowed)
string
Comma-separated list of tags to filter checks
integer
Filter checks by team ID
string
Type of check to filter (e.g., http, tcp, udp)
integer
Maximum number of checks to return (1-250)
integer
Index of the first check to return for pagination (zero-based)
string
Filter checks by status (up, down, paused)
string
Comma-separated list of probe IDs for filtering checks
boolean
If true, only return transaction checks
boolean
If true, include tag details with each check
string
Comma-separated list of integration IDs for filtering

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PINGDOM_GET_CONTACT_DETAILSRetrieves 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

integer
required
Unique identifier of the alerting contact to retrieve

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PINGDOM_GET_CONTACTSRetrieves alerting contacts and their notification targets from Pingdom.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PINGDOM_GET_CREDITSRetrieves Pingdom account credits and resource usage, including check and SMS information. Responses missing fields required by the tool may fail validation.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PINGDOM_GET_LIST_MAINTENANCE_OCCURRENCESLists 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

integer
Maximum number of occurrences to return
integer
Start listing from this occurrence offset
integer
Unix timestamp marking the end of the time range for occurrences
integer
Unix timestamp marking the start of the time range to retrieve occurrences
integer
Filter occurrences by a specific maintenance window ID

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PINGDOM_GET_MAINTENANCE_WINDOWSLists a user’s Pingdom maintenance windows, with optional pagination and time-range parameters. Results can be empty even when maintenance windows exist.

Input Parameters

integer
Number of maintenance windows per page (1-1000)
integer
Offset for pagination (zero-based)
integer
Only maintenance windows starting before this Unix timestamp
integer
Only maintenance windows starting after this Unix timestamp

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PINGDOM_GET_PROBESLists 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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PINGDOM_GET_REFERENCE_DATARetrieves 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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PINGDOM_GET_SINGLE_CHECKPerform 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

string
Full URL path for HTTP checks (e.g., ‘/status’)
string
required
Hostname or IP address to test
integer
Port number for tcp/udp checks (1-65535)
string ("ping" | "http" | "tcp" | "udp" | "dns")
required
Type of check to perform
integer
Pingdom probe ID to execute the check from. If not specified, a random probe will be used
string
Expected IP address for DNS checks. Required when type is ‘dns’
string
String to send to the server for TCP/UDP checks. Required for UDP checks
string
String to expect in response for TCP/UDP checks

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PINGDOM_GET_TEAM_DETAILSTool to fetch detailed information for a specific alerting team. Use after listing teams to get full members and integrations details.

Input Parameters

integer
required
Unique identifier of the Pingdom alerting team

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PINGDOM_GET_TEAMSTool to retrieve all alerting teams and their members. Use after authenticating to Pingdom to manage team configurations.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PINGDOM_GET_TMS_TRANSACTION_CHECKS_LISTLists 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

integer
Maximum number of transaction checks to return per page (1-1000). Defaults to 1000 if not specified.
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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not