• Products
  • Get started
  • Documentation
  • Resources

Create an API integration

What does Opsgenie offer API integration users?

API Integrations are used to access Opsgenie services, allowing you to integrate alerts, configure users, schedules, and teams on your Opsgenie account from external applications.

Functionality of the integration

A Default API integration is provided in your account. This integration can be used for configuring users as well as alerts, however, we recommend adding a separate API Integration for each of your monitoring systems.

Opsgenie has built-in integrations for many management systems that make the integration configuration easier. Before using an API Integration, please check the existing Integrations, and feel free to suggest new integrations via the Contact Us page.

Opsgenie Client Tools

​Using API Integration

  1. Go to Settings → Integrations. Search for API and select Add

  2. Specify who is notified for the alerts using the Responders field. Refer to Alert Notifications Flow.

  3. Check the modify configuration settings option to allow the integration to manage users, schedules, escalations, etc.

  4. Click Save Integration.

  5. An API Key is generated for the integration, copy the API Key and use in your API requests.

For Free and Essentials plans, you can only add the integrations from the Team Dashboards, please use the alternative instructions given below to add this integration.

Did you know that you can also add this integration from your team dashboard? 

If you want your team to be the owner of this integration, add it from your team dashboard. Opsgenie will assign the alerts received through this integration to your team only.

To do that;

  1. Go to Teams,

  2. Find your team and select it to go to your team dashboard,

  3. From your team navigation, select Integrations,

  4. Select Add integration.

If the Owner of your Opsgenie account has not verified their email yet, users within your organization will not be able use API integrations.

Advanced Settings

Integration advanced settings consist of many different alert scenarios. These scenarios are called Actions; and they specify how and when alerts can be created, closed, acknowledged. etc. There are default actions provided by Opsgenie, but you can customize them and add as many actions of your own as you like. You can, for example, have three Create Alert actions, which means the data that comes to Opsgenie is evaluated against these three scenarios in order and if one of them has a match, a new alert is created.

Click "Advanced Settings" to switch or modify actions, then save your changes.

Refer to Use advanced integration settings for more information.

Dynamic fields (custom priority, payload, url, and headers) are not available for API integration.


Last modified on Aug 3, 2021
Cached at 12:15 AM on Sep 18, 2021 |

Additional Help