• /
  • EnglishEspañolFrançais日本語한국어Português
  • 로그인지금 시작하기

NerdGraph tutorial: Create custom role for Teams

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.

New Relic Teams lets you connect the entities you're monitoring to the teams who own them. When you can easily see who owns an entity, you can speed up troubleshooting, enhance team collaboration, and improve your operational efficiency.

Default Teams access

New Relic provides default access to Teams through these standard roles:

  • Read Access: All users have read access to Teams, including metadata such as contact information, team members, and other relevant details.
  • Modify Teams: Users with the Organization Product Admin role can modify Teams. This is a new role assigned to all users who currently have the All Product Admin role.
  • Create & Delete Teams: Users with Organization Manager or Authentication Manager roles can create and delete Teams.

You might need a custom role if the default permissions don't meet your organization's needs. This tutorial shows you how to use NerdGraph GraphQL mutations to create a custom role for managing Teams.

Process overview

To create a Teams administrator custom role, you'll need to:

  1. Retrieve all the organization-scoped capabilities
  2. Retrieve your organization ID
  3. Identify the required permission IDs for Teams
  4. Create the custom role for Teams administrator
  5. Add the custom role to a user group

Prerequisites

Before you begin, ensure you have:

Mutations

New Relic provides various NerdGraph mutations to create custom role for Team managers.

What's next

After successfully creating and assigning your custom Teams role, users in the assigned group will have the permissions you configured. You can:

  • Monitor the role's usage through your organization's user management
  • Modify the role permissions if needed using similar NerdGraph mutations
  • Create additional custom roles for different levels of Teams access

For more information about Teams, see our Teams documentation.

Copyright © 2025 New Relic Inc.

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.