Manage cross account destinations

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.

Use the NerdGraph API to create, test, list, update, and delete cross account destinations. Cross account destinations allow you to centralize notification management at the organization level.

Create a destination

In order to create a destination, different inputs must be provided for each destination type.

Importante

You must provide a scope object identifying where the destination will be created. The scope object requires:

id: The ID of the Account or Organization.
type: The type of scope (Account or Organization).

An optional two_way_integration property is available for integrations that allow two-way integration.

Use aiNotificationsCreateDestination mutation to create a Jira destination that integrates with your Atlassian Jira instance for creating and managing issues from New Relic alerts.

Input parameters

Parameter name	Data type	Description
`scope`	Object	(Required) Defines the scope where the destination will be created. Use `type: ORGANIZATION` for cross account destinations or `type: ACCOUNT` for account-level destinations.
`scope.id`	String	(Required) The organization ID for cross account destinations or account ID for account-level destinations.
`scope.type`	Enum	(Required) Must be `ORGANIZATION` for cross account destinations or `ACCOUNT` for account-level destinations.
`destination.type`	Enum	(Required) Must be `JIRA` for Atlassian Jira destinations.
`destination.name`	String	(Required) A descriptive name for the Jira destination.
`destination.auth`	Object	(Required) Authentication configuration for connecting to your Jira instance.
`destination.auth.type`	Enum	(Required) Must be `BASIC` for Jira integrations using username and password/API token authentication.
`destination.auth.basic`	Object	(Required) Contains the Jira authentication credentials (email and password/API token).
`destination.auth.basic.user`	String	(Required) Your Jira account email address.
`destination.auth.basic.password`	String	(Required) Your Jira account password or API token. For security, use an API token instead of your account password.
`destination.properties`	Array of Objects	(Required) Configuration properties including the Jira instance URL and integration options.
`destination.properties[].key: "url"`	String	(Required) Must include a property with key "url" and value set to your Jira instance URL (e.g., "https://yourcompany.atlassian.net").
`destination.properties[].key: "two_way_integration"`	String	(Optional) Set to "true" to enable bidirectional integration between New Relic and Jira.

Sample query for an account and organization:

mutation {
  aiNotificationsCreateDestination(
    scope: { id: YOUR_ACCOUNT_ID, type: ACCOUNT }
    destination: {
      type: JIRA
      name: "Destination Name"
      auth: {
        type: BASIC
        basic: { user: YOUR_EMAIL, password: YOUR_PASSWORD }
      }
      properties: [
        { key: "url", value: "https://YOUR_INSTANCE.atlassian.net" }
        { key: "two_way_integration", value: "true" }
      ]
    }
  ) {
    destination {
      id
      name
      scope {
        id
        type
      }
    }
  }
}

Sample query for an organization:

mutation {
  aiNotificationsCreateDestination(
    scope: { id: YOUR_ORGANIZATION_ID, type: ORGANIZATION }
    destination: {
      type: JIRA
      name: "Destination Name"
      auth: {
        type: BASIC
        basic: { user: YOUR_EMAIL, password: YOUR_PASSWORD }
      }
      properties: [
        { key: "url", value: "https://YOUR_INSTANCE.atlassian.net" }
        { key: "two_way_integration", value: "true" }
      ]
    }
  ) {
    destination {
      id
      name
      scope {
        id
        type
      }
    }
  }
}

Use aiNotificationsCreateDestination mutation to create an email destination for sending notification alerts to email addresses.

Input parameters

Parameter name	Data type	Description
`scope`	Object	(Required) Defines the scope where the destination will be created. Use `type: ORGANIZATION` for cross account destinations or `type: ACCOUNT` for account-level destinations.
`scope.id`	String	(Required) The organization ID for cross account destinations or account ID for account-level destinations.
`scope.type`	Enum	(Required) Must be `ORGANIZATION` for cross account destinations or `ACCOUNT` for account-level destinations.
`destination.type`	Enum	(Required) Must be `EMAIL` for email destinations.
`destination.name`	String	(Required) A descriptive name for the email destination.
`destination.properties`	Array of Objects	(Required) Key-value pairs containing the email configuration. Must include an `email` key with the target email address as the value.

Sample query:

mutation {
  aiNotificationsCreateDestination(
    scope: { id: YOUR_ACCOUNT_ID, type: ACCOUNT }
    destination: {
      type: EMAIL
      name: "Destination Name"
      properties: [{ key: "email", value: YOUR_EMAIL }]
    }
  ) {
    destination {
      id
      name
      scope {
        id
        type
      }
    }
  }
}

Use aiNotificationsCreateDestination mutation to create a webhook destination for sending HTTP POST requests to external endpoints when alerts are triggered.

Input parameters

Parameter name	Data type	Description
`scope`	Object	(Required) Defines the scope where the destination will be created. Use `type: ORGANIZATION` for cross account destinations or `type: ACCOUNT` for account-level destinations.
`scope.id`	String	(Required) The organization ID for cross account destinations or account ID for account-level destinations.
`scope.type`	Enum	(Required) Must be `ORGANIZATION` for cross account destinations or `ACCOUNT` for account-level destinations.
`destination.type`	Enum	(Required) Must be `WEBHOOK` for webhook destinations.
`destination.name`	String	(Required) A descriptive name for the webhook destination.
`destination.auth`	Object	(Optional) Authentication configuration. Required only when the webhook endpoint requires authentication.
`destination.auth.type`	Enum	(Required when auth is provided) Authentication method. Options: `BASIC`, `TOKEN`.
`destination.auth.basic`	Object	(Required for BASIC and TOKEN auth) Contains authentication credentials such as username/password or token information.
`destination.properties`	Array of Objects	(Required) Key-value pairs containing webhook configuration. Must include `url` key with the webhook endpoint URL. Optional `two_way_integration` for bidirectional communication.

Sample query:

mutation {
  aiNotificationsCreateDestination(
    scope: { id: YOUR_ACCOUNT_ID, type: ACCOUNT }
    destination: {
      type: WEBHOOK
      name: "Destination Name"
      auth: {
        type: BASIC
        basic: { user: YOUR_EMAIL, password: YOUR_PASSWORD }
      }
      properties: [
        { key: "url", value: YOUR_WEBHOOK }
        { key: "two_way_integration", value: "true" }
      ]
    }
  ) {
    destination {
      id
      name
      scope {
        id
        type
      }
    }
  }
}

Use aiNotificationsCreateDestination mutation to create a PagerDuty service-level destination that integrates with a specific PagerDuty service using an integration key.

Input parameters

Parameter name	Data type	Description
`scope`	Object	(Required) Defines the scope where the destination will be created. Use `type: ORGANIZATION` for cross account destinations or `type: ACCOUNT` for account-level destinations.
`scope.id`	String	(Required) The organization ID for cross account destinations or account ID for account-level destinations.
`scope.type`	Enum	(Required) Must be `ORGANIZATION` for cross account destinations or `ACCOUNT` for account-level destinations.
`destination.type`	Enum	(Required) Must be `PAGERDUTY_SERVICE_INTEGRATION` for PagerDuty service-level destinations.
`destination.name`	String	(Required) A descriptive name for the PagerDuty service destination.
`destination.auth`	Object	(Required) Authentication configuration containing the PagerDuty integration key.
`destination.auth.type`	Enum	(Required) Must be `TOKEN` for PagerDuty service integrations.
`destination.auth.basic`	Object	(Required) Contains the integration token and prefix for PagerDuty authentication.
`destination.auth.basic.token`	String	(Required) The PagerDuty integration key obtained from your PagerDuty service configuration.
`destination.auth.basic.prefix`	String	(Required) Must be `"Token token="` for PagerDuty service integrations.
`destination.properties`	Array of Objects	(Optional) Additional configuration properties. Can be empty array for basic service integration.

Sample query:

mutation {
  aiNotificationsCreateDestination(
    scope: { id: YOUR_ACCOUNT_ID, type: ACCOUNT }
    destination: {
      type: PAGERDUTY_SERVICE_INTEGRATION
      name: "Destination Name"
      auth: {
        type: TOKEN
        basic: { token: YOUR_INTEGRATION_TOKEN, prefix: "Token token=" }
      }
      properties: []
    }
  ) {
    destination {
      id
      name
      scope {
        id
        type
      }
    }
  }
}

Use aiNotificationsCreateDestination mutation to create a PagerDuty account-level destination that integrates with your entire PagerDuty account using an API key, allowing for broader incident management capabilities.

Input parameters

Parameter name	Data type	Description
`scope`	Object	(Required) Defines the scope where the destination will be created. Use `type: ORGANIZATION` for cross account destinations or `type: ACCOUNT` for account-level destinations.
`scope.id`	String	(Required) The organization ID for cross account destinations or account ID for account-level destinations.
`scope.type`	Enum	(Required) Must be `ORGANIZATION` for cross account destinations or `ACCOUNT` for account-level destinations.
`destination.type`	Enum	(Required) Must be `PAGERDUTY_ACCOUNT_INTEGRATION` for PagerDuty account-level destinations.
`destination.name`	String	(Required) A descriptive name for the PagerDuty account destination.
`destination.auth`	Object	(Required) Authentication configuration containing the PagerDuty account API key.
`destination.auth.type`	Enum	(Required) Must be `TOKEN` for PagerDuty account integrations.
`destination.auth.basic`	Object	(Required) Contains the API token and prefix for PagerDuty account authentication.
`destination.auth.basic.token`	String	(Required) The PagerDuty account API key obtained from your PagerDuty account settings.
`destination.auth.basic.prefix`	String	(Required) Must be `"Token token="` for PagerDuty account integrations.
`destination.properties`	Array of Objects	(Optional) Configuration properties for the account integration. Common property: `two_way_integration` set to "true" for bidirectional communication.

Sample query:

mutation {
  aiNotificationsCreateDestination(
    scope: { id: YOUR_ACCOUNT_ID, type: ACCOUNT }
    destination: {
      type: PAGERDUTY_ACCOUNT_INTEGRATION
      name: "Global PagerDuty Account"
      auth: {
        type: TOKEN
        basic: { token: YOUR_API_KEY, prefix: "Token token=" }
      }
      properties: [{ key: "two_way_integration", value: "true" }]
    }
  ) {
    destination {
      id
      name
      scope {
        id
        type
      }
    }
  }
}

Creating a cross-account Slack destination in New Relic requires OAuth authentication between the NerdGraph API and Slack. The following steps show you how to generate the authentication URL and complete the setup.

Generate the OAuth URL

Open the NerdGraph Explorer and paste the following query into the query editor. This query generates a unique Slack OAuth URL for your organization.

{
  actor {
    organization {
      aiNotifications {
        oAuthUrl(type: SLACK) {
          url
          transactionId
          error {
            description
            details
            type
          }
        }
      }
    }
  }
}

Click Play (Execute Query) at the top of the explorer.

Access the authentication link

Once the query runs, you will see a JSON response on the right side of the screen containing a URL.
Locate the url field in the response.
Copy the entire URL string (everything inside the quotation marks).
Open a new tab in your browser and paste the URL.

Complete Slack authorization

The link takes you to a Slack authorization page.
If prompted, sign in to the Slack workspace you want to connect.
Review the permissions requested by New Relic.
To authorize the connection, click Allow.
You should be redirected back to a New Relic "Success" page.

Verify the destination

After successful OAuth authentication, the destination is automatically created at the organization level, making it available across all accounts in your organization.

Navigate to one.newrelic.com > Alerts > Destinations.
In the Destinations list, you should now see a new entry for the Slack workspace you just authenticated.

Use aiNotificationsCreateDestination mutation to create a ServiceNow destination that integrates with your ServiceNow instance for creating and managing incidents from New Relic alerts.

Input parameters

Parameter name	Data type	Description
`scope`	Object	(Required) Defines the scope where the destination will be created. Use `type: ORGANIZATION` for cross account destinations or `type: ACCOUNT` for account-level destinations.
`scope.id`	String	(Required) The organization ID for cross account destinations or account ID for account-level destinations.
`scope.type`	Enum	(Required) Must be `ORGANIZATION` for cross account destinations or `ACCOUNT` for account-level destinations.
`destination.type`	Enum	(Required) Must be `SERVICE_NOW` for ServiceNow destinations.
`destination.name`	String	(Required) A descriptive name for the ServiceNow destination.
`destination.auth`	Object	(Required) Authentication configuration for connecting to your ServiceNow instance.
`destination.auth.type`	Enum	(Required) Must be `BASIC` for ServiceNow integrations using username and password authentication.
`destination.auth.basic`	Object	(Required) Contains the ServiceNow authentication credentials (username and password).
`destination.auth.basic.user`	String	(Required) Your ServiceNow account username or email address.
`destination.auth.basic.password`	String	(Required) Your ServiceNow account password. Consider using a service account for better security.
`destination.properties`	Array of Objects	(Required) Configuration properties including the ServiceNow instance URL and integration options.
`destination.properties[].key: "url"`	String	(Required) Must include a property with key "url" and value set to your ServiceNow instance URL (e.g., "https://yourcompany.service-now.com").
`destination.properties[].key: "two_way_integration"`	String	(Optional) Set to "true" to enable bidirectional integration between New Relic and ServiceNow.

Sample query:

mutation {
  aiNotificationsCreateDestination(
    scope: { id: YOUR_ACCOUNT_ID, type: ACCOUNT }
    destination: {
      type: SERVICE_NOW
      name: "Destination Name"
      auth: {
        type: BASIC
        basic: { user: YOUR_EMAIL, password: YOUR_PASSWORD }
      }
      properties: [
        { key: "url", value: "https://YOUR_INSTANCE.service-now.com" }
        { key: "two_way_integration", value: "true" }
      ]
    }
  ) {
    destination {
      id
      name
      scope {
        id
        type
      }
    }
  }
}

Use aiNotificationsCreateDestination mutation to create an AWS EventBridge destination that sends New Relic alert events to your AWS EventBridge for further processing and routing within your AWS ecosystem.

Input parameters

Parameter name	Data type	Description
`scope`	Object	(Required) Defines the scope where the destination will be created. Use `type: ORGANIZATION` for cross account destinations or `type: ACCOUNT` for account-level destinations.
`scope.id`	String	(Required) The organization ID for cross account destinations or account ID for account-level destinations.
`scope.type`	Enum	(Required) Must be `ORGANIZATION` for cross account destinations or `ACCOUNT` for account-level destinations.
`destination.type`	Enum	(Required) Must be `EVENT_BRIDGE` for AWS EventBridge destinations.
`destination.name`	String	(Required) A descriptive name for the AWS EventBridge destination.
`destination.auth`	Object	(Required) Authentication configuration for connecting to AWS EventBridge using IAM credentials.
`destination.auth.type`	Enum	(Required) Must be `BASIC` for AWS EventBridge integrations using IAM user credentials.
`destination.auth.basic`	Object	(Required) Contains the AWS IAM authentication credentials (access key ID and secret access key).
`destination.auth.basic.user`	String	(Required) Your AWS IAM access key ID. Ensure the IAM user has EventBridge permissions.
`destination.auth.basic.password`	String	(Required) Your AWS IAM secret access key. Store this securely and consider using IAM roles when possible.
`destination.properties`	Array of Objects	(Required) Configuration properties including the AWS account ID and region for EventBridge.
`destination.properties[].key: "AWSAccountId"`	String	(Required) Must include a property with key "AWSAccountId" and value set to your AWS account ID (12-digit number).
`destination.properties[].key: "AWSRegion"`	String	(Required) Must include a property with key "AWSRegion" and value set to your AWS region (e.g., "us-east-1", "eu-west-1").

Sample query:

mutation {
  aiNotificationsCreateDestination(
    scope: { id: YOUR_ACCOUNT_ID, type: ACCOUNT }
    destination: {
      type: EVENT_BRIDGE
      name: "Destination Name"
      auth: {
        type: BASIC
        basic: { user: YOUR_IAM_USER, password: YOUR_PASSWORD }
      }
      properties: [
        { key: "AWSAccountId", value: YOUR_AWS_ACCOUNT_ID }
        { key: "AWSRegion", value: YOUR_AWS_REGION }
      ]
    }
  ) {
    destination {
      id
      name
      scope {
        id
        type
      }
    }
  }
}

Test a cross account destination

You can test cross account destinations before or after creation. You must provide the scope object.

Use aiNotificationsTestDestination mutation to test a destination configuration before creating it. This allows you to validate the settings and credentials without actually creating the destination.

Input parameters

Parameter name	Data type	Description
`scope`	Object	(Required) Defines the scope for the test. Use `type: ORGANIZATION` for cross account destinations or `type: ACCOUNT` for account-level destinations.
`scope.id`	String	(Required) The organization ID for cross account destinations or account ID for account-level destinations.
`scope.type`	Enum	(Required) Must be `ORGANIZATION` for cross account destinations or `ACCOUNT` for account-level destinations.
`destination`	Object	(Required) The destination configuration object to test, including type, name, authentication, and properties.
`destination.type`	Enum	(Required) The destination type to test. Options: `EMAIL`, `WEBHOOK`, `PAGERDUTY_SERVICE_INTEGRATION`, `PAGERDUTY_ACCOUNT_INTEGRATION`, `SLACK`, `JIRA`, `SERVICE_NOW`, `EVENT_BRIDGE`.
`destination.name`	String	(Required) A name for the destination configuration being tested.
`destination.auth`	Object	(Optional) Authentication configuration for destinations that require credentials. Required for WEBHOOK, PAGERDUTY, JIRA, SERVICE_NOW, and EVENT_BRIDGE destinations.
`destination.properties`	Array of Objects	(Required) Key-value pairs that configure destination-specific settings such as URLs, email addresses, or integration options.

Sample query:

mutation {
  aiNotificationsTestDestination(
    scope: { id: YOUR_ACCOUNT_ID, type: ACCOUNT }
    destination: {
      type: EMAIL
      name: "Destination Name"
      properties: [{ key: "email", value: YOUR_EMAIL }]
    }
  ) {
    error {
      details
    }
    details
    result
  }
}

Use aiNotificationsTestDestinationById mutation to test an existing destination by its ID. This verifies that the destination is properly configured and can successfully deliver notifications.

Input parameters

Parameter name	Data type	Description
`scope`	Object	(Required) Defines the scope where the destination exists. Use `type: ORGANIZATION` for cross account destinations or `type: ACCOUNT` for account-level destinations.
`scope.id`	String	(Required) The organization ID for cross account destinations or account ID for account-level destinations.
`scope.type`	Enum	(Required) Must be `ORGANIZATION` for cross account destinations or `ACCOUNT` for account-level destinations.
`destinationId`	String	(Required) The unique identifier of the existing destination you want to test. This ID is returned when creating a destination or can be found by listing destinations.

Sample query:

mutation {
  aiNotificationsTestDestinationById(
    scope: { id: YOUR_ACCOUNT_ID, type: ACCOUNT }
    destinationId: YOUR_DESTINATION_ID
  ) {
    error {
      details
    }
    details
    result
  }
}

List and filter destinations

The destinations query allows you to paginate through all of your destinations at both account and organization levels. It also allows filtering functionality for cross account destinations.

Use the actor.organization.aiNotifications.destinations query to retrieve all destinations at the organization level, including cross account destinations that can be used across all accounts in the organization.

Input parameters

This query uses the GraphQL actor.organization context and does not require explicit input parameters. The query automatically returns all destinations accessible at the organization level.

Query field	Data type	Description
`actor`	Object	Root query object representing the authenticated user's context.
`organization`	Object	Organization context that provides access to organization-level resources and cross account destinations.
`aiNotifications`	Object	AI Notifications service context for accessing notification-related resources.
`destinations`	Object	Query field that returns all destinations accessible at the organization level, including cross account destinations.

Sample query:

{
  actor {
    organization {
      aiNotifications {
        destinations {
          entities {
            id
            name
            scope {
              id
              type
            }
          }
          error {
            details
          }
        }
      }
    }
  }
}

Use the actor.account.aiNotifications.destinations query to retrieve all destinations accessible to a specific account, including both account-scoped destinations and cross account destinations available to that account.

Input parameters

Parameter name	Data type	Description
`account.id`	String/ID	(Required) The specific account ID for which to retrieve destinations. This account must be accessible to the authenticated user.

Query fields

Query field	Data type	Description
`actor`	Object	Root query object representing the authenticated user's context.
`account`	Object	Account context that provides access to account-specific resources and cross account destinations available to this account.
`aiNotifications`	Object	AI Notifications service context for accessing notification-related resources.
`destinations`	Object	Query field that returns all destinations accessible to the specified account (both account-scoped and organization-scoped).

Sample query:

{
  actor {
    account(id: YOUR_ACCOUNT_ID) {
      aiNotifications {
        destinations {
          entities {
            id
            name
            scope {
              id
              type
            }
          }
          error {
            details
          }
        }
      }
    }
  }
}

Use cursor pagination to efficiently navigate through large sets of destinations. You must request the nextCursor field in your query to enable pagination.

Input parameters

Parameter name	Data type	Description
`account.id`	String/ID	(Required) The specific account ID for which to retrieve destinations. This account must be accessible to the authenticated user.
`destinations.cursor`	String	(Optional) Cursor for pagination. Use empty string `""` for the first request, then use the `nextCursor` value from previous responses to get subsequent pages.

Pagination workflow

With cursor pagination, you continue to make requests through the result set until the nextCursor that is returned from the response comes back empty. This signifies that you reached the end of your results.

Here's an example for an account (the same logic applies to organization):

{
  actor {
    account(id: YOUR_ACCOUNT_ID) {
      aiNotifications {
        destinations(cursor: "") {
          nextCursor
          entities {
            id
            name
            scope {
              id
              type
            }
          }
          totalCount
        }
      }
    }
  }
}

The code above returns a set of results like this:

{
  "data": {
    "actor": {
      "account": {
        "aiNotifications": {
          "destinations": {
            "nextCursor": "/8o0y2qiR54m6thkdgHgwg==:jZTXDFKbTkhKwvMx+CtsPVM=",
            "entities": [
              {
                "id": "01c0cbe7-3d70-47c1-99e0-adf906eed6c2",
                "name": "Destination Name",
                "scope": {
                  "type": "ACCOUNT",
                  "id": "312312"
                }
              },
              {
                "id": "05db0207-c137-4985-8cb5-f21e7e57b8cc",
                "name": "Another Destination Name",
                "scope": {
                  "type": "ACCOUNT",
                  "id": "312312"
                }
              }
            ],
            "totalCount": 807
          }
        }
      }
    }
  }
}

So, in your subsequent request, provide the cursor like so, until the cursor is empty:

{
  actor {
    account(id: YOUR_ACCOUNT_ID) {
      aiNotifications {
        destinations(
          cursor: "/8o0y2qiR54m6thkdgHgwg==:jZTXDFKbTkhKwvMx+CtsPVM="
        ) {
          nextCursor
          entities {
            id
            name
            scope {
              id
              type
            }
          }
          totalCount
        }
      }
    }
  }
}

Here's another example for an organization

{
  actor {
    organization {
      aiNotifications {
        destinations(cursor: "") {
          nextCursor
          entities {
            id
            name
            scope {
              id
              type
            }
          }
          totalCount
        }
      }
    }
  }
}

The code above returns a set of results like this:

{
  "data": {
    "actor": {
      "organization": {
        "aiNotifications": {
          "destinations": {
            "nextCursor": "/8o0y2qiR54m6thkdgHgwg==:jZTXDFKbTkhKwvMx+CtsPVM=",
            "entities": [
              {
                "id": "01c0cbe7-3d70-47c1-99e0-adf906eed6c2",
                "name": "Destination Name",
                "scope": {
                  "type": "ORGANIZATION",
                  "id": "01ddcbe7-3d70-47c1-99e0-adf906eed6c2"
                }
              },
              {
                "id": "05db0207-c137-4985-8cb5-f21e7e57b8cc",
                "name": "Another Destination Name",
                "scope": {
                  "type": "ORGANIZATION",
                  "id": "01ddcbe7-3d70-47c1-99e0-adf906eed6c2"
                }
              }
            ],
            "totalCount": 807
          }
        }
      }
    }
  }
}

So, in your subsequent request, provide the cursor like so, until the cursor is empty:

{
  actor {
    organization {
      aiNotifications {
        destinations(
          cursor: "/8o0y2qiR54m6thkdgHgwg==:jZTXDFKbTkhKwvMx+CtsPVM="
        ) {
          nextCursor
          entities {
            id
            name
            scope {
              id
              type
            }
          }
          totalCount
        }
      }
    }
  }
}

Use name filtering to search for destinations by their names. The name filter supports both exact matches and partial matches, and is case insensitive.

Input parameters

Parameter name	Data type	Description
`account.id`	String/ID	(Required) The specific account ID for which to retrieve destinations. This account must be accessible to the authenticated user.
`destinations.filters`	Object	(Required) Filter criteria object to narrow down results.
`destinations.filters.name`	String	(Required) Filter by destination name. Supports partial matches and is case insensitive. Returns destinations whose names contain the specified string.

Sample query:

This example finds destinations with "DevOps" in the name:

{
  actor {
    account(id: YOUR_ACCOUNT_ID) {
      aiNotifications {
        destinations(filters: { name: "DevOps" }) {
          entities {
            id
            name
            scope {
              id
              type
            }
          }
        }
      }
    }
  }
}

Use ID filtering to retrieve a specific destination by its unique identifier. This filter returns exact matches only.

Input parameters

Parameter name	Data type	Description
`account.id`	String/ID	(Required) The specific account ID for which to retrieve destinations. This account must be accessible to the authenticated user.
`destinations.filters`	Object	(Required) Filter criteria object to specify the exact destination to retrieve.
`destinations.filters.id`	String	(Required) Filter by destination ID. Returns the destination with the exact matching ID, if it exists and is accessible to the specified account.

Sample query:

{
  actor {
    account(id: YOUR_ACCOUNT_ID) {
      aiNotifications {
        destinations(filters: { id: YOUR_DESTINATION_ID }) {
          entities {
            id
            name
            scope {
              id
              type
            }
          }
        }
      }
    }
  }
}

Use type filtering to retrieve destinations of a specific type. This filter returns all destinations that match the specified destination type.

Input parameters

Parameter name	Data type	Description
`account.id`	String/ID	(Required) The specific account ID for which to retrieve destinations. This account must be accessible to the authenticated user.
`destinations.filters`	Object	(Required) Filter criteria object to narrow down results by destination type.
`destinations.filters.type`	Enum	(Required) Filter by destination type. Valid values: `EMAIL`, `WEBHOOK`, `PAGERDUTY_SERVICE_INTEGRATION`, `PAGERDUTY_ACCOUNT_INTEGRATION`, `SLACK`, `JIRA`, `SERVICE_NOW`, `EVENT_BRIDGE`.

Sample query:

The following query will return all email destinations on the chosen account:

{
  actor {
    account(id: YOUR_ACCOUNT_ID) {
      aiNotifications {
        destinations(filters: { type: EMAIL }) {
          entities {
            id
            name
            scope {
              id
              type
            }
          }
        }
      }
    }
  }
}

Update a cross account destination

To update an existing cross-account destination, you must provide the organization scope and the destination ID.

Use aiNotificationsUpdateDestination mutation to update an existing cross-account destination.

Input parameters

Parameter name	Data type	Description
`scope`	Object	(Required) Defines the scope where the destination exists. Use `type: ORGANIZATION` for cross account destinations or `type: ACCOUNT` for account-level destinations.
`scope.id`	String	(Required) The organization ID for cross account destinations or account ID for account-level destinations.
`scope.type`	Enum	(Required) Must be `ORGANIZATION` for cross account destinations or `ACCOUNT` for account-level destinations.
`destinationId`	String	(Required) The unique identifier of the destination you want to update. This ID is returned when creating a destination or can be found by listing destinations.
`destination`	Object	(Required) The destination update object containing the fields you want to modify. Only include the fields you want to change.
`destination.name`	String	(Optional) Updated name for the destination.
`destination.auth`	Object	(Optional) Updated authentication configuration for destinations that require credentials.
`destination.properties`	Array of Objects	(Optional) Updated key-value pairs for destination-specific settings such as URLs, email addresses, or integration options.

Sample query:

mutation {
  aiNotificationsUpdateDestination(
    scope: { id: YOUR_ACCOUNT_ID, type: ACCOUNT }
    destinationId: YOUR_DESTINATION_ID
    destination: { name: "Updated destination Name" }
  ) {
    destination {
      id
      name
      scope {
        id
        type
      }
    }
  }
}

Delete a cross account destination

Delete cross account destinations by providing the scope and destination ID.

Importante

Before deleting: If you receive an error stating "Entity type channel is in use", you must first delete all channels associated with the destination. Find associated channels and delete them individually before proceeding with destination deletion.

Use aiNotificationsDeleteDestination mutation to permanently delete a cross account destination.

Input parameters

Parameter name	Data type	Description
`scope`	Object	(Required) Defines the scope where the destination exists. Use `type: ORGANIZATION` for cross account destinations or `type: ACCOUNT` for account-level destinations.
`scope.id`	String	(Required) The organization ID for cross account destinations or account ID for account-level destinations.
`scope.type`	Enum	(Required) Must be `ORGANIZATION` for cross account destinations or `ACCOUNT` for account-level destinations.
`destinationId`	String	(Required) The unique identifier of the destination you want to delete. This ID is returned when creating a destination or can be found by listing destinations.

Sample query:

mutation {
  aiNotificationsDeleteDestination(
    scope: { id: YOUR_ACCOUNT_ID, type: ACCOUNT }
    destinationId: YOUR_DESTINATION_ID
  ) {
    ids
    error {
      details
    }
  }
}

Use this query to find all channels that are currently using a specific destination. This is useful before deleting a destination to ensure no active channels will be affected.

Input parameters

Parameter name	Data type	Description
`account.id`	String/ID	(Required) The specific account ID to search for channels. This account must be accessible to the authenticated user.
`channels.filters`	Object	(Required) Filter criteria object to find channels using a specific destination.
`channels.filters.destinationId`	String	(Required) The unique identifier of the destination to search for. Returns all channels that are configured to use this destination.

Sample query:

{
  actor {
    account(id: YOUR_ACCOUNT_ID) {
      aiNotifications {
        channels(filters: { destinationId: YOUR_DESTINATION_ID }) {
          entities {
            id
            name
          }
        }
      }
    }
  }
}

Use aiNotificationsDeleteChannel mutation to delete channels that are using a destination. You must delete all associated channels before you can delete the destination itself.

Input parameters

Parameter name	Data type	Description
`accountId`	String/ID	(Required) The account ID where the channel exists. This account must be accessible to the authenticated user.
`channelId`	String	(Required) The unique identifier of the channel you want to delete. This ID can be found by querying channels using the destination ID.

Sample query:

mutation {
  aiNotificationsDeleteChannel(
    accountId: YOUR_ACCOUNT_ID
    channelId: "YOUR_CHANNEL_ID"
  ) {
    ids
    error {
      details
    }
  }
}

Next steps

Cross account destinations overview

Learn about cross account destinations concepts and key features.

preview

Create a destination .css-21sua1{background:none;border:none;width:0;padding:0;}

Importante

Create email destination

Create webhook destination

Create PagerDuty service level destination

Create PagerDuty account level destination

Create Slack destination

Create ServiceNow destination

Create AWS EventBridge destination

Test a cross account destination

Test destination configuration

Test existing destination by ID

List and filter destinations

List all cross account destinations for an organization

List destinations for a specific account

Paginating through destinations with cursor pagination

Filter destinations by name

Filter destinations by ID

Filter destinations by type

Update a cross account destination

Update a cross account destination

Delete a cross account destination

Importante

Delete a cross account destination

Find channels using a destination

Delete associated channels

Next steps

Cross account destinations overview

Create a destination