Step 1: Create accounts and organizations

Multi-tenancy allows you to set up any number of managed organizations in New Relic that are related to a primary, managing organization. The first step in setting up multi-tenancy is to create accounts and organizations. To do this, you'll use various NerdGraph mutations, depending on the organization structure you're creating:

• High touch: Managed service providers typically use this approach to onboard customers who want to access New Relic directly.

• Low touch: Enterprise businesses use this approach to create new organizations and accounts for business units or subsidiaries in New Relic.

Not sure which approach to take? See Overview of multi-tenancy approaches.

Requirements

As a reminder, to use the multi-tenancy feature, make sure you've completed the following for your organization:

1. Get approval: Contact your account representative to confirm your organization has been added to multi-tenancy. Once approved, you receive the multi-tenant entitlement.
2. Make sure you have correct user types: Users within the managing org that will leverage the above feature set need to be provisioned as either a core or full platform users.
3. Add users to appropriate group: Users with the core or full platform user type need to be added to a group with tenant_settings applied.

What can you call in NerdGraph?

Find the mutations below that apply to the approach you want to take: low touch or high touch.

High touch structure

If you're an administrator in a managed service provider or an enterprise who wants a lot of control over subsidiaries, complete the following:

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

mutation {
  organizationCreate(
    customerId: "CC-1234567890"
    organization: { name: "New Customer Organization Name" }
    sharedAccount: { accountId: 1234, limitingRoleId: 0 }
  ) {
    jobId
  }
}

Low-touch structure

If you're an administrator in an enterprise organization who doesn't need much control over subsidiaries, you can create a managed organization and managed account in a single call:

mutation {
  organizationCreate(
    customerId: "CC-123456789"
    newManagedAccount: { name: "New Managed Account Name", regionCode: EU01 }
    organization: { name: "New Organizanization Name" }
  ) {
    jobId
  }
}

Query your organizations

Use the following query to keep track of your managed organizations:

{
  customerAdministration {
    organizations {
      items {
        id
        name
      }
      nextCursor
    }
  }
}