> ## Documentation Index
> Fetch the complete documentation index at: https://nango.dev/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Datadog (OAuth)

> Integrate your application with the Datadog API using OAuth

## 🚀 Quickstart

Connect to Datadog with Nango and see data flow in 2 minutes.

**1. Create the integration**

In Nango ([free signup](https://app.nango.dev)), go to [Integrations](https://app.nango.dev/dev/integrations) -> *Configure New Integration* -> *Datadog (OAuth)*.

**2. Authorize Datadog**

Go to [Connections](https://app.nango.dev/dev/connections) -> *Add Test Connection* -> *Authorize*, then select your Datadog site and log in. Later, you'll let your users do the same directly from your app.

**3. Call the Datadog API**

Let's make your first request to the Datadog API (list events). Replace the placeholders below with your [Environment API key](https://nango.dev/docs/reference/backend/http-api/api-keys.md), [integration ID](https://app.nango.dev/dev/integrations), and [connection ID](https://app.nango.dev/dev/connections):

> [tab] cURL
>
> ```bash theme={null}
> curl "https://api.nango.dev/proxy/v1/events" \
>   -H "Authorization: Bearer <NANGO-API-KEY>" \
>   -H "Provider-Config-Key: <INTEGRATION-ID>" \
>   -H "Connection-Id: <CONNECTION-ID>"
> ```

> [tab] Node
>
> Install Nango's backend SDK with `npm i @nangohq/node`. Then run:
>
> ```typescript theme={null}
> import { Nango } from '@nangohq/node';
>
> const nango = new Nango({ apiKey: '<NANGO-API-KEY>' });
>
> const res = await nango.get({
>     endpoint: '/v1/events',
>     providerConfigKey: '<INTEGRATION-ID>',
>     connectionId: '<CONNECTION-ID>'
> });
>
> console.log(res.data);
> ```

Or fetch credentials with the [Node SDK](https://nango.dev/docs/reference/backend/backend-sdk/node.md#get-a-connection-with-credentials) or [API](https://nango.dev/docs/reference/backend/http-api/connections/get.md).

✅ You're connected! Check the [Logs](https://app.nango.dev/dev/logs) tab in Nango to inspect requests.

**4. Implement Nango in your app**

Follow our [Auth implementation guide](https://nango.dev/docs/guides/primitives/auth.md) to integrate Nango in your app.

To obtain your own credentials, follow the setup guide linked below.

## 📚 Datadog (OAuth) integration guides

Nango-maintained guides for common use cases.

* [How to register your own Datadog OAuth app](https://nango.dev/docs/api-integrations/datadog-oauth/how-to-register-your-own-datadog-oauth-api-oauth-app)
  Register an OAuth client with Datadog and obtain credentials to connect it to Nango

* [How to link your Datadog account](https://nango.dev/docs/api-integrations/datadog-oauth/connect)
  Find your Datadog site parameter and connect your account through Nango's UI

Official docs: [OAuth2 in Datadog](https://docs.datadoghq.com/developers/authorization/oauth2_in_datadog/)

## 🧩 Pre-built syncs & tools for Datadog (OAuth)

Explore Nango-provided tools in your dashboard. Extend and customize them to fit your needs.

### Others

| Function name | Description | Type |
| - | - | - |
| `add-host-tags` | Add tags to a host | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `add-team-membership` | Add a user to a team with a given role | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `cancel-downtime` | Cancel a scheduled or active downtime. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `create-api-key` | Create a new API key for this account. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `create-case-project` | Create a new case-management project. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `create-case` | Create a new case within a project. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `create-dashboard` | Create a new dashboard with a widget layout. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `create-downtime` | Schedule a downtime (maintenance window) that suppresses monitor notifications for a scope/time range. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `create-escalation-policy` | Create a new On-Call escalation policy | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `create-incident` | Create a new incident. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `create-monitor` | Create a new monitor | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `create-notebook` | Create a new notebook | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `create-on-call-page` | Trigger a new On-Call page (alert a specific person or escalation policy immediately, independent of a monitor firing). | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `create-on-call-schedule` | Create a new On-Call rotation schedule | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `create-personal-access-token` | Create a new personal access token. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `create-role` | Create a new role. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `create-rum-application` | Create a new RUM application (registers a client\_token for browser/mobile SDK instrumentation). | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `create-sensitive-data-scanner-group` | Create a new scanning group (a named collection of scanning rules with a shared filter) | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `create-sensitive-data-scanner-rule` | Create a new scanning rule within a group (a pattern to detect and optionally redact). | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `create-service-account-access-token` | Create an OAuth-style access token for a service account. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `create-service-account-application-key` | Create an application key owned by a service account. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `create-service-account` | Create a new service account (a non-human user identity for machine-to-machine API access). | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `create-service-definition` | Create or update a service definition (also used for updates — same endpoint upserts by service name). | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `create-slo-correction` | Create a new SLO correction window. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `create-slo` | Create a new metric-based or monitor-based Service Level Objective. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `create-synthetic-api-test` | Create a new Synthetic API (HTTP) test | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `create-synthetic-global-variable` | Create a reusable global variable for use across Synthetic tests. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `create-team` | Create a new team. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `create-user` | Create a new user (invited by email) in this account. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `delete-api-key` | Delete an API key | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `delete-dashboard` | Delete a dashboard. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `delete-host-tags` | Remove all tags from a host | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `delete-monitor` | Delete a monitor. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `delete-notebook` | Delete a notebook. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `delete-restriction-policy` | Remove the restriction policy from a resource (reverting to default account-wide access rules). | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `delete-role` | Delete a role. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `delete-rum-application` | Delete a RUM application. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `delete-sensitive-data-scanner-rule` | Delete a scanning rule. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `delete-slo-correction` | Permanently delete an SLO correction. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `delete-slo` | Delete an SLO. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `delete-synthetic-tests` | Delete one or more Synthetic tests. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `delete-team` | Delete a team. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `delete-user-invitations` | Revoke/delete all pending invitations for a user. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `disable-user` | Disable (deactivate) a user, preventing further login. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-api-key` | Get a single API key's metadata by id. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-current-user` | Get the profile of the user this connection authenticates as, including org/role relationships. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-dashboard` | Get a single dashboard by id, including its full widget layout. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-host-tags` | Get tags assigned to a specific host. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-hourly-usage` | Get hourly usage broken down by product family — the current recommended usage endpoint (most per-product v1 hourly endpoints are deprecated in favor of this one). | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-monitor` | Get a single monitor by id | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-notebook` | Get a single notebook by id. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-on-call-schedule` | Get a single On-Call schedule by id. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-organization` | Get details of a single organization. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-restriction-policy` | Get the restriction policy (fine-grained access bindings) for a specific resource. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-role` | Get a single role by id. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-rum-application` | Get a single RUM application by id. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-sensitive-data-scanner-config` | Get the full Sensitive Data Scanner configuration tree (scanning groups and rules). | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-slo-correction` | Get a single SLO correction by id. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-slo-history` | Get the historical SLI value for an SLO over a time range. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-slo` | Get a single SLO by id. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-synthetic-api-test` | Get a single Synthetic API test's configuration. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-team` | Get a single team by id. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-usage-summary` | Get a summary of billable usage across all Datadog products for a given month range. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-user-invitation` | Get the status/details of a single user invitation. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-user` | Get a single user by id. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-api-keys` | List API keys configured for this account (metadata only, not secret values). | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-application-keys` | List application keys for this account. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-case-projects` | List case-management projects (containers for cases, similar in spirit to a Jira project). | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-cases` | List or search cases across projects. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-catalog-entities` | List Software Catalog entities | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-container-images` | List container images observed in this account, optionally enriched with security scan data. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-containers` | List containers reported by hosts running the Datadog Agent. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-dashboards` | List dashboards in this account. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-downtimes` | List scheduled and active downtimes. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-events` | List events (deployments, alerts, custom annotations) within a time range. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-hosts` | List hosts reporting into this account. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-incidents` | List incidents tracked via Datadog Incident Management. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-metrics` | List active metric names reporting in this account since a given time. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-monitors` | List monitors (alerting rules) configured in this Datadog account. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-notebooks` | List notebooks in this account. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-organizations` | List organizations manageable by this account (relevant for multi-org/MSP setups). | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-personal-access-tokens` | List personal access tokens | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-processes` | List processes reported by hosts running the Datadog Agent's live process collection. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-role-permissions` | List the permissions granted to a role. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-roles` | List roles (permission bundles assignable to users) in this account. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-rum-applications` | List Real User Monitoring (RUM) applications configured in this account. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-rum-metrics` | List custom metrics derived from RUM events. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-security-rules` | List Cloud SIEM / Security Monitoring detection rules. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-service-account-access-tokens` | List access tokens issued to a service account. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-service-account-application-keys` | List application keys owned by a service account. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-service-definitions` | List service definitions in the Service Catalog. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-slo-corrections` | List SLO corrections (time windows excluded from an SLO's error-budget calculation, e.g. for planned maintenance). | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-slos` | List Service Level Objectives. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-synthetic-locations` | List available public and private Synthetic test locations. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-synthetic-tests` | List Synthetic API/browser/mobile tests. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-team-memberships` | List users who are members of a team. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-teams` | List teams in this organization. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-user-identity-providers` | Get identity-provider (SSO) overrides configured for a specific user. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-user-permissions` | List the effective permissions a user has (aggregated from their assigned roles). | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-user-team-memberships` | List the teams a specific user belongs to (the inverse view of list-team-memberships, which lists users for a given team). | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-users` | List users in this account. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `mute-monitor` | Mute (silence) a monitor's notifications. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `post-event` | Create a custom event (annotation) on the Datadog event stream. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `query-metrics` | Query a metric time series data points over a time range. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `search-logs` | Search ingested log events within a time range. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `send-user-invitation` | (Re-)send an invitation email to one or more pending users. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `submit-logs` | Ingest raw log lines. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `submit-metrics` | Ingest custom metric data points | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `unmute-monitor` | Unmute a previously muted monitor. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `update-api-key` | Rename an API key. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `update-current-user` | Update the profile of the user this connection authenticates as (name/title). | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `update-dashboard` | Update a dashboard's title, layout, or widgets. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `update-monitor` | Update a monitor's name, query, message, or options. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `update-notebook` | Update a notebook's name, cells, or time range. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `update-organization` | Update organization settings (name, billing, SAML config). | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `update-restriction-policy` | Set or replace the restriction policy (access bindings) for a resource. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `update-role` | Update a role's name. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `update-rum-application` | Update a RUM application's name or settings. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `update-synthetic-api-test` | Edit an existing Synthetic API test configuration. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `update-team` | Update a team's name, handle, or description. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `update-user` | Update a user's name, email, title, or disabled status. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `validate-monitor` | Validate a monitor definition (type + query) without creating it. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `case_projects` | Sync case-management projects. | [Sync](https://nango.dev/docs/guides/functions/syncs/sync-functions.md) |
| `dashboards` | Sync dashboards in this account. | [Sync](https://nango.dev/docs/guides/functions/syncs/sync-functions.md) |
| `events` | Sync events (deployments, alerts, custom annotations) in a time window | [Sync](https://nango.dev/docs/guides/functions/syncs/sync-functions.md) |
| `hosts` | Sync hosts reporting into this account. | [Sync](https://nango.dev/docs/guides/functions/syncs/sync-functions.md) |
| `monitors` | Sync monitors (alerting rules) configured in this account. | [Sync](https://nango.dev/docs/guides/functions/syncs/sync-functions.md) |
| `notebooks` | Sync notebooks in this account. | [Sync](https://nango.dev/docs/guides/functions/syncs/sync-functions.md) |
| `roles` | Sync roles (permission bundles) configured in this account. | [Sync](https://nango.dev/docs/guides/functions/syncs/sync-functions.md) |
| `rum_applications` | Sync Real User Monitoring (RUM) applications configured in this account. | [Sync](https://nango.dev/docs/guides/functions/syncs/sync-functions.md) |
| `service_definitions` | Sync Service Catalog service definitions. | [Sync](https://nango.dev/docs/guides/functions/syncs/sync-functions.md) |
| `slos` | Sync Service Level Objectives. | [Sync](https://nango.dev/docs/guides/functions/syncs/sync-functions.md) |
| `synthetic_tests` | Sync Synthetic API/browser/mobile tests. | [Sync](https://nango.dev/docs/guides/functions/syncs/sync-functions.md) |
| `teams` | Sync teams in this organization. | [Sync](https://nango.dev/docs/guides/functions/syncs/sync-functions.md) |
| `users` | Sync users in this account. | [Sync](https://nango.dev/docs/guides/functions/syncs/sync-functions.md) |

## API gotchas

* Datadog's OAuth authorize and token endpoints, and its API base URL, are all site-specific — pick the site matching where your users' Datadog accounts live (for example `datadoghq.com` for US1, `datadoghq.eu` for EU1). A token issued on one site won't work against another site's API.
* Grant only the scopes your app actually needs when creating your OAuth client — Datadog enforces the principle of least privilege, and any request against a scope you didn't request returns a 401 even with a valid, unexpired token. See [Authorization scopes for OAuth clients](https://docs.datadoghq.com/api/latest/scopes/) for the full list.
* To send data on behalf of a connected user (rather than just reading it), you need a Datadog API key. Call the [API Key Creation endpoint](https://docs.datadoghq.com/api/latest/key-management/#create-an-api-key) with the `API_KEYS_WRITE` scope — the generated key is only ever shown once, so store it securely.

***


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.