Imports alerts, incidents, teams, users and on-call schedules from Opsgenie to track alert-handling SLAs and incident metrics.
For the general flow of adding a source, see Connect Data Sources.
Before you start
Opsgenie account with API integration admin rights (admin/owner)
A read API key with access to configuration data (users and teams), not just alerts
Know your Opsgenie region (EU or US)
Step 1 — Pick the region
If your account is EU-hosted, the API is api.eu.opsgenie.com (recommended for data residency). Otherwise it is api.opsgenie.com (US).
Step 2 — Create a read API integration (with configuration access)
Sign in to Opsgenie with an admin/owner account → Settings → Integrations
Add integration → search for API
Name: HARVEN
Uncheck Read-Write Access (leave Read Access only)
The integration must have access to configuration resources (users, teams): a team-restricted integration or one without this access will return a permissions error. If needed, create the key via Settings → API key management (account key) instead.
Click Save Integration and copy the API key
If you get a 403 error
A 403 Forbidden error means the key is recognised but lacks configuration read rights (users/teams), or the integration has an IP address restriction. Recreate the key from an admin account with configuration access, and allow our servers if an IP restriction is in place.
What to enter in HARVEN
API Key — Read API integration key with configuration access (users/teams) (Opsgenie → Settings → Integrations → API)
Region — Your account hosting region (EU or US) (URL of your Opsgenie console)
What HARVEN reads
alerts — Opsgenie alerts: handling (status, priority, acknowledged), latency (created_at, ack_time_ms, close_time_ms), actor (acknowledged_by, closed_by, owner)
incidents — Incidents: classification (status, priority, tags), duration/MTTR (impact_start_date, impact_end_date)
users — Users: identity (username, full_name, role)
teams — Teams: team (id, name)
on_calls — On-calls: coverage (schedule_name, participant_name)
Official documentation
Need help? Contact [email protected].
