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
| Field | Type | Description |
|---|---|---|
apiKey |
string (required) |
Secret New Relic API key provided by the user. Encrypted and stored as encryptedToken. |
accountId |
string |
Account ID pulled during integration config setup for reference. |
accountName |
string |
Account name pulled during integration config setup for reference. |
secrets |
object |
Built during integration setup containing: |
  encryptedToken |
string |
Encrypted apiKey used to authenticate future requests. |
Connections
Table of Contents
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
| Field | Type | Description |
|---|---|---|
groupId |
string |
Unique group ID in the New Relic group. |
groupName |
string |
Group 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
| Field | Type | Description |
|---|---|---|
userId |
string |
Unique user ID in New Relic. |
email |
string |
Unique user email in New Relic. |
Connection Input
Provide the New Relic member email to connect to an existing User.