• /
  • Log in

New Relic API keys

New Relic has several different APIs that each require their own type of API key to use. This resource describes our API keys, what they're used for, and how to access them.

Manage API keys in UI

Here's a direct link to the API keys UI page. To find this from the New Relic UI: From the account dropdown, select API keys.

Overview of API keys

The table below summarizes our available API keys and their uses.

Important

Some keys are able to be used by more than one API. If you're using a specific API, see the docs for that API to understand which keys are required and recommended.

Key type

What it's for

Where to access

User key

(Also known as a "personal API key")

Used for NerdGraph (our GraphQL API) and for accessing REST API endpoints (dependent on user permissions).

API keys UI

License key

Allows ingestion of data from APM agents, the infrastructure agent, and some other data-ingest APIs.

API keys UI

Insights insert key

(Also known as a "Insert key")

Allows ingestion of events via HTTPS request from our metric, log, trace, and event APIs and the tools that use those APIs.

Go to the API keys UI and click Insights insert key.

Browser key

Allows ingestion of browser monitoring data.

API keys UI

Mobile key

(aka "mobile app token")

Allows mobile monitoring data to be sent to New Relic.

See Mobile app token.

REST API key

Note: we recommend using the user key instead because it has fewer limitations. The REST API key is for using our REST APIs for Alerts, APM, browser, infrastructure alerts, as well as mobile monitoring REST APIs and the API Explorer.

Go to the API keys UI and click REST API key.

Admin API key

Important

As of December 4, 2020, all existing admin keys have been migrated to be user keys.

For more information, see Admin key and User key below.

API keys UI (will appear as user keys)

Insights query key

(aka "Query key")

This key allows use of the Insights query API. Note: we now recommend using NerdGraph to query New Relic data.

Go to the API keys UI and click Insights query key.

User key

New Relic user keys (previously referred to as "personal API keys") are required for NerdGraph (our GraphQL API), which allows you to query most New Relic data and do some types of configuration. User keys also let you use our REST API, with restrictions based on your permissions.

The instructions below are for managing keys in the UI. For managing keys via API, see Manage keys with NerdGraph.

Tip

In December 2020, user keys supplanted Admin API keys. For details, see Admin API key.

License key

New Relic license keys allow the ingestion of data from APM agents, the infrastructure agent, and some other data-ingest APIs. If you're using a specific API, see the docs for that API to understand which keys are required or recommended.

The instructions below are for managing keys in the UI. For managing keys via API, see Manage keys with NerdGraph.

Browser key

The browser key allows the ingestion of data from New Relic browser monitoring.

The instructions below are for managing keys in the UI. For managing keys via API, see Manage keys with NerdGraph.

REST API key

Important

We highly recommend using a user key instead, because that key has fewer restrictions.

You can use a REST API key with our REST API and the API Explorer. For accounts that have child accounts, each child account must use its own REST API key.

Requirements:

  • Requires admin-level user permissions. If you don't have access to the REST API key or the REST API explorer, it might be due to lack of permissions. Talk to your New Relic account manager, or use a user key instead.
  • Each New Relic account can have only one REST API key.

Insights insert key

The Insights insert key (aka the "Insert key") is required for the ingestion of data via our Event API, Log API, Metric API, and Trace API, or via tools that use those APIs.

Tips on availability and access:

  • Because these keys are associated with an account and not a specific user, anyone in the account with access to a key can use it.
  • As a best practice for security purposes, we recommend you use different Insights insert keys for different applications or different data sources.

Insights query key

The Insights query key is used for our Insights query API: we now recommend using NerdGraph for querying New Relic data.

Admin key

Important

As of December 4, 2020, all existing admin keys have been migrated to be user keys.

You don’t need to do anything for existing admin keys to remain active. They will be automatically accessible via the API keys UI, labeled as user keys, and granted identical permissions. You can manage them as you would any user key via the same workflow.

All migrated admin keys will have a note that says “Migrated from an admin user key” in the key table, so you’ll be able to find them easily.

For more help

If you need more help, check out these support and learning resources:

Create issueEdit page
Copyright © 2021 New Relic Inc.