Explore documentation
  1. Welcome to Incidents 👋
  2. Frequently Asked Questions
  3. On-call scheduling and alerting
    1. Get started
    2. Slack and other integrations ↗
    3. Tag on-call in Slack
    4. Mobile apps ↗
    5. Connecting external calendars
    6. Advanced guide
  4. Incident management
    1. Get started
    2. Post mortems
    3. Metadata & Catalog
    4. Screening alerts
    5. Reporting ↗
  5. Monitoring
    1. Get started
    2. Working with monitors
    3. Customizing monitors
    4. Monitor types
  6. Status pages
    1. Get started
    2. Advanced guide
  7. Incidents API
    1. Getting an API token
    2. Pagination
    3. Monitors
    4. Heartbeats
    5. On-call & incidents
    6. Status pages
    7. Metadata
    8. Integrations
      1. New Relic
      2. Datadog
      3. AWS CloudWatch
        1. List AWS CloudWatch integrations GET
        2. Get AWS CloudWatch integration GET
        3. Create AWS CloudWatch integration POST
        4. Update AWS CloudWatch integration PATCH
        5. Remove AWS CloudWatch integration DELETE
      4. Amazon SNS
      5. Microsoft Azure
      6. Google Monitoring
      7. Grafana
      8. Elastic
      9. Prometheus
      10. E-mail
      11. Incoming webhooks
      12. Atlassian Jira
      13. Slack
      14. Outgoing webhooks
      15. Outgoing e‑mails
      16. Splunk On-Call
      17. PagerDuty
      18. Catalog
    9. Team members
    10. Organization roles
    11. Usage
    12. Reporting

Create AWS CloudWatch integration

Returns either a newly created AWS CloudWatch integration, or validation errors.

POST https://incidents.betterstack.com/api/v2/aws-cloudwatch-integrations

Headers

Authorization
required string

Bearer $TOKEN

Content-Type
string

application/json

Body parameters

team_name
string

Required if using global API token to specify the team which should own the resource

name
string

The name of the AWS CloudWatch integration that you can see in the dashboard.

policy_id
string

ID of the escalation policy associated with the AWS CloudWatch integration.

call
boolean

Call the on-call person.

sms
boolean

Send an SMS to the on-call person.

email
boolean

Send an e-mail to the on-call person.

push
boolean

Send a push notification to the on-call person.

critical_alert
boolean

Send a critical push notification that ignores the mute switch and Do not Disturb mode.

team_wait
integer

How long we wait before escalating the incident alert to the team. In seconds.

recovery_period
integer

Has no effect for this integration, since an incident resolves as soon as AWS CloudWatch reports the alert as resolved.

paused
boolean

Set to true to pause the integration, false to unpause it.

201

Returns the newly created AWS CloudWatch integration. Point your AWS CloudWatch webhook to the returned webhook_url

Response body

{
  "data": {
    "id": "37",
    "type": "aws_cloudwatch_integration",
    "attributes": {
      "call": false,
      "sms": true,
      "email": true,
      "team_wait": 180,
      "recovery_period": null,
      "policy_id": null,
      "push": false,
      "critical_alert": false,
      "name": "AWS CloudWatch alerts",
      "webhook_url": "https://incidents.betterstack.com/api/v1/aws-cloudwatch/webhook/[token]",
      "team_name": "Production",
      "paused": false
    }
  }
}

Example cURL

Example
curl -X "POST" "https://incidents.betterstack.com/api/v2/aws-cloudwatch-integrations/" \
     -H "Authorization: Bearer $TOKEN" \
     -H 'Content-Type: application/json; charset=utf-8' \
     -d $'{
  "name": "AWS CloudWatch alerts",
  "sms": true,
  "team_wait": 180
}'


Previous article

Get AWS CloudWatch integration

Next article

Update AWS CloudWatch integration