Overview
OpsGenie Integration
Integrate OpsGenie with Sprinto to automatically sync incidents for continuous monitoring, evidence collection, and compliance tracking.
The OpsGenie integration allows Sprinto to automatically fetch and monitor incidents from your OpsGenie account. This helps track incident response processes, validate compliance controls, and maintain audit-ready evidence without manual effort.
Prerequisites
Before you begin, ensure the following:
- You have an active OpsGenie account.
- You have admin access to OpsGenie.
- You have access to generate an OpsGenie API key.
- The API key has read access to incidents.
- You know your OpsGenie region:
- US (Default).
- EU.
Permissions and access
Minimum requirements
- API key with read access to incidents.
- No specific role is required, but access must allow:
- Viewing incidents.
- Viewing incident details.
Data accessed by Sprinto
- Message.
- Status.
- Priority.
- Description.
- Impact start date.
- Impact end date.
Data sync behaviour
Sprinto follows a structured sync process:
- Fetch – Retrieves incidents from OpsGenie API.
- Transform – Maps data to Sprinto’s schema.
- Store – Updates the database using bulk operations.
- Evaluate – Triggers monitors and compliance checks.
This ensures consistent and reliable incident tracking.
How it works
Sprinto connects to OpsGenie using API key-based authentication and periodically syncs incident data.
- Sprinto authenticates using Basic Authentication (Base64 encoded API key).
- It fetches incident data using OpsGenie APIs.
- Retrieved data is transformed and mapped to Sprinto’s internal compliance model.
- Incidents are continuously synced and updated.
APIs used by Sprinto
GET /v1/incidents– Fetch all incidents.
Priority mapping
- P1, P2 → High.
- P3 → Medium.
- P4 → Low.
Connect OpsGenie to Sprinto
- Log in to the Sprinto dashboard.
- Navigate to Settings → Integrations.
- In the All tab, search for OpsGenie.
- Click Connect.
Step 1: Review permissions
- Review:
- Required permissions.
- Data accessed by Sprinto.
- Click Next.
Step 2: Add connection details
- Enter the following details:
- API Key.
- Region (US or EU).
- Click Connect.
Once completed, Sprinto validates the connection and establishes the integration.
How to get your API key
- Log in to your OpsGenie console.
- Go to the Admin section.
- Navigate to Settings → API Key Management.
- Generate a new API key.
- Copy and securely store the API key.
Ensure the API key has read access to incidents.
Regional configuration
OpsGenie requires selecting the correct region during setup.
| Region | Base URL |
|---|---|
| US (Default) | https://api.opsgenie.com/ |
| EU | https://api.eu.opsgenie.com/ |
Selecting the wrong region will result in connection failure.
Post-connection flow
After a successful connection:
- The integration status is shown as Connected.
- Sprinto starts syncing incidents automatically.
- Relevant controls and checks are activated.
- Incident data is continuously updated and mapped to compliance requirements.
Error handling
Sprinto validates the connection during setup and monitors it continuously.
Common error scenarios
Invalid API key (401).
Occurs when the API key is incorrect.
Action: Re-enter the correct API key.
Insufficient permissions (403).
Occurs when the API key lacks required access.
Action: Ensure read access to incidents is enabled.
Incorrect region.
Occurs when the selected region does not match your OpsGenie account.
Action: Select the correct region (US or EU).
Rate limiting (429) or server errors (5xx).
Handled automatically with retries.
Troubleshooting
Connection fails
- Ensure the API key is copied correctly without extra spaces.
- Verify the API key is active.
- Confirm the correct region is selected.
No incidents are syncing
- Check if incidents exist in OpsGenie.
- Ensure the API key has read permissions.
- Allow time for the initial sync.
Integration shows errors
- Reconnect the integration.
- Regenerate the API key if required.
Refer to internal troubleshooting steps for OpsGenie integration:
Additional notes
- Credentials are securely stored (API key is encrypted).
- Sprinto uses a structured sync pipeline to ensure data accuracy.
- Transient errors are automatically retried.
- Authentication and permission errors require manual intervention.
Support
Please contact Sprinto Support If you have any queries related to the integration or need any assistance.