Authentication Parameters

The Checkly provider offers two ways to authenticate:

  • Checkly API Key - This is the API key created in the User Settings of your Checkly account and is used to authenticate requests to the Checkly API.
  • Checkly Account ID - This is the account ID of your Checkly account.

Connecting Checkly to Keep

  1. Open Checkly dashboard and click on your profile picture in the top right corner.

  2. Click on User Settings.

  1. Open the API Keys tab and click on Create API Key to generate a new API key.
  1. Copy the API key.

  2. Open General tab under Account Settings and copy the Account ID.

  1. Go to Keep, add Checkly as a provider and enter the API key and Account ID in the respective fields and click on Connect.

Webhooks Integration

  1. Open Checkly dashboard and open Alerts tab in the left sidebar.
  1. Click on Add more channels
  1. Select Webhook from the list of available channels.
  1. Enter a name for the webhook, select the method as POST

  2. Enter https://api.keephq.dev/alerts/event/checkly as the URL.

  3. Copy the below snippet and paste in the Body of Webhook. Refer the screenshot below for reference.

{
  "event": "{{ALERT_TITLE}}",
  "alert_type": "{{ALERT_TYPE}}",
  "check_name": "{{CHECK_NAME}}",
  "group_name": "{{GROUP_NAME}}",
  "check_id": "{{CHECK_ID}}",
  "check_type": "{{CHECK_TYPE}}",
  "check_result_id": "{{CHECK_RESULT_ID}}",
  "check_error_message": "{{CHECK_ERROR_MESSAGE}}",
  "response_time": "{{RESPONSE_TIME}}",
  "api_check_response_status_code": "{{API_CHECK_RESPONSE_STATUS_CODE}}",
  "api_check_response_status_text": "{{API_CHECK_RESPONSE_STATUS_TEXT}}",
  "run_location": "{{RUN_LOCATION}}",
  "ssl_days_remaining": "{{SSL_DAYS_REMAINING}}",
  "ssl_check_domain": "{{SSL_CHECK_DOMAIN}}",
  "started_at": "{{STARTED_AT}}",
  "tags": "{{TAGS}}",
  "link": "{{RESULT_LINK}}",
  "region": "{{REGION}}",
  "uuid": "{{$UUID}}"
}
  1. Go to Headers tab and add a new header with key as X-API-KEY and create a new API key in Keep and paste it as the value and save the webhook.
  1. Follow the below steps to create a new API key in Keep.

  2. Go to Keep dashboard and click on the profile icon in the botton left corner and click Settings.

  1. Select Users and Access tab and then select API Keys tab and create a new API key.
  1. Give name and select the role as webhook and click on Create API Key.
  1. Use the generated API key in the X-API-KEY header of the webhook created in Checkly.