OpsGenie

​

Prerequisites

• OpsGenie account (Atlassian or standalone)
• API key with read access

​

Setup

​

Option 1: Interactive CLI

healops integrations setup

​

Option 2: Environment variables

OPSGENIE_API_KEY=your-api-key
OPSGENIE_REGION=us   # or "eu" for EU accounts

​

Option 3: Persistent store

{
  "version": 1,
  "integrations": [
    {
      "id": "opsgenie-prod",
      "service": "opsgenie",
      "status": "active",
      "credentials": {
        "api_key": "your-api-key",
        "region": "us"
      }
    }
  ]
}

​

Creating an API key

1. In OpsGenie, go to Settings → API key management
2. Click Add new API key
3. Name it healops and enable Read access
4. Copy the key

​

Verify

healops integrations verify opsgenie

Service: opsgenie
Status: passed
Detail: Connected to OpsGenie (US region); API key accepted

​

Troubleshooting

​

Security best practices

• Use a read-only API key — OpsGenie supports granular permission scopes.
• Store the API key in .env, not in source code.