New Relic Notification actions

preview

We're still working on this feature, but we'd love for you to try it out!

This feature is currently provided as part of a preview program pursuant to our pre-release policies.

This page provides a comprehensive reference for new relic notification actions available in the workflow automation actions catalog. These actions enable you to send notifications through new relic.

Prerequisites

Before using New Relic actions in workflow automation, ensure you have:

A New Relic account with appropriate permissions.
A New Relic license key (if sending data to a different account).
The necessary permissions for the specific New Relic services you plan to use.

See License Key for information on how to create and manage your New Relic Account License Key.

Notifications actions

Send messages or emails to New Relic destinations. The user must first create the appropriate destination within New Relic. Once created, the same destination should be used in this action to send the message from a workflow.

Input	Optionality	Type	Description	Example
type	Required	String	Type of newrelic destination	`slack, email, microsoft teams`
destinationId	Required	String	DestinationId associated with the newrelic destination. Refer to NerdGraph tutorial: Alerts destinations on how to configure a new destination and listing destination Id. Refer to Destinations to know more about destinations.	`123e4567-e89b-12d3-a456-426614174000`
parameters	Required	Map	Fields required to send notification to chosen destination type.	`{\"channel\": \"${{ YOUR_CHANNEL }}\", \"text\": \"Enter your text here\"}` or `{\"subject\": \"${{ subject }}\", \"message\": \"Enter your message here\"}`
attachments	Optional	List	A list of optional attachment
attachment.type	Required	Enum	One of: `QUERY`, `RAW`
attachment.query	Optional	String	For `QUERY` type, this is NRQL query statement.	`SELECT * FROM LOG`
attachment.accountIds	Optional	List	For `QUERY`, the New Relic Account IDs to execute the query. If not provided, the account associated with the workflow's execution is used.	`[12345567]`
attachment.format	Optional	Enum	For `QUERY`, specify the type for the results, default JSON	`JSON CSV`
attachment.content	Optional	String	For `RAW`, the content of the attachment in UTF-8.	`A,B,C\n1,2,3`
attachment.filename	Optional	String	A filename for the attachment.	`log_count.csv`
selectors	Optional	List	The selectors to get the only specified parameters as output.	`[{\"name\": \"success\", \"expression\": \".success\"},{\"name\": \"attachments\", \"expression\": \".response.attachments\"},{\"name\": \"sessionId\", \"expression\": \".response.sessionId\"}]`

Output	Type	Example
sessionId	String	`"sessionId": "7fa97f26-3791-492e-a39b-53793163dfb9"`
errorMessage	String	`Channel is a required field in the notification send"`
attachments	List	`[{ "blobId": "43werdtfgvhiu7y8t6r5e4398yutfgvh", "rowCount": 100 }]`
sessionId	String	`"sessionId": "7fa97f26-3791-492e-a39b-53793163dfb9"`

Important

Attachments are not currently supported when sending messages to a Slack destination through this workflow action.

Slack

name: slack_notification_workflow
  description: This is a test workflow to test slack notification send action
  steps:

name: SendMessageUsingSlackChannel type: action action: newrelic.notification.send version: 1 inputs: type: slack destinationId: ccd0d926-ed6f-4ddd-bc7d-b7ea9822908d parameters: text: Hi , Testing notifcation api using slack channel name channel: test-channel-workflow

Email

name: emailer-workflow
  description: send email using workflow 
  steps:

name: emailReport1 type: action action: newrelic.notification.email version: 1 inputs: type: email destinationId: "e7a5a004-424d-44db-a3df-266980a90242" parameters: subject: "workflow notification" message: "this is a message." attachments:
- type: QUERY query: "SELECT * FROM Log" format: CSV filename: "log_count.csv" selectors:
- name: success expression: '.success'
- name: sessionId expression: '.response.sessionId'
- name: attachments expression: '.response.attachments'

Sends a message to a MS team channel, integrated with destinations.

Input Field	Optionality	Datatype	Description	Example
destinationId	Required	String	DestinationId associated with the newrelic destination. Refer New Relic integration for Microsoft Teams for steps on how to configure a new destination and listing destination Id. Refer Destinations to know more about destinations.	`123e4567-e89b-12d3-a456-426614174000`
teamName	Required	String	Team name associated with given destination id	`TEST_TEAM`
channelName	Required	String	Channel name where message need to be sent	`StagingTesting`
message	Required	String	Text message which need to be sent	`Hello! this message from Workflow`
selectors	Optional	List	The selectors to get the only specified parameters as output.	`[{\"name\": \"success\", \"expression\": \".success\"}]`

Output Field	Type	Example
success	Boolean	`true/false`
sessionId	String	`"sessionId": "7fa97f26-3791-492e-a39b-53793163dfb9"`
errorMessage	String	`Message is a required field in the notification send"`

Workflow example
`name: msTeam_notification_workflow description: This is a test workflow to test MSTeam notification send action steps: - name: SendMessageUsingMSTeam type: action action: newrelic.notification.sendMicrosoftTeams version: 1 inputs: destinationId: acc24dc2-d4fc-4eba-a7b4-b3ad0170f8aa channel: DEV_TESTING teamName: TEST_TEAM_DEV message: Hello from Workflow`

Workflow example

name: msTeam_notification_workflow
  description: This is a test workflow to test MSTeam notification send action
  steps:
    - name: SendMessageUsingMSTeam
      type: action
      action: newrelic.notification.sendMicrosoftTeams
      version: 1
      inputs:
        destinationId: acc24dc2-d4fc-4eba-a7b4-b3ad0170f8aa
        channel: DEV_TESTING
        teamName: TEST_TEAM_DEV
        message: Hello from Workflow

Sends a email to NewRelic email destinations with or without attachments

Input field	Optionality	Datatype	Description	Example
destinationId	Required	String	DestinationId associated with the newrelic destination. Refer New Relic integration for Microsoft Teams for steps on how to configure a new destination and listing destination Id. Refer Destinations to know more about destinations.	`123e4567-e89b-12d3-a456-426614174000`
subject	Required	String	Subject of email	`workflow-notification`
message	Required	String	Message which need to be send in email	`Hello! from Workflow Automation`
attachments	Optional	List	A list of optional attachment
attachment.type	Required	Enum	One of: `QUERY`, `RAW`
attachment.query	Optional	String	For `QUERY` type, this is NRQL query statement.	`SELECT * FROM LOG`
attachment.accountIds	Optional	List	For `QUERY`, the New Relic Account IDs to execute the query. If not provided, the account associated with the workflow's execution is used.	`[12345567]`
attachment.format	Optional	Enum	For `QUERY`, specify the type for the results, default `JSON`	`JSON CSV`
attachment.content	Optional	String	For `RAW`, this is the content to for the attachment in UTF-8.	`A,B,C\n1,2,3`
attachment.filename	Optional	String	A filename for the attachment	`log_count.csv`
selectors	Optional	List	The selectors to get the only specified parameters as output.	`[{\"name\": \"success\", \"expression\": \".success\"},{\"name\": \"attachments\", \"expression\": \".response.attachments\"},{\"name\": \"sessionId\", \"expression\": \".response.sessionId\"}]`

Output Field	Type	Example
success	Boolean	`true/false`
sessionId	String	`"sessionId": "7fa97f26-3791-492e-a39b-53793163dfb9"`
errorMessage	String	`Channel is a required field in the notification send"`
attachments	List	`[{ "blobId": "43werdtfgvhiu7y8t6r5e4398yutfgvh", "rowCount": 100 }]`

Workflow example
name: email_testing_with_attachment description: Workflow to test sending an email notification via NewRelic with log step workflowInputs: destinationId: type: String steps: - name: sendEmailNotification type: action action: newrelic.notification.sendEmail version: '1' inputs: destinationId: ${{ .workflowInputs.destinationId }} subject: "workflow notification" message: "Workflow Email Notification Testing from local" attachments: - type: QUERY query: "SELECT * FROM Log" format: JSON filename: "log_count.json" selectors: - name: success expression: '.success' - name: sessionId expression: '.response.sessionId' - name: attachments expression: '.response.attachments' - name: logOutput type: action action: newrelic.ingest.sendLogs version: '1' inputs: logs: - message: "Hello from cap check Testing staging server user2 : ${{ .steps.sendEmailNotification.outputs.result.attachments }}" licenseKey: ${{ :secrets:STAGING_NEW_RELIC_LICENSE_KEY }}

Workflow example

name: email_testing_with_attachment
  description: Workflow to test sending an email notification via NewRelic with log step
  workflowInputs:
    destinationId:
      type: String
  steps:
    - name: sendEmailNotification
      type: action
      action: newrelic.notification.sendEmail
      version: '1'
      inputs:
        destinationId: ${{ .workflowInputs.destinationId }}
        subject: "workflow notification"
        message: "Workflow Email Notification Testing from local"
        attachments:
          - type: QUERY
            query: "SELECT * FROM Log"
            format: JSON
            filename: "log_count.json"
        selectors:
          - name: success
            expression: '.success'
          - name: sessionId
            expression: '.response.sessionId'
          - name: attachments
            expression: '.response.attachments'
    - name: logOutput
      type: action
      action: newrelic.ingest.sendLogs
      version: '1'
      inputs:
        logs:
          - message: "Hello from cap check Testing staging server user2 : ${{ .steps.sendEmailNotification.outputs.result.attachments }}"
        licenseKey: ${{ :secrets:STAGING_NEW_RELIC_LICENSE_KEY }}

Sends a slack message to a channel, integrated with destinations .

Input Field	Optionality	Datatype	Description	Example
destinationId	Required	String	DestinationId associated with the newrelic destination. Refer NerdGraph tutorial: Alerts destinations for steps on how to configure a new destination and listing destination Id. Refer Destinations to know more about destinations.	`123e4567-e89b-12d3-a456-426614174000`
text	Required	String	Text message which need to be sent	Hello ! this message from Workflow
channel	Required	String	Channel name where message will be sent	help-nomad
selectors	Optional	List	The selectors to get the only specified parameters as output.	`[{\"name\": \"success\", \"expression\": \".success\"}]`

Output Field	Type	Example
success	Boolean	`true/false`
sessionId	String	`"sessionId": "7fa97f26-3791-492e-a39b-53793163dfb9"`
errorMessage	String	`Channel is a required field in the notification send"`

Workflow example
`name: slack_notification_workflow description: This is a test workflow to test slack notification send action steps: - name: SendMessageUsingSlackChannel type: action action: newrelic.notification.sendSlack version: 1 inputs: destinationId: ccd0d926-ed6f-4ddd-bc7d-b7ea9822908d text: Hi , Testing notifcation api using slack channel name channel: test-channel-workflow`

Workflow example

name: slack_notification_workflow
  description: This is a test workflow to test slack notification send action
  steps:
    - name: SendMessageUsingSlackChannel
      type: action
      action: newrelic.notification.sendSlack
      version: 1
      inputs:
        destinationId: ccd0d926-ed6f-4ddd-bc7d-b7ea9822908d
        text: Hi , Testing notifcation api using slack channel name
        channel: test-channel-workflow

Runs a workflow through the NerdGraph API.

Input Field	Optionality	Datatype	Description
definitionName	Required	String	Name of the workflow definition.
definitionScopeType	Optional	String	Scope type of the workflow definition. Scope type must be either `ACCOUNT` or `ORGANIZATION`.
definitionVersion	Optional	Int	Version of the workflow definition
idempotencyKey	Optional	String	Unique identifier to ensure idempotency of the request. It should be a UUID.
workflowInputs	Optional	List	Version of the workflow definition
runScopeType	Required	String	Scope type of the workflow. Scope type must be `ACCOUNT`. We'll support starting a workflow at the organization level in the future
runScopeId	Required	String	Scope id of the workflow. Scope type must be accountId for now.
selectors	Optional	List	The selectors to get the only specified parameters as output.

Example

steps:
  - name: startHealthyHeartbeat
    type: action
    action: newrelic.workflowAutomation.startWorkflowRun
    version: 1
    inputs:
      definitionName: "heartbeat_newrelicIngestSendEvents_10062025"
      definitionVersion: 1
      scopeType: "ACCOUNT"
      definitionScopeType: "d34568b7-ee0b-4191-b663-7b2925b0de5b"
      workflowInputs:
        - key: "cellName"
          value: "stg-joint-effort"
      runScopeType: "ACCOUNT"
      runScopeId: "11544325"

Output Field	Type	Example
runId		Unique identifier for the workflow run
success	Boolean	`Status of the request.`
errorMessage	String	`Failure reason as message.`

Workflow example
`{ "success": true "runId": "00dc031f-c1cc-4d26-a3fb-6153c553c66b" }`

preview

Prerequisites

Notifications actions

Send Notification to NewRelic Destination

NerdGraph Query to get destinationId

For parameter refer

Important

Sends Notification to NewRelic Microsoft Teams

NerdGraph Query to get destinationId

Sends Notification to NewRelic Email

NerdGraph Query to get destinationId

Send a Slack message

NerdGraph Query to get destinationId

Run a workflow

Example

New Relic Notification actions

preview

Prerequisites.css-21sua1{background:none;border:none;width:0;padding:0;}

Notifications actions

NerdGraph Query to get destinationId

For parameter refer

Sends Notification to NewRelic Microsoft Teams

NerdGraph Query to get destinationId

Sends Notification to NewRelic Email

NerdGraph Query to get destinationId

Send a Slack message

NerdGraph Query to get destinationId

Run a workflow

Prerequisites