• EnglishEspañol日本語한국어Português
  • Log inStart now

Partnership accounts, users, and subscriptions

New Relic organizations set up as partnership accounts have access to an enhanced hierarchical way of organizing their account structure.

Partnerships with New Relic

There are two types of New Relic organizations that are able to use our partnership account structure and the Partnership API:

  • An actual partnership: A partnership refers to managed service providers or resellers, who offer New Relic products to their customers. Heroku is one example of such a New Relic partner.
  • A customer partnership: some of our larger organizations also make use of our partnership account structure. We call these customers "customer partnerships."

Use of our partnership account structure requires prior approval and set up by New Relic representatives. For customer partnerships, New Relic contacts organizations that would benefit from such a structure.

Partnerships are identified by a numeric PARTNER_ID. In some cases, a New Relic customer may have more than one partnership; for example, when one section of New Relic users must be managed differently from another.

  • Partnerships are administered by a partnership owner account. The account that owns a partnership functions differently from a regular account.
  • If multiple partnerships have been set up, each has a unique PARTNER_ID.

Account hierarchy

New Relic partnership organizations consist of the partnership owning account, partnerships, parent accounts, and child accounts. A partnership can have multiple parent and child accounts.

To understand how child accounts and parent accounts scale with EU region accounts, see EU region account hierarchy.


If you don't have a partnership organization, you can only have one parent account. For more information, see Manage apps or users with child accounts.

All parent and child accounts roll up to your partnership account.

Partnership owner accounts (POA)

The partnership owner account (POA) is the entity that is used to administer a partnership. It controls which users manage accounts under partnerships, have access to the partner API, and manage other aspects of the partnership.

Do not monitor your own applications from the partnership owner account. Instead, create an account within the partnership and monitor apps from that account.

  • Users on the partnership owner account can access accounts under their partnerships and enjoy User level privileges.
  • Admins on the POA can access accounts under their partnerships and enjoy Admin level privileges, including permission to manage users.
  • The Owner of the partnership owner account will still only have Admin level access on accounts under the partnership. That means that the owner cannot enable SAML SSO, change the account owner, cancel the account via the UI, etc.

The partnership owner account enjoys special privileges, and it lets you exercise the capabilities defined in your partnership agreement with New Relic. For example, you may use your partnership owner account with the New Relic Partnership API to set up and manage users on your accounts or to view your customers' performance data in the New Relic UI.


Many of the Partnership API calls return an account status as part of the XML.

Child accounts with partnerships

Child accounts behave differently than other New Relic accounts provisioned through your partnership:

Child accounts


Account creation

  • Child accounts can be created through the Partnership API or New Relic user interface.
  • In order to group accounts through the New Relic user interface, your partnership must have Admin privileges, and the account must have the appropriate subscription level. If you have any questions about partnership privileges or subscription levels, contact your New Relic account representative.
  • Child accounts do not have a New Relic subscription of their own. They inherit the parent account's subscription.


  • Billing is applied at the parent account level.
  • Exception: Reseller partnerships receive consolidated billing for all accounts under the partnership.


  • Admin-level users on a parent account have the ability to create, modify, and delete children accounts for the parent account.
  • Users that have been granted access permissions on a parent account automatically inherit the same level of access for all children accounts. This is also true for add-on roles.
  • Exception: Child account users won't receive alert emails or weekly report emails unless they are explicitly granted permission on these child accounts.

Account users

You can use the Partnership user API to add and maintain your customer users. An account must always have at least one person (the Owner) associated with it.

For security purposes, you cannot change an account Owner with the Partnership user API. Instead, you must change the account Owner from the Users page in the New Relic UI.

In addition, a specific user may be associated with multiple accounts. For example, many New Relic users have accounts through a partnership, and they also have accounts they created directly with New Relic.

Partnership pricing

Accounts within a partnership organization may have different levels of access to New Relic products.


Many of the Partnership API calls return a subscription status as part of the XML.

For accounts set up through a partnership:

  • An account can have multiple New Relic products associated with it. However, only one subscription per product may be active at any time. For example, a user may have both an Essentials subscription and a higher service level Pro Trial subscription. When the Pro Trial subscription expires, the service level returns to the Essentials subscription.
  • Promotions may appear as a subscription change.
  • Several factors affect starting and stopping subscriptions, including how New Relic handles pricing and billing.
Copyright © 2024 New Relic Inc.

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