Skip to main content
You need Datadog Admin or equivalent role to create API and Application keys.

​
Identify Your Datadog Site

Datadog operates across multiple regional sites. You must select the correct site that matches your organization’s Datadog instance.

1

Determine Your Site Region

Log in to your Datadog account for your region (for example, https://app.datadoghq.com for US1, or regional hosts such as https://us3.datadoghq.com or https://ap1.datadoghq.com) and check the URL in your browser to identify your site. Your browser will show either an app.datadoghq.* host or a regional subdomain (for example, us3.datadoghq.com, us5.datadoghq.com, ap1.datadoghq.com) — when connecting your account, select the corresponding api. host from the options below.

  • US1 - api.datadoghq.com (most common)
  • US3 - api.us3.datadoghq.com
  • US5 - api.us5.datadoghq.com
  • EU - api.datadoghq.eu
  • AP1 - api.ap1.datadoghq.com
  • US1-FED - api.ddog-gov.com (government)

​
Generate an API Key

An API key is required to authenticate all requests to the Datadog API.

1

Navigate to API Keys

In your Datadog dashboard, click your avatar in the bottom-left corner and select Organization Settings. Then navigate to API Keys under the Access section.

2

Create a New API Key

Click the + New Key button at the top-right.

  • Enter a descriptive Name for your key (e.g., “StackOne Integration”).
  • Click Create Key.
3

Copy the API Key

The new API key will be displayed. Click the Copy button to copy it and store it securely for use later. You can reveal the key again later from this page if needed.

​
Generate an Application Key

An Application key is required alongside the API key to access programmatic features. Application keys are scoped to the permissions of the user who created them.

1

Navigate to Application Keys

In Organization Settings, navigate to Application Keys under the Access section.

2

Create a New Application Key

Click the + New Key button at the top-right.

  • Enter a descriptive Name for your key (e.g., “StackOne Integration”).
  • Click Create Key.
3

Configure scopes

Enables actions: Aggregate Logs, Aggregate Spans, Create Log Index, Create Monitor, Create Service Definition, Delete Service Definition, Get Metric Metadata, Get Metric Tag Configuration, Get Monitor, Get Service Definition, List Active Metrics, List Log Indexes, List Logs, List Monitors, List Retention Filters, List Service Definitions, List Service Dependencies, List Spans, List Tags By Metric, Query Metrics, Scalar Query, Search Logs, Search Spans, Timeseries Query, Update Monitor

When creating the Application Key, you can optionally add scopes to restrict its permissions. If no scopes are selected, the key is unscoped and inherits the full permissions of the user who created it. Enable only the scopes required for the actions you intend to use:

4

Copy the Application Key

The new Application key will be displayed. Copy it immediately and store it securely for use later. This key will not be shown again after you navigate away from this page.

​
Linking the Account from the Hub

1

Navigate to the Hub

Use one of the three Linking Account Methods to access the Hub.
2

Fill out the fields

Fill out the following fields using details from your provider:
  • Datadog Site
  • API Key
  • Application Key
3

Connect

  • Click Connect
  • If applicable, the provider will redirect you to a sign-in or authorization page. Complete the provider’s authorization flow.
  • Once authorization is successful, you will see a confirmation popup

If the account linking is successful, you will see the newly linked account in your Accounts page.