• English日本語한국어
  • Log inStart now

REST API calls for alerts

Our REST API is New Relic's original API for programmatically configuring New Relic alerting settings (learn about NerdGraph, our preferred API).

The REST API Explorer also includes the curl request format, available parameters, potential response status codes, and JSON response structure for each of the available API calls. You can also create alert conditions in the UI.

Before using the REST API

Before using the REST API to manage alerting data, read the Intro to APIs for and applied intelligence.

For infrastructure alerting, see REST API for infrastructure monitoring alerts.

Also, if you haven't already, create your free New Relic account below to start monitoring your data today.

Available data and functions via REST API

REST API functions

Comments

View account data

In general, any role can use a or REST API key with GET > List functions to view alerts data. The account Owner and Admins may use their API key.

List output will be paginated. Available functions include:

Maintain account data

You may have an Owner or Admin role in your account and a user key or have a custom role that grants permissions to manage alerts and a user key in order to use any maintenance function, including POST > Create, PUT > Add, PUT > Update, and DELETE.

Conditions excluded from the REST API

These types of conditions do not have available endpoints in the API:

  • APM: Web transaction percentiles, conditions targeting labels, and anomalies
  • NRQL: Anomalies

Alert policies

These API functions include links to the API Explorer, where you can create, delete, or list policies.

Important

If your organization hosts data in the EU data center, ensure you're using the proper API endpoints for EU region accounts.

Conditions for APM, browser, mobile

These API functions include links to the API Explorer, where you can create, update, delete, or list policy conditions. These calls are for conditions with these types of entities:

  • APM: Apps and key transactions
  • Browser: Apps and key transactions
  • Mobile: Mobile apps

Exception: The following APM conditions are not available from this API endpoint:

  • Conditions targeting labels (dynamic targeting)
  • Web transaction percentile conditions
  • Anomaly conditions

Important

The API Explorer provides information about other types of conditions using separate endpoints, including external services (APM and mobile), and synthetic monitoring. Consider all types of alert conditions when searching or updating. If your account hosts data in the EU data center, ensure you are using the proper API endpoints for EU region accounts.

Conditions for NRQL

These API functions include links to the API Explorer, where you can create, update, delete, or list NRQL conditions for your policies.

Exception: NRQL anomaly conditions are not available from this endpoint.

Important

If your organization hosts data in the EU data center, ensure you are using the proper API endpoints for EU region accounts.

Conditions for external services

These API functions include links to the API Explorer, where you can create, update, delete, or list policy conditions. These calls are for conditions for external services. The API calls can be used with and mobile monitoring apps.

Important

If your organization hosts data in the EU data center, ensure you are using the proper API endpoints for EU region accounts.

Conditions for synthetic monitoring

These API functions include links to the API Explorer, where you can create, update, delete, or list conditions for your alert policies. The API calls can be used with synthetic monitoring.

Multi-location conditions for synthetic monitoring

These API functions include links to the API Explorer, where you can create, update, delete, or list conditions for your alert policies. The API calls can be used for multi-location conditions with synthetic monitoring. Before creating or updating a condition, read the rules for multi-location alert conditions.

Alert activity: Events, incidents

These API functions include links to the API Explorer, where you can view information about events and incidents for your alert policies.

Important

If your organization hosts data in the EU data center, ensure you are using the proper API endpoints for EU region accounts.

Alert entity conditions

These API functions include links to the API Explorer, where you can list, add and remove entities in the conditions for your alert policies.

Important

If your organization hosts data in the EU data center, ensure you are using the proper API endpoints for EU region accounts.

Copyright © 2024 New Relic Inc.

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.