• /
  • Log in
  • Free account

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, master accounts, and sub-accounts. A partnership can have multiple master accounts and sub-accounts.

To understand how sub-accounts and master accounts scale with EU region accounts, see EU region account hierarchy.


If you do not have a partnership organization, you can only have one master account. For more information, see Manage apps or users with sub-accounts.


All master accounts and sub-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.

Sub-accounts with partnerships

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



Account creation

  • Sub-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.
  • Sub-accounts do not have a New Relic subscription of their own. They inherit the master account's subscription.


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


  • Admin-level users on a master account have the ability to create, modify, and delete sub-accounts for the master account.
  • Users that have been granted access permissions on a master account automatically inherit the same level of access for all sub-accounts. This is also true for add-on roles.
  • Exception: Sub-account users will not receive alert emails or weekly report emails unless they are explicitly granted permission on these sub-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.

For more help

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

Create issueEdit page
Copyright © 2021 New Relic Inc.