Explore documentation
  1. Welcome to Incidents 👋
  2. Frequently Asked Questions
  3. On-call scheduling and alerting
    1. Get started
    2. Slack and other integrations ↗
    3. Tag on-call in Slack
    4. Mobile apps ↗
    5. Connecting external calendars
    6. Advanced guide
  4. Incident management
    1. Get started
    2. Post mortems
    3. Metadata & Catalog
    4. Screening alerts
    5. Reporting ↗
  5. Monitoring
    1. Get started
    2. Working with monitors
    3. Customizing monitors
    4. Monitor types
  6. Status pages
    1. Get started
    2. Advanced guide
  7. Incidents API
    1. Getting an API token
    2. Pagination
    3. Monitors
    4. Heartbeats
    5. On-call & incidents
    6. Status pages
    7. Metadata
    8. Integrations
      1. New Relic
        1. List New Relic integrations GET
        2. Get New Relic integration GET
        3. Create New Relic integration POST
        4. Update New Relic integration PATCH
        5. Remove New Relic integration DELETE
      2. Datadog
      3. AWS CloudWatch
      4. Amazon SNS
      5. Microsoft Azure
      6. Google Monitoring
      7. Grafana
      8. Elastic
      9. Prometheus
      10. E-mail
      11. Incoming webhooks
      12. Atlassian Jira
      13. Slack
      14. Outgoing webhooks
      15. Outgoing e‑mails
      16. Splunk On-Call
      17. PagerDuty
      18. Catalog
    9. Team members
    10. Organization roles
    11. Usage
    12. Reporting

List New Relic integrations

Returns a list of all your New Relic integrations.

GET https://incidents.betterstack.com/api/v2/new-relic-integrations

Query parameters

team_name
string

Filter integrations belonging to a specified team when using global API token.

page
integer

The page number to return, starting with 1.

per_page
integer

Number of results per page. Defaults to 50, maximum 250.

Headers

Authorization
required string

Bearer $TOKEN

200

Returns list of existing New Relic integrations

Response body

{
  "data": [
    {
      "id": "37",
      "type": "new_relic_integration",
      "attributes": {
        "call": false,
        "sms": true,
        "email": true,
        "team_wait": 180,
        "recovery_period": null,
        "policy_id": null,
        "push": false,
        "critical_alert": false,
        "name": "New Relic alerts",
        "webhook_url": "https://incidents.betterstack.com/api/v1/new-relic/webhook/[token]",
        "team_name": "Testing",
        "paused": false,
        "alerting_rule": "alert"
      }
    }
  ],
  "pagination": {
    "first": "https://incidents.betterstack.com/api/v2/new-relic-integrations?page=1",
    "last": "https://incidents.betterstack.com/api/v2/new-relic-integrations?page=1",
    "prev": null,
    "next": null
  }
}

Response attributes

id
string

The ID of the New Relic integration.

type
string

Always new_relic_integration.

attributes.call
boolean

Whether to call the on-call person.

attributes.sms
boolean

Whether to send an SMS to the on-call person.

attributes.email
boolean

Whether to send an e-mail to the on-call person.

attributes.team_wait
integer or null

How long we wait before escalating the incident to the team in seconds, 0 to alert the whole team right away, or null to never escalate to the team.

attributes.recovery_period
integer or null

A recovery period in seconds, or null when none is set, which this integration doesn't use since incidents resolve as soon as New Relic reports the alert as resolved.

attributes.policy_id
integer or null

ID of the escalation policy for incidents from this integration, or null when incidents alert the on-call person directly.

attributes.push
boolean

Whether to send a push notification to the on-call person.

attributes.critical_alert
boolean

Whether to send a critical push notification that ignores the mute switch and Do Not Disturb mode.

attributes.name
string or null

The name of the New Relic integration shown in the dashboard, or null when no name is set.

attributes.webhook_url
string

The URL to point your New Relic webhook to.

attributes.team_name
string

The team this integration belongs to.

attributes.paused
boolean

Whether the New Relic integration is paused, which makes it ignore incoming alerts.

attributes.alerting_rule
string

When an incident starts: alert when the New Relic metric reaches its ALERT threshold, or alert_and_warn when it reaches its ALERT or WARN threshold.

pagination.first
string

The URL of the first page. Read more about pagination.

pagination.last
string

The URL of the last page.

pagination.prev
string or null

The URL of the previous page, or null on the first page.

pagination.next
string or null

The URL of the next page, or null on the last page.

Example cURL

Example
curl --request GET \
  --url https://incidents.betterstack.com/api/v2/new-relic-integrations \
  --header "Authorization: Bearer $TOKEN"


Previous article

Update metadata

Next article

Get New Relic integration