Skip to main content
Select Actions to adjust the guide
Some actions may require additional configuration in the provider to be accessible. Choose the actions you need and the guide will be updated.
Action
Scope(s)
Loading actions…
Dynamic Guide URL
Scopes Selected
Separator
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.