Meet our Roofing and Paving experts at the International Roofing Expo and National Paving Expo. Schedule a meeting here ›

How to set up alerts

Welcome to our guide on how to set up weather alerts through the ClimaCell API! The process is straightforward, but does require a few steps, and for you to make a few choices along the way.

Our alerts proactively notify you of worldwide weather events that YOU consider meaningful. Alerts allow for multiple rules, and can be sent up to 6 hours in advance of a weather trigger. Alerts can be sent via webhook, email, or SMS (text rules & rates apply).

Alerts can be based on:

  • Rain, Snow, Sleet and Freezing Rain
  • Temperature
  • Humidity
  • Wind, Wind Direction and Wind Gust
  • Barometric Pressure
  • Dew
  • Visibility

Steps to Create Email/SMS Alerts

  1. Create at least 1 permanent Location(POST /locations). Alerts will trigger for these locations.
  2. Create at least 1 Group (POST /groups). Different alerts can be sent to different groups. A group must be created even if alerts go to all members.
  3. Create at least 1 member (POST /groups/member). Members must have their email and phone number entered to get an email or SMS.
  4. Create an Alert(POST /alerts).

Steps to Create Webhook Alerts

  1. Set up a URL on your side that can receive incoming requests from our server.
  2. Register a Webhook (POST /webhooks).
  3. Create at least 1 permanent location (POST /locations). ​ Alerts will trigger for these locations.
  4. Create an Alert (POST /alerts).

Requests coming from our server (alerts) look like this:

{
 alert_id: "18507f191e810c19729de860ea",
 name: "My Alert"
 location_id: "599b1fe3af38f5039cf2a1e5"
 location_name: "Location name"
 notice: 60
 conditions: ​[{
   "parameter": "Rain",
   "value": 0.15,
   "operator": "lt"
 }],
 trigger_time: 2018-01-01T18:00:00Z
}