Partnership billing integration API

New Relic's Partnership API includes functions to replace a customer's existing subscription with a new one, or to update invoice information for New Relic partner accounts. This is particularly useful for partners acting as resellers for New Relic accounts.

For example, when customers of a New Relic reseller partner purchase a higher subscription level from New Relic's Sales team, New Relic replaces the old subscription with a new subscription. New Relic then uses the API to communicate this information to the partner.

This information is for version 2 of the Partnership API. Use v2 for all new integrations. Earlier versions have been deprecated. If you have problems with an older integration, upgrade to version 2.

Communication endpoint

Partners must implement a billing communication endpoint that identifies the partner's URL and PARTNER_ID. New Relic uses this endpoint to notify the partner that New Relic has made a change to a partner account's subscription or invoice information. The endpoint must support HTTPS.

  • The partner-specified portion of the URL is identified from the Settings tab of New Relic's Partner Portal.
  • The PARTNER_ID is the partner's external ID for this account. This value must be passed when the account is created by using the partner_external_identifier parameter.

Billing API

Supported functionality for the Partnership billing API includes:

  • Customer subscription notification
  • Invoice information notification
Customer subscription notification API

To communicate changes to a partner about a customer's subscription, New Relic uses the POST method with this URI:

https://partner-specified/partner-specified/PARTNER_ID.json

Authentication is done via headers with the partner's REST API key or Admin user's API key. The Partnership API returns the results as JSON.

Parameters:

Name Type Description
id String The customer's New Relic account ID
subscription_id Integer Subscription's numeric ID
subscription_string String Description of subscription for display
price Integer Monthly price of subscription in cents
number_of_hosts Integer Number of hosts
starts Date Subscription's start date (yyyymmdd)
expires Date Subscription's end date (yyyymmdd)

Return codes:

  • 200: Successfully updated.
  • 404: Account not found.
  • 422: Missing or invalid parameters.
  • Authentication failed.
Invoice notification API

New Relic uses this endpoint to notify the partner of changes to a partner account's subscription level and invoice information. New Relic uses the PUT method with this URI:

https://partner-specified/partner-specified/PARTNER_ID.json

OR

https://partner-specified/partner-specified/PARTNER_ID.xml

The Partnership API returns the results as JSON or XML.

Parameters:

Name Type Description
id string The customer's New Relic account ID
subscription_id integer Subscription's numeric ID
subscription_string string Description of subscription for display
price integer Monthly price of subscription in cents

Return codes:

  • 200: Successfully updated.
  • 404: Account not found.
  • 422: Missing or invalid parameters.
  • Authentication failed.

For more help

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