Create an Opsgenie alert when a monitor fails and close it when it recovers, routed by your team's schedules and escalation rules.
How it works#
WatchCron creates an Opsgenie alert through the Alert API when a monitor goes down. When it recovers, WatchCron closes the alert automatically. Your team's on-call schedules, escalation policies, and notification rules handle the rest.
Each monitor gets its own alias in Opsgenie, so repeat failures update the open alert instead of flooding the queue.
Before you start#
You need:
- An Opsgenie account with team admin rights.
- A WatchCron account on any plan. Opsgenie alerts work on Free, Starter, Pro and Business.
One detail that trips people up: Opsgenie runs on two separate instances. If your dashboard URL contains app.eu.opsgenie.com, you're on the EU instance. If it's app.opsgenie.com, you're on US. The API key only works with the matching region.
Step 1 — Create an API integration in Opsgenie#
Go to Teams → your team → Integrations → Add integration → API.
Keep "Create and update access" turned on. Without it, WatchCron can open alerts but can't close them on recovery. Save the integration and copy the API key.
| Where | What to do |
|---|---|
| Teams → your team → Integrations | Add integration → API |
| Access settings | Make sure "Create and update access" is on |
| After saving | Copy the API key |
Step 2 — Add the channel in WatchCron#
Go to Alerts → Channels → Add channel and choose Opsgenie.
| Field | What to enter |
|---|---|
| Label | Something recognisable, e.g. "Platform team" |
| API key | The key from the API integration |
| Region | US or EU (check your Opsgenie dashboard URL) |
Click Save.
Step 3 — Test and assign monitors#
Click Send test. Opsgenie should show a test alert in the Alerts dashboard. Confirm it arrived, then close it.
Open any monitor and tick the Opsgenie channel under Alert channels. Failures now create real alerts routed through your team's escalation policy.
What to paste where#
| WatchCron field | Value | Where you find it |
|---|---|---|
| API key | a1b2c3d4-e5f6-7890-abcd-ef1234567890 | Team → Integrations → API |
| Region | US or EU | app.opsgenie.com = US, app.eu.opsgenie.com = EU |
What WatchCron sends#
Two actions:
- Create alert: when a monitor fails. Includes the monitor name, failure reason, and a link to the WatchCron incident.
- Close alert: when the monitor recovers. Matches by alias, so the right alert closes without manual intervention.
Priority, tags, and routing all depend on your Opsgenie team configuration. WatchCron sends the event; Opsgenie decides who gets notified and when.