New Relic

App · 20 actions

Query your telemetry with NRQL, manage alert policies, conditions and muting rules, tag entities, record deployments and work alert issues.

Actions

ActionWhat it does
Acknowledge issueAcknowledge an issue, so others can see someone is on it.
Add entity tagsAdd tags to an entity.
Create alert policyCreate an alert policy to hold conditions.
Create muting ruleSilence notifications for incidents matching a rule, such as everything from one policy during a maintenance window.
Create NRQL alert conditionCreate a static-threshold NRQL alert condition in a policy: alert when a query's value crosses a threshold for long enough.
Delete alert conditionDelete an alert condition of any type by its id.
Delete alert policyDelete an alert policy, together with all of its conditions.
Delete entity tagsRemove tags, with all their values, from an entity by tag name.
Delete muting ruleDelete a muting rule by its id.
Get entityRead one entity by its GUID: its name, type, alert status and tags.
List accountsList the New Relic accounts this connection's user can reach, with their numeric ids.
List alert policiesList an account's alert policies, optionally by name.
List issuesList an account's alert issues, by state, priority, entity and time.
List muting rulesList an account's alert muting rules.
List NRQL conditionsList an account's NRQL alert conditions, optionally for one policy.
Record changeMark a deployment, feature flag change, business event or operational event on an entity, so it shows on its charts next to the effect it had.
Resolve issueClose an issue and the incidents in it.
Run NRQL queryRun a NRQL query against one account and return its rows, such as error counts, latency percentiles or any event you send to New Relic.
Search entitiesFind services, hosts, browser apps, monitors and other entities by name, domain or type, or with New Relic's entity search syntax.
Update alert policyRename an alert policy or change how it groups issues.

Acknowledge issue

Acknowledge an issue, so others can see someone is on it.

Inputs

Accountaccount_idtextRequired
The New Relic account to work in.
Issue idissue_idtextRequired
The issue's id, from List issues.

Outputs

account_idnumber
The issue's account
actiontext
What New Relic did (ACK)
issue_idtext
The issue acknowledged
statustext
Status of the action execution ("success" on success).
Example output
{
  "account_id": 1234567,
  "action": "ACK",
  "issue_id": "9f3a1c2e-58b4-4f7e-9b1d-2c6a7e0d4b11",
  "status": "success"
}

Add entity tags

Add tags to an entity. A value for a tag name the entity already has is added alongside the existing values rather than replacing them.

Inputs

Entity GUIDguidtextRequired
The entity's GUID, from Search entities or the entity's page in New Relic (the 'Copy GUID' option in its metadata).
TagstagsobjectRequired
Tag names and values, such as team = payments. Separate several values for one tag with commas.

Outputs

guidtext
The entity tagged
statustext
Status of the action execution ("success" on success).
tagslist
Example output
{
  "guid": "MTIzNDU2N3xBUE18QVBQTElDQVRJT058NDQ1NTY2",
  "status": "success",
  "tags": [
    {
      "key": "team",
      "values": [
        "payments"
      ]
    }
  ]
}

Create alert policy

Create an alert policy to hold conditions.

Inputs

Accountaccount_idtextRequired
The New Relic account to work in.
NamenametextRequired
The policy's name.
Group issuesincident_preferencetext
How incidents from this policy are grouped into issues.One of: PER_POLICY (One issue per policy), PER_CONDITION (One issue per condition), PER_CONDITION_AND_TARGET (One issue per condition and entity). Default: PER_CONDITION.

Outputs

policyobject
statustext
Status of the action execution ("success" on success).
Example output
{
  "policy": {
    "account_id": 1234567,
    "entity_guid": "MTIzNDU2N3xBSU9QU3xQT0xJQ1l8NTg0MzIxMA",
    "id": "5843210",
    "incident_preference": "PER_CONDITION",
    "name": "Checkout service"
  },
  "status": "success"
}

Create muting rule

Silence notifications for incidents matching a rule, such as everything from one policy during a maintenance window.

Inputs

Accountaccount_idtextRequired
The New Relic account to work in.
NamenametextRequired
The rule's name.
Mute incidents whereattributetextRequired
The incident attribute to match.One of: accountId (Account id), conditionId (Condition id), conditionName (Condition name), conditionType (Condition type), entity.guid (Entity GUID), nrqlEventType (NRQL event type), nrqlQuery (NRQL query), policyId (Policy id), policyName (Policy name), product, and 3 more. Default: policyName.
Tag nametag_nametext
The entity tag to match, such as team.Only when Mute incidents where is Entity tag (name it below).
MatchesoperatortextRequired
How the attribute is compared with the values.One of: EQUALS, NOT_EQUALS (Does not equal), IN (Is one of), NOT_IN (Is not one of), CONTAINS, NOT_CONTAINS (Does not contain), STARTS_WITH (Starts with), NOT_STARTS_WITH (Does not start with), ENDS_WITH (Ends with), NOT_ENDS_WITH (Does not end with), and 3 more. Default: EQUALS.
Valuesvalueslist
The values to compare with. Not needed for Is blank or Is not blank.
Enabledenabledtrue/false
Whether the rule mutes anything yet.Default: true.
Descriptiondescriptiontext
Why the rule exists.
Startsstarts_atdate and time
When muting starts. Leave both times empty to mute until the rule is disabled.
Endsends_atdate and time
When muting ends.
Time zonetime_zonetext
The schedule's time zone, such as Europe/London. Defaults to UTC.
Repeatrepeattext
Whether the window repeats.One of: NONE (Does not repeat), DAILY, WEEKLY, MONTHLY. Default: NONE.
Onweekly_repeat_dayslist
The weekdays a weekly window repeats on.Only when Repeat is Weekly. One or more of: MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY, SUNDAY.
Repeat untilrepeat_untildate and time
When the repeating stops. Leave empty to repeat indefinitely.Only when Repeat is Daily, Weekly or Monthly.
When the window endsaction_on_window_endtext
What happens to issues still open when muting ends.One of: CLOSE_ISSUES_ON_INACTIVE (Close issues that are no longer active), DO_NOTHING (Leave issues as they are).

Outputs

muting_ruleobject
statustext
Status of the action execution ("success" on success).
Example output
{
  "muting_rule": {
    "account_id": 1234567,
    "action_on_window_ended": "CLOSE_ISSUES_ON_INACTIVE",
    "conditions": [
      {
        "attribute": "policyName",
        "operator": "EQUALS",
        "values": [
          "Checkout service"
        ]
      }
    ],
    "created_at": "2026-10-15T09:00:00Z",
    "description": null,
    "enabled": true,
    "id": "71203",
    "match": "AND",
    "name": "Weekend maintenance",
    "schedule": null,
    "updated_at": "2026-10-15T09:00:00Z"
  },
  "status": "success"
}

Create NRQL alert condition

Create a static-threshold NRQL alert condition in a policy: alert when a query's value crosses a threshold for long enough.

Inputs

Accountaccount_idtextRequired
The New Relic account to work in.
Alert policypolicy_idtextRequired
The alert policy. Pick one, or use an id from List alert policies.
NamenametextRequired
The condition's name.
NRQL queryquerytextRequired
A query returning one number, without SINCE or UNTIL, such as SELECT count(*) FROM TransactionError
Alert when the value isoperatortextRequired
How the value is compared with the threshold.One of: ABOVE, ABOVE_OR_EQUALS (Above or equal to), BELOW, BELOW_OR_EQUALS (Below or equal to), EQUALS (Equal to), NOT_EQUALS (Not equal to). Default: ABOVE.
Critical thresholdthresholdnumberRequired
The value that opens a critical incident.
For at least (seconds)threshold_durationnumber
How long the threshold must be crossed. A multiple of the aggregation window; defaults to 300.At least 30.
Crossedthreshold_occurrencestext
Whether every data point, or just one, must cross it.One of: AT_LEAST_ONCE (At least once in the duration), ALL (For the whole duration). Default: ALL.
Warning thresholdwarning_thresholdnumber
Optional: a value that opens a warning, compared the same way.
Enabledenabledtrue/false
Whether the condition starts evaluating straight away.Default: true.
Aggregationaggregation_methodtext
How data points are collected into windows.One of: EVENT_FLOW (Event flow (steady data)), EVENT_TIMER (Event timer (sparse data)), CADENCE (Cadence (wall clock)). Default: EVENT_FLOW.
Window (seconds)aggregation_windownumber
The length of each aggregation window. Defaults to 60.From 30 to 21600.
Wait for late data (seconds)aggregation_delaynumber
Event flow and cadence: the delay before a window is evaluated (default 120). Event timer: the quiet time that closes a window (default 60).From 0 to 7200.
Fill gapsfill_optiontext
What to use for windows with no data.One of: NONE (Leave gaps empty), LAST_VALUE (Repeat the last value), STATIC (Use a fixed value).
Fill valuefill_valuenumber
The value used for windows with no data.Only when Fill gaps is Use a fixed value.
Descriptiondescriptiontext
Shown on incidents from this condition.
Runbook URLrunbook_urltext
A link responders should follow.
Issue titletitle_templatetext
A custom title for issues this condition opens.
Close open incidents after (seconds)violation_time_limit_secondsnumber
Leave empty for New Relic's default.At least 1.

Outputs

conditionobject
statustext
Status of the action execution ("success" on success).
Example output
{
  "condition": {
    "description": null,
    "enabled": true,
    "entity_guid": "MTIzNDU2N3xBSU9QU3xDT05ESVRJT058MzgyNjU1NDE",
    "id": "38265541",
    "name": "Checkout errors",
    "policy_id": "5843210",
    "query": "SELECT count(*) FROM TransactionError",
    "runbook_url": null,
    "terms": [
      {
        "operator": "ABOVE",
        "priority": "CRITICAL",
        "threshold": 10.0,
        "threshold_duration": 300,
        "threshold_occurrences": "ALL"
      }
    ],
    "type": "STATIC",
    "violation_time_limit_seconds": 86400
  },
  "status": "success"
}

Delete alert condition

Delete an alert condition of any type by its id.

Inputs

Accountaccount_idtextRequired
The New Relic account to work in.
Condition idcondition_idtextRequired
The condition's id, from List NRQL conditions.

Outputs

condition_idtext
The condition deleted
deletedtrue/false
True once it is gone
statustext
Status of the action execution ("success" on success).
Example output
{
  "condition_id": "38265541",
  "deleted": true,
  "status": "success"
}

Delete alert policy

Delete an alert policy, together with all of its conditions.

Inputs

Accountaccount_idtextRequired
The New Relic account to work in.
Alert policypolicy_idtextRequired
The alert policy. Pick one, or use an id from List alert policies.

Outputs

deletedtrue/false
True once it is gone
policy_idtext
The policy deleted
statustext
Status of the action execution ("success" on success).
Example output
{
  "deleted": true,
  "policy_id": "5843210",
  "status": "success"
}

Delete entity tags

Remove tags, with all their values, from an entity by tag name.

Inputs

Entity GUIDguidtextRequired
The entity's GUID, from Search entities or the entity's page in New Relic (the 'Copy GUID' option in its metadata).
Tag namestag_keyslistRequired
The tag names to remove, such as team.

Outputs

guidtext
The entity changed
statustext
Status of the action execution ("success" on success).
tag_keyslist
Example output
{
  "guid": "MTIzNDU2N3xBUE18QVBQTElDQVRJT058NDQ1NTY2",
  "status": "success",
  "tag_keys": [
    "team"
  ]
}

Delete muting rule

Delete a muting rule by its id.

Inputs

Accountaccount_idtextRequired
The New Relic account to work in.
Muting rule idrule_idtextRequired
The rule's id, from List muting rules.

Outputs

deletedtrue/false
True once it is gone
muting_rule_idtext
The rule deleted
statustext
Status of the action execution ("success" on success).
Example output
{
  "deleted": true,
  "muting_rule_id": "71203",
  "status": "success"
}

Get entity

Read one entity by its GUID: its name, type, alert status and tags.

Inputs

Entity GUIDguidtextRequired
The entity's GUID, from Search entities or the entity's page in New Relic (the 'Copy GUID' option in its metadata).

Outputs

entityobject
statustext
Status of the action execution ("success" on success).
warningslist
Example output
{
  "entity": {
    "account_id": 1234567,
    "alert_severity": "NOT_ALERTING",
    "domain": "APM",
    "entity_type": "APM_APPLICATION_ENTITY",
    "guid": "MTIzNDU2N3xBUE18QVBQTElDQVRJT058NDQ1NTY2",
    "name": "checkout-service",
    "permalink": "https://one.newrelic.com/redirect/entity/MTIzNDU2N3xBUE18QVBQTElDQVRJT058NDQ1NTY2",
    "reporting": true,
    "tags": [
      {
        "key": "team",
        "values": [
          "payments"
        ]
      }
    ],
    "type": "APPLICATION"
  },
  "status": "success",
  "warnings": []
}

List accounts

List the New Relic accounts this connection's user can reach, with their numeric ids.

Inputs

None.

Outputs

accountslist
countnumber
How many accounts came back
statustext
Status of the action execution ("success" on success).
warningslist
Example output
{
  "accounts": [
    {
      "id": 1234567,
      "name": "Acme Production"
    }
  ],
  "count": 1,
  "status": "success",
  "warnings": []
}

List alert policies

List an account's alert policies, optionally by name.

Inputs

Accountaccount_idtextRequired
The New Relic account to work in.
Name containsname_containstext
Only policies whose name contains this (any case).
Exact namenametext
Only the policy with exactly this name (any case).
Next page cursorcursortext
Leave empty for the first page. Pass the previous step's next_cursor for the next.

Outputs

next_cursortext
Cursor for the next page
policieslist
statustext
Status of the action execution ("success" on success).
total_countnumber
Total matches
warningslist
Example output
{
  "next_cursor": null,
  "policies": [
    {
      "account_id": 1234567,
      "entity_guid": "MTIzNDU2N3xBSU9QU3xQT0xJQ1l8NTg0MzIxMA",
      "id": "5843210",
      "incident_preference": "PER_CONDITION",
      "name": "Checkout service"
    }
  ],
  "status": "success",
  "total_count": 1,
  "warnings": []
}

List issues

List an account's alert issues, by state, priority, entity and time. Without a time range New Relic returns the last 24 hours.

Inputs

Accountaccount_idtextRequired
The New Relic account to work in.
Statesstateslist
Only issues in these states. Leave empty for all.One or more of: ACTIVATED, CREATED, DEACTIVATED, CLOSED.
Prioritiesprioritieslist
Only issues with these priorities. Leave empty for all.One or more of: CRITICAL, HIGH, MEDIUM, LOW.
Entity GUIDsentity_guidslist
Only issues about these entities.
Fromsincedate and time
Start of the time range. Defaults to 24 hours before To.
Tountildate and time
End of the time range. Defaults to now.
Next page cursorcursortext
Leave empty for the first page. Pass the previous step's next_cursor for the next.

Outputs

countnumber
How many issues on this page
issueslist
next_cursortext
Cursor for the next page
statustext
Status of the action execution ("success" on success).
warningslist
Example output
{
  "count": 1,
  "issues": [
    {
      "account_ids": [
        1234567
      ],
      "acknowledged_at": null,
      "acknowledged_by": null,
      "activated_at": "2026-10-15T08:55:00.000Z",
      "closed_at": null,
      "closed_by": null,
      "created_at": "2026-10-15T08:55:00.000Z",
      "description": null,
      "entity_guids": [
        "MTIzNDU2N3xBUE18QVBQTElDQVRJT058NDQ1NTY2"
      ],
      "entity_names": [
        "checkout-service"
      ],
      "entity_types": [
        "APPLICATION"
      ],
      "is_correlated": false,
      "issue_id": "9f3a1c2e-58b4-4f7e-9b1d-2c6a7e0d4b11",
      "origins": [
        "Alerts"
      ],
      "priority": "CRITICAL",
      "sources": [
        "newrelic"
      ],
      "state": "ACTIVATED",
      "title": "Checkout errors query result is > 10.0",
      "total_incidents": 1,
      "updated_at": "2026-10-15T08:56:00.000Z"
    }
  ],
  "next_cursor": null,
  "status": "success",
  "warnings": []
}

List muting rules

List an account's alert muting rules.

Inputs

Accountaccount_idtextRequired
The New Relic account to work in.
Showstatetext
Which rules to return.One of: all (All rules), enabled (Enabled only), disabled (Disabled only). Default: all.

Outputs

countnumber
How many rules came back
muting_ruleslist
statustext
Status of the action execution ("success" on success).
warningslist
Example output
{
  "count": 1,
  "muting_rules": [
    {
      "account_id": 1234567,
      "action_on_window_ended": "CLOSE_ISSUES_ON_INACTIVE",
      "conditions": [
        {
          "attribute": "policyName",
          "operator": "EQUALS",
          "values": [
            "Checkout service"
          ]
        }
      ],
      "created_at": "2026-10-15T09:00:00Z",
      "description": null,
      "enabled": true,
      "id": "71203",
      "match": "AND",
      "name": "Weekend maintenance",
      "schedule": null,
      "updated_at": "2026-10-15T09:00:00Z"
    }
  ],
  "status": "success",
  "warnings": []
}

List NRQL conditions

List an account's NRQL alert conditions, optionally for one policy.

Inputs

Accountaccount_idtextRequired
The New Relic account to work in.
Alert policypolicy_idtext
Only conditions in this policy. Leave empty for all.
Name containsname_containstext
Only conditions whose name contains this.
Query containsquery_containstext
Only conditions whose NRQL contains this, such as an event type.
Next page cursorcursortext
Leave empty for the first page. Pass the previous step's next_cursor for the next.

Outputs

conditionslist
next_cursortext
Cursor for the next page
statustext
Status of the action execution ("success" on success).
total_countnumber
Total matches
warningslist
Example output
{
  "conditions": [
    {
      "description": null,
      "enabled": true,
      "entity_guid": "MTIzNDU2N3xBSU9QU3xDT05ESVRJT058MzgyNjU1NDE",
      "id": "38265541",
      "name": "Checkout errors",
      "policy_id": "5843210",
      "query": "SELECT count(*) FROM TransactionError",
      "runbook_url": null,
      "terms": [
        {
          "operator": "ABOVE",
          "priority": "CRITICAL",
          "threshold": 10.0,
          "threshold_duration": 300,
          "threshold_occurrences": "ALL"
        }
      ],
      "type": "STATIC",
      "violation_time_limit_seconds": 86400
    }
  ],
  "next_cursor": null,
  "status": "success",
  "total_count": 1,
  "warnings": []
}

Record change

Mark a deployment, feature flag change, business event or operational event on an entity, so it shows on its charts next to the effect it had.

Inputs

Entity GUIDentity_guidtextRequired
The entity the change happened to, from Search entities.
CategorycategorytextRequired
What kind of change this was.One of: Deployment, Deployment Lifecycle, Feature Flag, Business Event, Operational. Default: Deployment.
Typechange_typetextRequired
The kind of change within the category.One of: Basic, Blue Green, Canary, Rolling, Shadow, Artifact Copy, Artifact Deletion, Artifact Deployment, Artifact Move, Build Deletion, and 14 more.
Versionversiontext
The version deployed, such as 1.4.2.Only when Category is Deployment.
Changelogchangelogtext
What changed, or a link to the changelog.Only when Category is Deployment.
Commitcommittext
The commit SHA deployed.Only when Category is Deployment.
Linkdeep_linktext
A link to the deployment, such as the CI run.Only when Category is Deployment.
Feature flagfeature_flag_idtext
The id of the flag that changed.Only when Category is Feature Flag.
Summaryshort_descriptiontext
A one-line summary shown on charts.
Descriptiondescriptiontext
More detail about the change.
Group idgroup_idtext
An id shared by related changes, such as a release train.
Changed bychanged_bytext
Who made the change.
Whentimestampdate and time
When it happened, within the last or next 24 hours. Leave empty for now.

Outputs

change_eventobject
messageslist
statustext
Status of the action execution ("success" on success).
Example output
{
  "change_event": {
    "category": "Deployment",
    "category_and_type": "Deployment/Basic",
    "change_tracking_id": "a1b2c3d4-0000-4000-8000-000000000001",
    "change_type": "Basic",
    "description": null,
    "entity": {
      "guid": "MTIzNDU2N3xBUE18QVBQTElDQVRJT058NDQ1NTY2",
      "name": "checkout-service"
    },
    "group_id": null,
    "short_description": "Deploy 1.4.2",
    "timestamp": "2026-10-15T09:00:00.000Z",
    "user": "ci-bot"
  },
  "messages": [],
  "status": "success"
}

Resolve issue

Close an issue and the incidents in it.

Inputs

Accountaccount_idtextRequired
The New Relic account to work in.
Issue idissue_idtextRequired
The issue's id, from List issues.

Outputs

account_idnumber
The issue's account
actiontext
What New Relic did (RESOLVE)
issue_idtext
The issue resolved
statustext
Status of the action execution ("success" on success).
Example output
{
  "account_id": 1234567,
  "action": "RESOLVE",
  "issue_id": "9f3a1c2e-58b4-4f7e-9b1d-2c6a7e0d4b11",
  "status": "success"
}

Run NRQL query

Run a NRQL query against one account and return its rows, such as error counts, latency percentiles or any event you send to New Relic.

Inputs

Accountaccount_idtextRequired
The New Relic account to work in.
NRQL queryquerytextRequired
For example: SELECT count(*) FROM Transaction SINCE 1 hour ago FACET appName
Timeout (seconds)timeout_secondsnumber
How long New Relic may spend on the query. Leave empty for its default.From 5 to 120.

Outputs

metadataobject
resultslist
The rows, as NRQL returns them
row_countnumber
How many rows came back
statustext
Status of the action execution ("success" on success).
warningslist
Example output
{
  "metadata": {
    "event_types": [
      "Transaction"
    ],
    "facets": [],
    "messages": [],
    "time_window": {
      "begin": "2026-10-15T08:00:00.000Z",
      "compare_with": null,
      "end": "2026-10-15T09:00:00.000Z",
      "since": "60 MINUTES AGO",
      "until": "NOW"
    }
  },
  "results": [
    {
      "count": 1842
    }
  ],
  "row_count": 1,
  "status": "success",
  "warnings": []
}

Search entities

Find services, hosts, browser apps, monitors and other entities by name, domain or type, or with New Relic's entity search syntax. Returns each entity's GUID, which the tag and change actions take.

Inputs

Name containsnametext
Part of the entity's name. Use % as a wildcard, such as checkout%.
Domaindomaintext
Only entities from this part of New Relic.One of: APM (APM (services)), BROWSER (Browser apps), EXT (External / other), INFRA (Infrastructure (hosts)), MOBILE (Mobile apps), SYNTH (Synthetic monitors).
Entity typeentity_typetext
Only this type, such as APPLICATION, HOST or MONITOR.
Search queryquerytext
Advanced: a full entity search, such as tags.team = 'payments' and reporting = 'true'. Used instead of the fields above when given.
Next page cursorcursortext
Leave empty for the first page. Pass the previous step's next_cursor for the next.

Outputs

countnumber
Total matches across all pages
entitieslist
next_cursortext
Cursor for the next page; empty on the last
querytext
The search that was run
statustext
Status of the action execution ("success" on success).
warningslist
Example output
{
  "count": 1,
  "entities": [
    {
      "account_id": 1234567,
      "alert_severity": "NOT_ALERTING",
      "domain": "APM",
      "entity_type": "APM_APPLICATION_ENTITY",
      "guid": "MTIzNDU2N3xBUE18QVBQTElDQVRJT058NDQ1NTY2",
      "name": "checkout-service",
      "permalink": "https://one.newrelic.com/redirect/entity/MTIzNDU2N3xBUE18QVBQTElDQVRJT058NDQ1NTY2",
      "reporting": true,
      "tags": [
        {
          "key": "team",
          "values": [
            "payments"
          ]
        }
      ],
      "type": "APPLICATION"
    }
  ],
  "next_cursor": null,
  "query": "name like 'checkout%'",
  "status": "success",
  "warnings": []
}

Update alert policy

Rename an alert policy or change how it groups issues.

Inputs

Accountaccount_idtextRequired
The New Relic account to work in.
Alert policypolicy_idtextRequired
The alert policy. Pick one, or use an id from List alert policies.
New namenametext
Leave empty to keep the current name.
Group issuesincident_preferencetext
Leave empty to keep the current grouping.One of: PER_POLICY (One issue per policy), PER_CONDITION (One issue per condition), PER_CONDITION_AND_TARGET (One issue per condition and entity).

Outputs

policyobject
statustext
Status of the action execution ("success" on success).
Example output
{
  "policy": {
    "account_id": 1234567,
    "entity_guid": "MTIzNDU2N3xBSU9QU3xQT0xJQ1l8NTg0MzIxMA",
    "id": "5843210",
    "incident_preference": "PER_CONDITION",
    "name": "Checkout service"
  },
  "status": "success"
}

On this page