---
title: "Create an Azure integration"
method: POST
path: "/api/v1/integration/azure"
tags: ["Azure Integration"]
---

# Create an Azure integration

`POST /api/v1/integration/azure`

## Request

- Base URL: `https://api.datadoghq.com`
- URL: `https://api.datadoghq.com/api/v1/integration/azure`
- Auth: API key in header `DD-API-KEY` and API key in header `DD-APPLICATION-KEY`

Create a Datadog-Azure integration.

Using the `POST` method updates your integration configuration by adding your new
configuration to the existing one in your Datadog organization.

Using the `PUT` method updates your integration configuration by replacing your
current configuration with the new one sent to your Datadog organization.

## Request body

- AzureAccount: Datadog-Azure integrations configured for your organization.
  - `app_service_plan_filters` string: Limit the Azure app service plans that are pulled into Datadog using tags. Only app service plans that match one of the defined tags are imported into Datadog.
  - `automute` boolean: Silence monitors for expected Azure VM shutdowns.
  - `client_id` string: Your Azure web application ID.
  - `client_secret` string: Your Azure web application secret key.
  - `container_app_filters` string: Limit the Azure container apps that are pulled into Datadog using tags. Only container apps that match one of the defined tags are imported into Datadog.
  - `cspm_enabled` boolean: When enabled, Datadog’s Cloud Security Management product scans resource configurations monitored by this app registration. Note: This requires resource_collection_enabled to be set to true.
  - `custom_metrics_enabled` boolean: Enable custom metrics for your organization.
  - `errors` string[]: Errors in your configuration.
  - `host_filters` string: Limit the Azure instances that are pulled into Datadog by using tags. Only hosts that match one of the defined tags are imported into Datadog.
  - `metrics_enabled` boolean: Enable Azure metrics for your organization.
  - `metrics_enabled_default` boolean: Enable Azure metrics for your organization for resource providers where no resource provider config is specified.
  - `new_client_id` string: Your New Azure web application ID.
  - `new_tenant_name` string: Your New Azure Active Directory ID.
  - `resource_collection_enabled` boolean: When enabled, Datadog collects metadata and configuration info from cloud resources (compute instances, databases, load balancers, etc.) monitored by this app registration.
  - `resource_provider_configs` ResourceProviderConfig[]: Configuration settings applied to resources from the specified Azure resource providers.
    - `metrics_enabled` boolean: Collect metrics for resources from this provider.
    - `namespace` string: The provider namespace to apply this configuration to.
  - `secretless_auth_enabled` boolean: (Preview) When enabled, Datadog authenticates with this app registration using federated workload identity credentials instead of a client secret.
  - `tenant_name` string: Your Azure Active Directory ID.
  - `usage_metrics_enabled` boolean: Enable azure.usage metrics for your organization.

## Response `200`

OK

- object

## Other responses

- `400`: Bad Request
- `403`: Authentication Error
- `429`: Too many requests

---

[API](https://skmtc.dev/datadog/apis/datadog-api-v1-collection.md) - [All operations](https://skmtc.dev/datadog/apis/datadog-api-v1-collection/llms.txt) - [OpenAPI document](https://skmtc.dev/datadog/apis/datadog-api-v1-collection/revisions/ca5871004d26?raw)