NerdGraph tutorial: view, create, and rename accounts

As an alternative to using the New Relic UI, you can use NerdGraph to view your organization's accounts, create accounts, and rename accounts.

Requirements

For requirements to manage organization-level settings via NerdGraph, see Add accounts.

Before you start

Before you use NerdGraph to manage your accounts, it will probably help you to understand:

What accounts are and what they're used for
That you can also manage and add accounts via the UI.
The basics of using NerdGraph
That you can track changes to your New Relic account

This tutorial will show you how to:

View accounts
Rename accounts
Add accounts

Tips on terms and fields

Some tips about some of the fields used in these requests:

The managedAccount and managedAccounts fields are simply terms for the accounts in an organization. They're synonymous with "accounts."
The regionCode field refers to the data center used by an account. Valid values are us01 and eu01 which map to the US and EU regions respectively.

Note that the NerdGraph explorer has built-in docs that defines fields.

View accounts

Here's an example of returning the accounts in your organization:

{
  actor {
    organization {
      accountManagement {
        managedAccounts {
          name
          id
          regionCode
        }
      }
    }
  }
}

Create accounts

Here's an example of how to create an account. Before creating an account, make sure you understand what an account is used for.

mutation {
  accountManagementCreateAccount(managedAccount: { name: "NEW_ACCOUNT_NAME" }) {
    managedAccount {
      id
      name
      regionCode
    }
  }
}

If you have a complex account structure you may use the optional regionCode parameter to target a specific data center.

mutation {
  accountManagementCreateAccount(
    managedAccount: { name: "NEW_ACCOUNT_NAME", regionCode: "eu01" }
  ) {
    managedAccount {
      id
      name
      regionCode
    }
  }
}

Rename an account

Here's an example of how to rename an account.

mutation {
  accountManagementUpdateAccount(
    managedAccount: { name: "UPDATED_ACCOUNT_NAME", id: 101010101 }
  ) {
    managedAccount {
      id
      name
      regionCode
    }
  }
}

Errors

Here are some errors and what they mean:

Error message	Likely cause
`extensions: { nerdGraphExtensions: { errorClass: "ACCESS_DENIED" } } }`	This points to a problem with your organization structure (for example, an account that is outside the boundaries of an organization). If you get this message, contact support or your account representative.
`cannot create subaccount -- multiple parent account ids found. Please use Partnership API.", { extensions: { nerdGraphExtensions: { errorClass: "SERVER_ERROR" } } }`	This is a message returned when your organization has more than one "parent account," which is an indicator that your organization has a complex account structure that was set up with the Partnership API and requires the use of that API. Have questions? Contact support or your account representative.
Other errors	Contact support or your account representative.

Delete an account

You currently cannot delete accounts using NerdGraph. Instead, try these related options: