Admin user's API key and partnerships

This approach adds a new authentication method to the customer-facing New Relic REST API (v2) that allows partners (and enterprise-scale customers that use the partnership structure to manage their multiple accounts) to use their partnership credentials to authorize all REST API (v2) calls. It offers no new functionality for non-partner API users.

When calling endpoints in the New Relic REST API (v2) that require Admin user's API keys, New Relic suggests you use the described authentication method.

Custom headers and API calls

When making API calls, use the following custom headers with your partner API key, partner ID, and your customer's account ID:

  • X-Api-Key:YOUR_PARTNER_ACCOUNT_API_KEY
  • NewRelic-Partner-Id:YOUR_PARTNER_ID
  • NewRelic-Account-Id:YOUR_CUSTOMERS_ACCOUNT_ID

Providing authentication to the REST API (v2) in this form allows you to complete any API operation on your customer’s accounts. This bypasses the customer-facing requirement that some API calls require an Admin user’s API key.

This authentication method also works for API endpoints that require only the REST API key. This new authentication method works for all endpoints, not only those that require the Admin User’s API key.

Known limitations

This partner-only authentication method will only work with the New Relic REST API (v2). It does not work with the following:

For more help

Recommendations for learning more: