• English日本語한국어
  • Log inStart now

New Relic API keys

Our monitoring solutions and APIs use API keys to authenticate and verify your identity. These keys allow only approved people in your organization to report data to New Relic, access that data, and configure features. The primary keys are the license key (for reporting data) and the (for working with NerdGraph, our GraphQL API).

To get started with API keys:

  1. Sign up for your free account if you haven't already
  2. Use our agents and integrations to begin ingesting data into New Relic
  3. Create and manage your API keys from the API keys UI page so you can start observing your data right away

Our main API keys

Key

Details

To view and manage

Read more

License key, used for data ingest

License keys are used to report almost all data (except for browser and data, which use their own keys). Each key is tied to a specific account and you can create as many as you want.

Go to the API keys UI (direct link)

Learn more

Browser key, used for data ingest

Browser keys are used to report data. Each key is tied to a specific account, and you can create as many as you want.

Go to the API keys UI (direct link)

Learn more

Mobile app token, used for data ingest

Mobile app tokens are used to report mobile monitoring data. Each token is tied to a specific mobile app.

Go to a monitored app's UI

Learn more

User key, used for querying and configuration

A user key is required to use NerdGraph, our GraphQL API, which is used for querying data and configuring features. Each user key is tied to a specific user.

Go to the API keys UI (direct link)

Learn more

View and manage API keys

You can view and manage most API keys from the API keys UI page. To find that: from the user menu, click API keys. You can also:

The account ID is another identifying number often required for reporting data to New Relic.

Copying keys from the UI

You can copy existing API keys and their IDs from one.newrelic.com/api-keys:

  • Copy key: Copies the value of the key itself.
  • Copy key ID: Copies the ID of the key, which is sometimes needed for referencing the key object via API.
  • Copy truncated key: This option is available for keys that are not yours. It copies only a few digits from the key, which can be useful for your internal tracking of keys, or for talking with support.

Recommendations for managing API keys

If your API keys get into the wrong hands, it can present a security risk. For example:

  • Someone with your could send arbitrary data to your account.
  • Someone with one of your team member's user keys could view your New Relic data and make changes to your New Relic account.

You should treat your API keys securely, as you would passwords and other sensitive information. Some recommendations:

  • For the license key and the browser key, consider implementing a key rotation strategy: creating new keys and deleting old ones on a set schedule. Considerations:
    • You can't delete the original keys associated with an account, so to implement a strong security strategy, you must create additional keys that you can later delete.
    • Note that this doesn't apply to the mobile app token; you can't delete a token or create additional tokens.
  • For the :
    • Instruct your team members to keep their user keys secure.
    • When members leave your organization, remove them from New Relic.

Rotate API keys

Here's how to rotate each of our four most common API keys:

We also have several older or less common API key type. To rotate these keys:

Read more about our API keys

To create or manage API keys, use the UI at one.newrelic.com/launcher/api-keys-ui.api-keys-launcher, or our NerdGraph API. For more details, select a key:

Besides the main API keys explained above, we have several other, older API keys that some New Relic customers still use. If you don't already use these keys, you likely don't need to start.

Copyright © 2024 New Relic Inc.

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