Datadog

🚀 Quickstart

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

Create the integration

In Nango (free signup), go to Integrations -> Configure New Integration -> Datadog.

Authorize Datadog

Go to Connections -> Add Test Connection -> Connect, then enter your API Key, Site Parameter, and Application Key. Later, you’ll let your users do the same directly from your app.

Call the Datadog API

Let’s make your first request to the Datadog API (validate your API key). Replace the placeholders below with your secret key, integration ID, and connection ID:

cURL
Node

curl "https://api.nango.dev/proxy/api/v1/validate" \
  -H "Authorization: Bearer <NANGO-SECRET-KEY>" \
  -H "Provider-Config-Key: <INTEGRATION-ID>" \
  -H "Connection-Id: <CONNECTION-ID>"

Install Nango’s backend SDK with npm i @nangohq/node. Then run:

import { Nango } from '@nangohq/node';

const nango = new Nango({ secretKey: '<NANGO-SECRET-KEY>' });

const res = await nango.get({
    endpoint: '/api/v1/validate',
    providerConfigKey: '<INTEGRATION-ID>',
    connectionId: '<CONNECTION-ID>'
});

console.log(res.data);

Or fetch credentials with the Node SDK or API.✅ You’re connected! Check the Logs tab in Nango to inspect requests.

Implement Nango in your app

Follow our Auth implementation guide to integrate Nango in your app.

📚 Datadog Integration Guides

Nango-maintained guides for common use cases.

How to obtain your Datadog API & Application Keys
Find your Site Parameter, generate an API Key, and create an Application Key in Datadog

Official docs: Datadog API documentation

🧩 Pre-built syncs & actions for Datadog

Enable them in your dashboard. Extend and customize to fit your needs.

Others

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

⌘I

Overview

900+ APIs & Integrations

🚀 Quickstart

📚 Datadog Integration Guides

🧩 Pre-built syncs & actions for Datadog

Others

​🚀 Quickstart

​📚 Datadog Integration Guides

​🧩 Pre-built syncs & actions for Datadog

​Others

🚀 Quickstart

📚 Datadog Integration Guides

🧩 Pre-built syncs & actions for Datadog

Others