> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stackone.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Checkmk

> How to set up the Checkmk connector, plus the actions and events that are available.

![Checkmk](https://stackone-logos.com/api/checkmk/filled/svg)

v2.0.0[See changelog](https://docs.stackone.com/connectors/checkmk/changelog.md)

[68 actions](#actions) · [20 events](#events) · 2 auth methods

Observability

## Getting Started

**1. Create or Select a Project**

Set up a new project or select an existing one. See [Organizations & Projects](https://docs.stackone.com/gateway/concepts/organizations-and-projects.md).

**2. Configure the Connector**

Enable the connector and create a Connector Profile in your project. See [Setup Connector Profile](https://docs.stackone.com/gateway/quickstart.md#setup-connector-profile).

> [card] [Automation User (Basic) · Connector Profile](https://docs.stackone.com/connectors/checkmk/guides/connector-profile/automation-user-basic.md)
>
> Signs in with an automation user's username and secret as a standard username and password. Choose this if your Checkmk...

> [card] [Automation User (Bearer) · Connector Profile](https://docs.stackone.com/connectors/checkmk/guides/connector-profile/automation-user-bearer.md)
>
> Signs in with an automation user's username and secret as a Bearer token. This is the method Checkmk recommends for scri...

Optionally, configure receiving Events for Checkmk into StackOne.

> [card] [Webhooks setup](https://docs.stackone.com/connectors/checkmk/guides/webhook-setup.md)

**3. Link an Account**

Link an account [from the dashboard](https://docs.stackone.com/connect/managing-connectors/linking-accounts.md#link-from-the-dashboard) (or via [StackOne Hub](https://docs.stackone.com/embed/account-linking/overview)).

See the guide for the authentication type chosen in the Connector Profile:

> [card] [Automation User (Basic) · Link Account](https://docs.stackone.com/connectors/checkmk/guides/link-account/automation-user-basic.md)

> [card] [Automation User (Bearer) · Link Account](https://docs.stackone.com/connectors/checkmk/guides/link-account/automation-user-bearer.md)

**4. Use Actions**

Connect an AI platform to the linked account's actions. See [AI Platforms](https://docs.stackone.com/ai-platforms/overview.md).

Other ways to call actions are listed in [Protocols & SDKs](https://docs.stackone.com/connect/protocols-and-sdks.md).

## Actions

Authentication type

Select all
|
Clear

Automation User (Basic)

Automation User (Bearer)

No auth methods found

68 actions

ActionDescription

Create Host`checkmk_create_host`

Create a new host in Checkmk

List Hosts`checkmk_list_hosts`

List all configured hosts in Checkmk

Show Host`checkmk_show_host`

Retrieve the configuration details of a single host

Update Host`checkmk_update_host`

Update the attributes of an existing host

Delete Host`checkmk_delete_host`

Permanently delete a host from Checkmk

Move Host To Folder`checkmk_move_host_to_folder`

Move an existing host to a different folder

Create Folder`checkmk_create_folder`

Create a new folder in the monitoring tree

List Folders`checkmk_list_folders`

Retrieve a list of all folders

Show Folder`checkmk_show_folder`

Retrieve a single folder by its path

Update Folder`checkmk_update_folder`

Update an existing folder's title or attributes

Delete Folder`checkmk_delete_folder`

Delete a folder from the monitoring tree

List Monitored Hosts`checkmk_list_monitored_hosts`

Retrieve monitored hosts from the Livestatus database

List Services For Host`checkmk_list_services_for_host`

Retrieve all monitored services for a specific host

List All Services`checkmk_list_all_services`

Retrieve all monitored services across all hosts

Start Service Discovery`checkmk_start_service_discovery`

Start a service discovery run on a host

Update Service Discovery Phase`checkmk_update_discovery_phase`

Update the discovery phase of a specific service on a host

Activate Pending Changes`checkmk_activate_changes`

Activate pending configuration changes

Wait For Activation Completion`checkmk_wait_for_activation`

Wait for an activation run to complete

Show Activation Run`checkmk_show_activation_run`

Retrieve the status of an activation run

List Running Activations`checkmk_list_running_activations`

Retrieve all currently running activations

Show Pending Changes`checkmk_show_pending_changes`

Retrieve all pending configuration changes

Create Host Downtime`checkmk_create_host_downtime`

Schedule a downtime for one or more hosts

Create Service Downtime`checkmk_create_service_downtime`

Schedule a downtime for one or more services

List Downtimes`checkmk_list_downtimes`

Retrieve all scheduled downtimes

Show Downtime`checkmk_show_downtime`

Retrieve a single downtime by ID

Delete Downtime`checkmk_delete_downtime`

Delete one or more scheduled downtimes

Acknowledge Host Problem`checkmk_acknowledge_host_problem`

Acknowledge a problem on a host or host group

Acknowledge Service Problem`checkmk_acknowledge_service_problem`

Acknowledge a problem on a service or service group

Delete Acknowledgement`checkmk_delete_acknowledgement`

Remove an acknowledgement from a host or service

Create Host Comment`checkmk_create_host_comment`

Create a comment on one or more hosts

List Comments`checkmk_list_comments`

Retrieve comments by collection type

Show Comment`checkmk_show_comment`

Retrieve a single comment by ID

Delete Comments`checkmk_delete_comments`

Delete one or more comments

Create Service Comment`checkmk_create_service_comment`

Create a comment on one or more services

Create User`checkmk_create_user`

Create a new Checkmk user account

List Users`checkmk_list_users`

Retrieve all Checkmk user accounts

Show User`checkmk_show_user`

Retrieve a single Checkmk user by username

Update User`checkmk_update_user`

Update an existing Checkmk user

Delete User`checkmk_delete_user`

Delete a Checkmk user account

Create Rule`checkmk_create_rule`

Create a new rule in a specified ruleset

List Rules`checkmk_list_rules`

List all rules in a specified ruleset

Show Rule`checkmk_show_rule`

Retrieve a single rule by its ID

Update Rule`checkmk_update_rule`

Update an existing rule by its ID

Delete Rule`checkmk_delete_rule`

Delete a rule by its ID

Move Rule`checkmk_move_rule`

Move a rule to a different position within its ruleset

List Rulesets`checkmk_list_rulesets`

Retrieve all available rulesets

Show Ruleset`checkmk_show_ruleset`

Retrieve details for a specific ruleset

Create Host Group`checkmk_create_host_group`

Create a new host group in Checkmk

List Host Groups`checkmk_list_host_groups`

List all host groups in Checkmk

Show Host Group`checkmk_show_host_group`

Retrieve details of a single host group

Update Host Group`checkmk_update_host_group`

Update an existing host group in Checkmk

Delete Host Group`checkmk_delete_host_group`

Permanently delete a host group from Checkmk

Create Contact Group`checkmk_create_contact_group`

Create a new contact group in Checkmk

List Contact Groups`checkmk_list_contact_groups`

List all contact groups in Checkmk

Show Contact Group`checkmk_show_contact_group`

Retrieve details of a single contact group

Update Contact Group`checkmk_update_contact_group`

Update an existing contact group in Checkmk

Delete Contact Group`checkmk_delete_contact_group`

Permanently delete a contact group from Checkmk

Create Service Group`checkmk_create_service_group`

Create a new service group in Checkmk

List Service Groups`checkmk_list_service_groups`

List all service groups in Checkmk

Show Service Group`checkmk_show_service_group`

Retrieve details of a single service group

Update Service Group`checkmk_update_service_group`

Update an existing service group in Checkmk

Delete Service Group`checkmk_delete_service_group`

Permanently delete a service group from Checkmk

Create Notification Rule`checkmk_create_notification_rule`

Create a new notification rule in Checkmk

List Notification Rules`checkmk_list_notification_rules`

List all notification rules in Checkmk

Show Notification Rule`checkmk_show_notification_rule`

Retrieve details of a single notification rule

Update Notification Rule`checkmk_update_notification_rule`

Update an existing notification rule in Checkmk

Delete Notification Rule`checkmk_delete_notification_rule`

Permanently delete a notification rule from Checkmk

Show Version`checkmk_show_version`

Retrieve Checkmk server version information

## Events

Tags

Select all
|
Clear

Webhook

No tags found

20 events

EventDescriptionTags

Webhook Verification`checkmk_webhook_verification`

Acknowledges a Checkmk test notification used to verify the webhook is wired correctly

Webhook

Host Down`checkmk_webhook_host_down`

Processes host down notifications from Checkmk

Webhook

Host Unreachable`checkmk_webhook_host_unreachable`

Processes host unreachable notifications from Checkmk

Webhook

Host Up`checkmk_webhook_host_up`

Processes host recovery notifications from Checkmk

Webhook

Host Problem Acknowledged`checkmk_webhook_host_acknowledged`

Processes host problem acknowledgements from Checkmk

Webhook

Host Flapping Started`checkmk_webhook_host_flapping_started`

Processes host flapping start notifications from Checkmk

Webhook

Host Flapping Stopped`checkmk_webhook_host_flapping_stopped`

Processes host flapping stop notifications from Checkmk

Webhook

Host Downtime Started`checkmk_webhook_host_downtime_started`

Processes host downtime start notifications from Checkmk

Webhook

Host Downtime Ended`checkmk_webhook_host_downtime_ended`

Processes host downtime end notifications from Checkmk

Webhook

Host Downtime Canceled`checkmk_webhook_host_downtime_cancelled`

Processes host downtime cancellation notifications from Checkmk

Webhook

Service Warning`checkmk_webhook_service_warning`

Processes service warning notifications from Checkmk

Webhook

Service Critical`checkmk_webhook_service_critical`

Processes service critical notifications from Checkmk

Webhook

Service Unknown`checkmk_webhook_service_unknown`

Processes service unknown notifications from Checkmk

Webhook

Service Recovered`checkmk_webhook_service_ok`

Processes service recovery notifications from Checkmk

Webhook

Service Problem Acknowledged`checkmk_webhook_service_acknowledged`

Processes service problem acknowledgements from Checkmk

Webhook

Service Flapping Started`checkmk_webhook_service_flapping_started`

Processes service flapping start notifications from Checkmk

Webhook

Service Flapping Stopped`checkmk_webhook_service_flapping_stopped`

Processes service flapping stop notifications from Checkmk

Webhook

Service Downtime Started`checkmk_webhook_service_downtime_started`

Processes service downtime start notifications from Checkmk

Webhook

Service Downtime Ended`checkmk_webhook_service_downtime_ended`

Processes service downtime end notifications from Checkmk

Webhook

Service Downtime Canceled`checkmk_webhook_service_downtime_cancelled`

Processes service downtime cancellation notifications from Checkmk

Webhook


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.