---
title: "Validate entity context sync credentials"
method: POST
path: "/api/v2/security_monitoring/configuration/integration_config/validate"
tags: ["Security Monitoring"]
---

# Validate entity context sync credentials

`POST /api/v2/security_monitoring/configuration/integration_config/validate`

## Request

- Base URL: `https://api.datadoghq.com`
- URL: `https://api.datadoghq.com/api/v2/security_monitoring/configuration/integration_config/validate`
- Auth: one of:
  - API key in header `DD-API-KEY` and API key in header `DD-APPLICATION-KEY`
  - OAuth 2
    - Authorization code: `/oauth2/v1/authorize`
    - Token URL: `/oauth2/v1/token` scopes: `integrations_read`

Validate a set of credentials against the external entity source before creating a sync configuration.
Returns a 200 status code if the credentials are valid.

## Request body

- SecurityMonitoringIntegrationCredentialsValidateRequest: Request body to validate credentials against an external entity source before creating a sync configuration.
  - `data` SecurityMonitoringIntegrationCredentialsValidateData, required: The credentials to validate.
    - `attributes` SecurityMonitoringIntegrationCredentialsValidateAttributes, required: The credentials to validate against the external entity source.
      - `domain` string, required: The domain associated with the external entity source.
      - `integration_type` 'GOOGLE_WORKSPACE' | 'OKTA' | 'ENTRA_ID', required: The type of external source that provides entities to Cloud SIEM.
      - `secrets` SecurityMonitoringIntegrationConfigSecrets: The secrets used to authenticate against the external entity source. The accepted keys depend on the source type (for example, `admin_email` for Google Workspace). Not required for source types that do not use secrets (for example, `ENTRA_ID`).
    - `type` 'integration_config', required: The type of the resource. The value should always be `integration_config`.

## Response `200`

OK

## Other responses

- `400`: Bad Request
- `403`: Not Authorized
- `429`: Too many requests

---

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