The Partnership API doesn't allow you to upgrade or downgrade individual product subscriptions for an account. Instead, the API requires you to replace (add) the configuration for all product subscriptions for the account.
If any product configurations are not included, the New Relic Partnership API provisions the account with the best free product type available. The API automatically selects the product level based on the configuration and custom pricing for the account's partnership.
The product ID attribute identifies the New Relic product being defined for this subscription. It is required for Create calls.
The quantity attribute is required for Create calls, even if a product level is unlimited. The API will ignore the quantity value entered for unlimited product subscriptions, such as New Relic APM Lite.
New Relic Insights, Browser, and Synthetics require you to identify a predefined usage level (product bucket). This allows the API to apply a pricing discount based on the specific quantity you select.
The quantity you identify must be an exact match for the product and subscription level. For a list of available product buckets, see:
Also, creating subscriptions for Serverless, Logs, and Traces is not supported by the Partnership API. If your account has these subscriptions, any attempt to make changes will return an error. Please contact your account executive to modify subscriptions.
New Startup and Small Business service plans no longer are available through the New Relic Partnership API.
The number of allowable hosts per account and the data retention period vary by subscription level within New Relic APM's pricing structure. For example, New Relic APM allows an unlimited number of allowable hosts for Lite accounts but only a 24-hour data retention period.
In addition, pricing and data retention depend on whether you select pricing models based on hosts or compute units (CU). Use the product ID's integer format to identify the subscription level and type of plan.
APM subscription level
Pro Annual (Host)
APM Essentials (Host)
APM Essentials Annual (Host)
If you select pricing plans based on compute units (CU), use these product ID integer formats to identify the subscription level and type of plan.
APM Compute Units (CU) subscription level
Pro Annual CU
APM Essentials CU
APM Essentials Annual CU
New Relic Mobile's pricing structure allows 100,000 monthly active users per account at the Enterprise subscription level. Data retention varies by subscription level. Use the product ID's integer format to identify the subscription level.
Mobile subscription level
New Relic Insights bases the pricing structure on the number of allowable events stored and the associated data retention policy (for example, data retention for Insights Free is one day). Note that the data_retention attribute is required.
Insights subscription level
New Relic Browser's pricing structure allows an unlimited number of app users, regardless of subscription level. However, the number of allowable page views per month and the data retention period vary by subscription level. For example:
Lite accounts include an unlimited number of page views per month and 24-hour data retention.
Pro account pricing starts at 500,000 page views per month and three months data retention.
Use the product ID's integer format to identify the subscription level.
Browser subscription level
With synthetic monitoring's pricing structure, the default number of allowable monitoring checks and the data retention period vary by subscription level. Use the product ID's integer format to identify the subscription level.
Synthetics subscription level
If you previously used the deprecated Partnership availability monitoring API, you can use the synthetic monitoring API to provision a check and the REST API for alerts to create an alert notification for your customers.
With New Relic's Infrastructure pricing structure, the default number of instances and the data retention period vary by subscription level. Infrastructure events do not count against your New Relic Insights quota, even though you can query them in Insights.
New Relic Infrastructure offers pricing plans based on Compute Units (CU) only. Use the product ID's integer format to identify the subscription level.
The customer has signed up for a New Relic product, but payment still needs to be processed.
A credit card has been authorized and the vault key stored, but payment has not been captured.
This subscription is for a free New Relic product. No further processing is required.
A payment has been captured and the next payment date has been set.
The last attempt to authorize payment failed.
The New Relic account has no active subscription and is not active. No payments should be authorized or captured.
This subscription has been superseded by another New Relic subscription.
API examples (v2)
Here are API example requests and responses to list, show, create, and update original pricing model subscriptions. Line breaks in responses are for readability. The actual responses appear as a continuous line.