---
"@context": https://schema.org
"@type": TechArticle
"@id": https://www.twilio.com/docs/data-destinations/destination/new-relic#article
headline: New Relic destination
description: Learn how to send event data to New Relic for querying with NRQL, dashboards, and alerting.
url: https://www.twilio.com/docs/data-destinations/destination/new-relic
inLanguage: en
dateModified: 2026-11-04T17:24:28.000Z
author:
"@type": Organization
name: Twilio Developer Education Team
publisher:
"@type": Organization
name: Twilio
---
# New Relic destination
> \[!IMPORTANT]
>
> Data Destinations is currently available as a Private Beta product and the information contained in this document is subject to change. Data Destinations is not a HIPAA Eligible Service or PCI compliant and should not be enabled in workflows that are subject to HIPAA or PCI. To learn more, see [Private beta legal information](/docs/data-destinations#private-beta-legal-information).
[New Relic](https://newrelic.com/) is an observability platform that lets you turn Twilio events into custom events you can query with NRQL, chart on dashboards, and alert on alongside your other telemetry.
### Destination overview
* **Category**: Analytics, Performance monitoring
* **Release status**: Beta
* **Authentication**: API key
* **Regional availability**: US1
## Join the Data Destinations private beta
[Sign up](https://airtable.com/appaJfyV6LiIFMxuP/pagIaOAtKsQVxTfdW/form)
Get early access to native destinations for data warehouses, observability tools, and event pipelines.
## Eligible events
You can send all [Event Types](/docs/events/event-types-overview) supported by Event
Streams to New Relic. There's no user-identifier
restriction for this destination.
## Get started
### Prerequisites
Before you set up a New Relic destination, make sure you have:
* A New Relic account and its **Account ID**.
* A New Relic **License (ingest) key** for that account. The New Relic Event API doesn't accept Browser, Mobile, or User keys. Only a License key can write to it.
## Create the destination
> \[!NOTE]
>
> See [Set up a destination](/docs/data-destinations/destination-setup) for the full UI and Destinations API setup flow common to every destination type.
### Twilio Console
To create a New Relic destination in the Twilio Console:
1. From your New Relic account, gather the settings listed in [Destination settings](#destination-settings).
2. In the Twilio Console, go to **Data** > **Data Destinations** > **Destinations** > **Add destination subscription**.
3. Complete the **Add destination subscription** wizard.
### Destinations API
To create a New Relic destination through the Destinations API, send a `POST` request to the Destinations endpoint and set `destinationType` to `new-relic`. For authentication and the other request body fields, see [Create a destination](/docs/data-destinations/api-quickstart#create-a-destination).
```text title="Create a destination"
POST "https://destinations.twilio.com/v1/ControlPlane/Destinations"
```
Set the `config` object in the request body as follows:
| Name | Type | Description |
| ------------------------------------------------- | ------ | ------------------------------------------------------------------------------------------ |
| `accountId`
(**Required**) | string | New Relic account ID, used in the ingest URL path. |
| `credentials.credentialType`
(**Required**) | string | Set to `API_KEY`. |
| `credentials.apiKey`
(**Required**) | string | Your New Relic license (ingest) key. The Event API rejects browser, mobile, and user keys. |
The following example shows a request body. Replace the uppercase placeholder values with your own.
```json title="Example request body"
{
"destinationType": "new-relic",
"name": "My New Relic destination",
"config": {
"accountId": "ACCOUNT_ID",
"credentials": {
"credentialType": "API_KEY",
"apiKey": "API_KEY"
}
}
}
```
## Destination settings
Use `new-relic` as the `destinationType`.
| Field | Description | Required | Default or choices |
| ----------- | ------------------------------------------------------------------------------------------ | -------- | ------------------ |
| Account ID | New Relic account ID, used in the ingest URL path. | Yes | None |
| License Key | New Relic License (ingest) key, sent in the `Api-Key` header. Sensitive: stored encrypted. | Yes | None |
Twilio sends events to the New Relic Event API using the License Key you provide, scoped to the Account ID you configure. New Relic stores only string and numeric attribute values. It silently drops booleans, nulls, and attributes past its per-event cap at ingest.
## Default mappings
| Field | New Relic field |
| ------------- | --------------------------------------------------------------------------------------- |
| Event type | `eventType` (derived from the CloudEvent `type`, renamed to fit New Relic naming rules) |
| Event time | `timestamp` |
| Event payload | Spread as top-level custom attributes |
## Verification and troubleshooting
When you save a New Relic destination, Twilio validates your License Key with a non-ingesting write to the Event API. This check doesn't store any event data. The New Relic read APIs require a separate User key, which this destination doesn't collect, so a write-based check is the most Twilio can verify. It confirms your License Key is valid, but it can't fully confirm your Account ID is correct, because an unexpected status from New Relic can indicate either problem.
Twilio doesn't currently offer a way to manually trigger a test event for this destination, from either the Console or the CLI. To confirm delivery is working, wait for a real event of a subscribed type to fire.
New Relic doesn't confirm storage synchronously. Check your New Relic account for the event a few moments after it fires.
### Common errors
| Cause | What you'll see | Fix |
| ---------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------- |
| Invalid, expired, or wrong-type License Key | Validation fails with an authentication error | Confirm you're using a License (ingest) key, since Browser, Mobile, and User keys are rejected |
| Account ID incorrect | Validation returns an unexpected status | Re-check your New Relic Account ID |
| Event dropped for an unrepresentable attribute value | No error at save time. The event still delivers with some attributes silently omitted | Ensure attribute values are strings or numbers, since booleans and nulls aren't stored |
| Event batch exceeds the New Relic payload size limit (413) | Delivery errors reported in the [Debugger](/docs/usage/troubleshooting/debugging-your-application). Not retried, since the New Relic size cap is fixed | Reduce your event volume per subscription, or check for an oversized event payload |
If Twilio can't deliver events to New Relic, Twilio sends an error notification to the [Debugger](/docs/usage/troubleshooting/debugging-your-application) (available in US1 region only). If Twilio continues to encounter delivery errors, Twilio notifies you every 20 minutes after the initial error.
## Additional resources
* [Destinations overview](/docs/data-destinations/destinations-overview)
* [Set up a destination](/docs/data-destinations/destination-setup)
* [Event types reference](/docs/events/event-types-overview)