---
title: New Relic API Integration on Truto
slug: newrelic
category: Default
canonical: "https://truto.one/integrations/detail/newrelic/"
---

# New Relic API Integration on Truto



**Category:** Default  
**Status:** Generally available

## Unified APIs

### Unified User Directory API

- **Groups** — Groups are a collection of users in the source application. In some applications, they might also be called Teams.
- **Roles** — The Role object represents a role of a User.
- **Users** — The User object represents a User.

## MCP-ready AI tools

Truto exposes 54 tools for New Relic that AI agents can call directly.

- **list_all_newrelic_users** — Use this endpoint to list all users available in the New Relic account.
- **get_single_newrelic_user_by_id** — Use this endpoint to retrieve detailed information about a specific user in New Relic.
- **delete_a_newrelic_user_by_id** — Use this endpoint to delete a user from your New Relic account.
- **create_a_newrelic_user** — Use this endpoint to create a new user in a manually provisioned New Relic authentication domain. You provide the authentication domain ID, the user’s email address, display name, and the requested user type tier (for example, BASIC_USER_TIER, CORE_USER_TIER, or FULL_USER_TIER)
- **update_a_newrelic_user_by_id** — Use this endpoint to update an existing user’s email address and/or user type tier, identified by their user ID
- **list_all_newrelic_roles** — Use this endpoint to list all the roles available in New Relic.
- **get_single_newrelic_role_by_id** — Use this endpoint to retrieve detailed information about a specific role.
- **list_all_newrelic_authentication_domains** — Use this endpoint to list all authentication domains configured in your New Relic account.
- **get_single_newrelic_authentication_domain_by_id** — Use this endpoint to retrieve detailed information about a specific authentication domain.
- **list_all_newrelic_me** — Use this endpoint to retrieve information about the currently authenticated user.
- **list_all_newrelic_groups** — Use this endpoint to list all groups in your New Relic account.
- **get_single_newrelic_group_by_id** — Use this endpoint to retrieve detailed information about a specific group.
- **create_a_newrelic_group** — Use this endpoint to create a new user group in a specific New Relic authentication domain, providing the authentication domain ID and the group’s display name.
- **update_a_newrelic_group_by_id** — Use this endpoint to update the display name of an existing user group in New Relic, identified by its group ID.
- **delete_a_newrelic_group_by_id** — Use this endpoint to delete an existing user group from New Relic, identified by its group ID.
- **list_all_newrelic_accounts** — Use this endpoint to list all New Relic accounts that are visible to the authenticated user, including their IDs and basic metadata.
- **create_a_newrelic_account** — Use this endpoint to create a new New Relic account (or sub-account) within the authenticated organization using the provided account details.
- **update_a_newrelic_account_by_id** — Use this endpoint to update an existing New Relic account’s properties, such as its name or settings, identified by its account ID.
- **delete_a_newrelic_account_by_id** — Use this endpoint to delete or deprovision an existing New Relic account, identified by its account ID, according to New Relic’s account lifecycle rules
- **get_single_newrelic_account_by_id** — Use this endpoint to retrieve information about a specific managed account in your New Relic organization.
- **list_all_newrelic_tags** — Use this endpoint to list all tags and their values attached to entities in New Relic, based on the entity search criteria you provide.
- **list_all_newrelic_account_workloads** — Use this endpoint to list all workload entities associated with a New Relic account, returning each workload’s GUID, name, and other identifying fields.
- **list_all_newrelic_workload_entities** — Use this endpoint to list the individual entities that belong to a specific workload, given the workload’s GUID or related identifiers.
- **list_all_newrelic_workload_status** — Use this endpoint to retrieve the computed status information for one or more workloads, such as their workloadStatus value for the given workload GUID.
- **list_all_newrelic_alert_policies** — Use this endpoint to list all alert policies configured for a New Relic account, including each policy’s ID, name, and incident preference.
- **create_a_newrelic_alert_policy** — Use this endpoint to create a new alert policy in a specific New Relic account, providing the account ID, policy name, and incident preference to control how incidents are opened and grouped.
- **get_single_newrelic_alert_policy_by_id** — Use this endpoint to retrieve detailed information about a specific alert policy in a New Relic account, given the account ID and policy ID, including its name and incident preference.
- **update_a_newrelic_alert_policy_by_id** — Use this endpoint to update an existing alert policy in a New Relic account, such as renaming the policy, identified by the account ID and policy ID.
- **delete_a_newrelic_alert_policy_by_id** — Use this endpoint to delete an existing alert policy from a New Relic account, identified by the account ID and policy ID, removing the policy and its associated alerting behavior.



- **list_all_newrelic_dashboard** — Use this endpoint to list all dashboards available to the authenticated user, returning each dashboard’s GUID, name, and associated account ID.
- **get_single_newrelic_dashboard_by_id** — Use this endpoint to retrieve the full configuration of a specific dashboard, given its dashboard GUID, including metadata, pages, widgets, and variables.
- **create_a_newrelic_dashboard** — Use this endpoint to create a simple New Relic dashboard in a specific account, using a single NRQL query.
The account is selected by its ID, and you provide the dashboard name, optional description, and an NRQL query. The endpoint creates a dashboard with one page and one billboard widget that visualizes the provided NRQL query.
- **delete_a_newrelic_dashboard_by_id** — Use this endpoint to delete an existing New Relic dashboard, identified by its dashboard GUID.

- **list_all_newrelic_log_parsing_rules** — Use this endpoint to list all log parsing rules defined for a New Relic account, including their IDs, patterns, NRQL, and enablement status.


- **create_a_newrelic_log_parsing_rule** — Use this endpoint to create a new log parsing rule for a New Relic account.

- **update_a_newrelic_log_parsing_rule_by_id** — Use this endpoint to update an existing log parsing rule for a New Relic account.

- **delete_a_newrelic_log_parsing_rule_by_id** — Use this endpoint to delete an existing log parsing rule from a New Relic account.

- **list_all_newrelic_log_data_partition_rules** — Use this endpoint to list all log data partition rules configured for a New Relic account, showing how logs are routed to target data partitions.
- **list_all_newrelic_organization** — Use this endpoint to retrieve information about the current New Relic organization, including its organization ID and name.
- **list_all_newrelic_teams** — Use this endpoint to list all teams defined in the New Relic organization, including each team’s ID, name, description, and aliases.
- **create_a_newrelic_team** — Use this endpoint to create a new team in the New Relic organization, providing a team name, an optional description, and the organization ID that scopes the team.
- **get_single_newrelic_team_by_id** — Use this endpoint to retrieve detailed information about a specific New Relic team, given its team entity ID, including the team’s ID, name, description, and aliases.
- **update_a_newrelic_team_by_id** — Use this endpoint to update an existing New Relic team’s basic details, such as its name and description, identified by the team’s entity ID.
- **list_all_newrelic_service_levels** — Use this endpoint to retrieve the service level configuration (SLIs and their SLO objectives) for a specific New Relic entity, given its entity GUID, including each indicator’s metadata, target, and rolling time window.
- **create_a_newrelic_service_level** — Use this endpoint to create a new service level (SLI with a single SLO) for a specific New Relic entity.
You provide the entity GUID, NRDB account ID, SLI name and description, NRQL FROM/WHERE clauses for valid and good events, an SLO target percentage, and a rolling time window in days. Internally it calls the serviceLevelCreate mutation with an indicator that defines the valid and good events and creates one objective in the objectives list. The endpoint returns the newly created service level’s ID and description.
- **get_single_newrelic_service_level_by_id** — Use this endpoint to retrieve the service level configuration for a specific entity and then select a single service level (SLI) by its ID
- **update_a_newrelic_service_level_by_id** — Use this endpoint to update the SLO objectives for an existing service level indicator (SLI), identified by its SLI ID.
- **list_all_newrelic_synthetic_monitors** — Use this endpoint to list all synthetic monitors (ping, API, browser, and scripted monitors) visible to the authenticated user, returning each monitor’s GUID, name, account ID, monitor type, and key configuration tags.
- **get_single_newrelic_synthetic_monitor_by_id** — Use this endpoint to retrieve basic information about a specific synthetic monitor, given its monitor entity GUID. It returns the entity’s GUID, name, type, account ID, and basic monitor-specific summary information.
- **list_all_newrelic_golden_metrics** — Use this endpoint to retrieve the golden metrics configuration for a specific New Relic entity, given its entity GUID, returning each golden metric’s NRQL query, title, and other key details that define the entity’s primary health signals
- **create_a_newrelic_golden_metric** — Use this endpoint to create or update an account-level golden metrics configuration for a specific entity domain and type.
- **list_all_newrelic_metric_normalization_rules** — Use this endpoint to list all metric normalization rules defined for a New Relic account, returning each rule’s ID, match expression, replacement action, evaluation order, enablement state, and related metadata.
- **create_a_newrelic_metric_normalization_rule** — Use this endpoint to create a new metric normalization rule for a New Relic account.
- **update_a_newrelic_metric_normalization_rule_by_id** — Use this endpoint to edit an existing metric normalization rule for a New Relic account, identified by its rule ID.

## How it works

1. **Link your customer's New Relic account.** Use Truto's frontend SDK; we handle every OAuth and API key flow so you don't need to create the OAuth app.
2. **Authentication is automatic.** Truto refreshes tokens, stores credentials securely, and injects them into every API request.
3. **Call Truto's API to reach New Relic.** The Proxy API is a 1-to-1 mapping of the New Relic API.
4. **Get a unified response format.** Every response uses a single shape, with cursor-based pagination and data in the `result` field.

## Use cases

- **Automate user provisioning and deprovisioning in New Relic** — IAM and HR platforms can automatically create, update, and remove New Relic users when employees join, change roles, or leave the organization — ensuring SOC2 compliance and eliminating manual seat management.
- **Sync groups and roles for least-privilege access governance** — Security and IT management tools can map identity provider groups to New Relic groups and roles, enforcing consistent RBAC policies across the observability stack without manual configuration.
- **Deploy pre-built dashboards and alert policies for customers** — Cloud hosting and PaaS providers can programmatically create New Relic dashboards and alert policies when customers connect, delivering instant observability value without requiring end users to configure anything.
- **Surface workload health and golden metrics in external tools** — Incident management and DevOps platforms can pull real-time workload status and golden metrics from New Relic to display system health directly inside their own UI, reducing context-switching during incidents.
- **Programmatically manage SLIs/SLOs across customer environments** — Platform engineering tools can create and update service levels in New Relic on behalf of their users, ensuring every deployed service has standardized reliability targets from day one.

## What you can build

- **Automated New Relic user lifecycle management** — Provision and deprovision New Relic users with the correct user tier and group membership in response to HR or identity events, using the Unified User Directory API for users, groups, and roles.
- **One-click observability dashboard provisioning** — Automatically create pre-configured New Relic dashboards tailored to your product's metrics when a customer connects their account, giving them instant visibility without writing NRQL.
- **Alert policy injection for managed services** — Programmatically deploy baseline alert policies — such as latency thresholds and error rate monitors — into a customer's New Relic account as part of your product's onboarding flow.
- **Real-time workload health widget** — Embed live New Relic workload status and golden metrics directly into your incident response or operations dashboard so responders never need to leave your product.
- **Cross-platform team and group synchronization** — Keep New Relic teams and groups in sync with your platform's organizational structure by reading authentication domains and programmatically creating or updating groups and team memberships.
- **Service level automation engine** — Create and manage New Relic SLIs and SLOs programmatically when new services are deployed, ensuring every microservice has defined reliability targets and error budget tracking.

## FAQs

### What authentication method does the New Relic integration use?

New Relic uses API keys (User keys) for authentication. Truto handles the secure storage and injection of these keys so your end users can connect their New Relic accounts without you managing credentials directly.

### Which Unified APIs does Truto support for New Relic?

Truto maps New Relic to the Unified User Directory API, which provides normalized endpoints for Users, Groups, and Roles. This lets you read, create, update, and delete users and groups using a consistent schema across all your integrations.

### What New Relic resources can I manage beyond the Unified API?

Beyond users, groups, and roles, Truto provides native endpoints for accounts, dashboards, alert policies, service levels, synthetic monitors, workloads, workload status, golden metrics, teams, tags, log parsing rules, log data partition rules, metric normalization rules, authentication domains, and organizations.

### Does Truto handle pagination for New Relic's GraphQL-based API?

Yes. New Relic's NerdGraph API uses cursor-based pagination. Truto abstracts this away so you can iterate through large result sets of users, groups, accounts, or any other resource without implementing pagination logic yourself.

### Can I create and delete New Relic accounts programmatically?

Yes. Truto supports create_a_newrelic_account, update_a_newrelic_account_by_id, and delete_a_newrelic_account_by_id, enabling multi-tenant provisioning workflows where you spin up dedicated sub-accounts for each of your customers.

### How fresh is the data when listing users or workload status?

Data is fetched in real-time from New Relic's NerdGraph API on each request through Truto. There is no caching layer by default, so you always get the current state of users, groups, workload health, and other resources.