New Relic

Automatically manage New Relic user access and permission groups as your team evolves.

Setup

1. Create or sign into your New Relic account

New Relic uses API keys to authenticate and verify your identity. These keys allow approved people to:

  • Report data to New Relic
  • Access and query your data
  • Configure features and settings

Sign in to New Relic
or
Create a new New Relic account

2. Generate User API Key

You'll need a User API key to access NerdGraph, New Relic's GraphQL API. This key is essential for:

  • Querying data from your New Relic account
  • Configuring features and settings
  • Managing user access and permissions

Go to API Keys UI to generate your key

Required API Key Permissions:

  • User management
  • Authentication domain management
  • Group management

Security Recommendations:

  • Keep your API keys secure and treat them like passwords
  • Implement key rotation strategy for license and browser keys
  • Remove user IDs when team members leave the organization
  • Create additional ingest keys instead of using original ones for better security

3. Connect New Relic Account

Enter your User API key below to complete the integration. This key will be used to:

  • Authenticate your account
  • Enable data access and management
  • Configure integration settings

Configuration

FieldTypeDescription
apiKeystring (required)Secret New Relic API key provided by the user. Encrypted and stored as encryptedToken.
accountIdstringAccount ID pulled during integration config setup for reference.
accountNamestringAccount name pulled during integration config setup for reference.
secretsobjectBuilt during integration setup containing:
  encryptedTokenstringEncrypted apiKey used to authenticate future requests.

Connections

Permission Group

Permission groups can connect to existing New Relic Groups or create new ones if no connection input is provided.

When creating a new Group in New Relic, the name will be the Hyphen Team name.

Configuration

FieldTypeDescription
groupIdstringUnique group ID in the New Relic group.
groupNamestringGroup name in the New Relic group.

Connection Input

Provide the New Relic group ID to connect to an existing Group.

Access

A Member connection will be added as a member when added to the group.


User

User connections link to existing Users in New Relic. If no input is provided, the member email will be used to try and find the existing User.

Configuration

FieldTypeDescription
userIdstringUnique user ID in New Relic.
emailstringUnique user email in New Relic.

Connection Input

Provide the New Relic member email to connect to an existing User.