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
| Action | What it does |
|---|---|
| Acknowledge issue | Acknowledge an issue, so others can see someone is on it. |
| Add entity tags | Add tags to an entity. |
| Create alert policy | Create an alert policy to hold conditions. |
| Create muting rule | Silence notifications for incidents matching a rule, such as everything from one policy during a maintenance window. |
| 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. |
| Delete alert condition | Delete an alert condition of any type by its id. |
| Delete alert policy | Delete an alert policy, together with all of its conditions. |
| Delete entity tags | Remove tags, with all their values, from an entity by tag name. |
| Delete muting rule | Delete a muting rule by its id. |
| Get entity | Read one entity by its GUID: its name, type, alert status and tags. |
| List accounts | List the New Relic accounts this connection's user can reach, with their numeric ids. |
| List alert policies | List an account's alert policies, optionally by name. |
| List issues | List an account's alert issues, by state, priority, entity and time. |
| List muting rules | List an account's alert muting rules. |
| List NRQL conditions | List an account's NRQL alert conditions, optionally for one policy. |
| 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. |
| Resolve issue | Close an issue and the incidents in it. |
| 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. |
| Search entities | Find services, hosts, browser apps, monitors and other entities by name, domain or type, or with New Relic's entity search syntax. |
| Update alert policy | Rename an alert policy or change how it groups issues. |
Acknowledge issue
Acknowledge an issue, so others can see someone is on it.
Inputs
- Account
account_idtextRequired - The New Relic account to work in.
- Issue id
issue_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 GUID
guidtextRequired - The entity's GUID, from Search entities or the entity's page in New Relic (the 'Copy GUID' option in its metadata).
- Tags
tagsobjectRequired - 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
- Account
account_idtextRequired - The New Relic account to work in.
- Name
nametextRequired - The policy's name.
- Group issues
incident_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
policyobjectstatustext- 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
- Account
account_idtextRequired - The New Relic account to work in.
- Name
nametextRequired - The rule's name.
- Mute incidents where
attributetextRequired - 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 name
tag_nametext - The entity tag to match, such as team.Only when Mute incidents where is Entity tag (name it below).
- Matches
operatortextRequired - 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. - Values
valueslist - The values to compare with. Not needed for Is blank or Is not blank.
- Enabled
enabledtrue/false - Whether the rule mutes anything yet.Default:
true. - Description
descriptiontext - Why the rule exists.
- Starts
starts_atdate and time - When muting starts. Leave both times empty to mute until the rule is disabled.
- Ends
ends_atdate and time - When muting ends.
- Time zone
time_zonetext - The schedule's time zone, such as Europe/London. Defaults to UTC.
- Repeat
repeattext - Whether the window repeats.One of:
NONE(Does not repeat),DAILY,WEEKLY,MONTHLY. Default:NONE. - On
weekly_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 until
repeat_untildate and time - When the repeating stops. Leave empty to repeat indefinitely.Only when Repeat is Daily, Weekly or Monthly.
- When the window ends
action_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_ruleobjectstatustext- 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
- Account
account_idtextRequired - The New Relic account to work in.
- Alert policy
policy_idtextRequired - The alert policy. Pick one, or use an id from List alert policies.
- Name
nametextRequired - The condition's name.
- NRQL query
querytextRequired - A query returning one number, without SINCE or UNTIL, such as SELECT count(*) FROM TransactionError
- Alert when the value is
operatortextRequired - 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 threshold
thresholdnumberRequired - 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.
- Crossed
threshold_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 threshold
warning_thresholdnumber - Optional: a value that opens a warning, compared the same way.
- Enabled
enabledtrue/false - Whether the condition starts evaluating straight away.Default:
true. - Aggregation
aggregation_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 gaps
fill_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 value
fill_valuenumber - The value used for windows with no data.Only when Fill gaps is Use a fixed value.
- Description
descriptiontext - Shown on incidents from this condition.
- Runbook URL
runbook_urltext - A link responders should follow.
- Issue title
title_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
conditionobjectstatustext- 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
- Account
account_idtextRequired - The New Relic account to work in.
- Condition id
condition_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
- Account
account_idtextRequired - The New Relic account to work in.
- Alert policy
policy_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 GUID
guidtextRequired - The entity's GUID, from Search entities or the entity's page in New Relic (the 'Copy GUID' option in its metadata).
- Tag names
tag_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
- Account
account_idtextRequired - The New Relic account to work in.
- Muting rule id
rule_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 GUID
guidtextRequired - The entity's GUID, from Search entities or the entity's page in New Relic (the 'Copy GUID' option in its metadata).
Outputs
entityobjectstatustext- 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
accountslistcountnumber- 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
- Account
account_idtextRequired - The New Relic account to work in.
- Name contains
name_containstext - Only policies whose name contains this (any case).
- Exact name
nametext - Only the policy with exactly this name (any case).
- Next page cursor
cursortext - Leave empty for the first page. Pass the previous step's next_cursor for the next.
Outputs
next_cursortext- Cursor for the next page
policiesliststatustext- 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
- Account
account_idtextRequired - The New Relic account to work in.
- States
stateslist - Only issues in these states. Leave empty for all.One or more of:
ACTIVATED,CREATED,DEACTIVATED,CLOSED. - Priorities
prioritieslist - Only issues with these priorities. Leave empty for all.One or more of:
CRITICAL,HIGH,MEDIUM,LOW. - Entity GUIDs
entity_guidslist - Only issues about these entities.
- From
sincedate and time - Start of the time range. Defaults to 24 hours before To.
- To
untildate and time - End of the time range. Defaults to now.
- Next page cursor
cursortext - Leave empty for the first page. Pass the previous step's next_cursor for the next.
Outputs
countnumber- How many issues on this page
issueslistnext_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
- Account
account_idtextRequired - The New Relic account to work in.
- Show
statetext - 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_rulesliststatustext- 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
- Account
account_idtextRequired - The New Relic account to work in.
- Alert policy
policy_idtext - Only conditions in this policy. Leave empty for all.
- Name contains
name_containstext - Only conditions whose name contains this.
- Query contains
query_containstext - Only conditions whose NRQL contains this, such as an event type.
- Next page cursor
cursortext - Leave empty for the first page. Pass the previous step's next_cursor for the next.
Outputs
conditionslistnext_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 GUID
entity_guidtextRequired - The entity the change happened to, from Search entities.
- Category
categorytextRequired - What kind of change this was.One of:
Deployment,Deployment Lifecycle,Feature Flag,Business Event,Operational. Default:Deployment. - Type
change_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. - Version
versiontext - The version deployed, such as 1.4.2.Only when Category is Deployment.
- Changelog
changelogtext - What changed, or a link to the changelog.Only when Category is Deployment.
- Commit
committext - The commit SHA deployed.Only when Category is Deployment.
- Link
deep_linktext - A link to the deployment, such as the CI run.Only when Category is Deployment.
- Feature flag
feature_flag_idtext - The id of the flag that changed.Only when Category is Feature Flag.
- Summary
short_descriptiontext - A one-line summary shown on charts.
- Description
descriptiontext - More detail about the change.
- Group id
group_idtext - An id shared by related changes, such as a release train.
- Changed by
changed_bytext - Who made the change.
- When
timestampdate and time - When it happened, within the last or next 24 hours. Leave empty for now.
Outputs
change_eventobjectmessagesliststatustext- 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
- Account
account_idtextRequired - The New Relic account to work in.
- Issue id
issue_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
- Account
account_idtextRequired - The New Relic account to work in.
- NRQL query
querytextRequired - 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
metadataobjectresultslist- 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 contains
nametext - Part of the entity's name. Use % as a wildcard, such as checkout%.
- Domain
domaintext - 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 type
entity_typetext - Only this type, such as APPLICATION, HOST or MONITOR.
- Search query
querytext - Advanced: a full entity search, such as tags.team = 'payments' and reporting = 'true'. Used instead of the fields above when given.
- Next page cursor
cursortext - Leave empty for the first page. Pass the previous step's next_cursor for the next.
Outputs
countnumber- Total matches across all pages
entitieslistnext_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
- Account
account_idtextRequired - The New Relic account to work in.
- Alert policy
policy_idtextRequired - The alert policy. Pick one, or use an id from List alert policies.
- New name
nametext - Leave empty to keep the current name.
- Group issues
incident_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
policyobjectstatustext- 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"
}