---
title: "Validate an Integration"
method: POST
path: "/pim/v2/integrations:validate"
tags: ["Integrations (pim/v2)"]
---

# Validate an Integration

`POST /pim/v2/integrations:validate`

[![Early Access](https://img.shields.io/badge/Lifecycle%20Stage-Early%20Access-%2345c6e8)](#section/Versioning/API-Lifecycle-Policy) [![Request Access To Provider Integration](https://img.shields.io/badge/-Request%20Access%20To%20Provider%20Integration-%23bc8540)](mailto:ccloud-api-access+pim-v2-early-access@confluent.io?subject=Request%20to%20join%20pim/v2%20API%20Early%20Access&body=I%E2%80%99d%20like%20to%20join%20the%20Confluent%20Cloud%20API%20Early%20Access%20for%20pim/v2%20to%20provide%20early%20feedback%21%20My%20Cloud%20Organization%20ID%20is%20%3Cretrieve%20from%20https%3A//confluent.cloud/settings/billing/payment%3E.)

Validate the provider integration configuration.

## Request body

- object — Request to validate the provider integration configuration.
  - `api_version` 'pim/v2' — APIVersion defines the schema version of this representation of a resource.
  - `kind` 'IntegrationValidateRequest' — Kind defines the object this REST resource represents.
  - `id` string, required — The ID of the provider integration to validate.
  - `metadata` object — ObjectMeta is metadata that all persisted resources must have, which includes all objects users must create.
    - `self` string, uri, required — Self is a Uniform Resource Locator (URL) at which an object can be addressed. This URL encodes the service location, API version, and other particulars necessary to locate the resource at a point in time
    - `resource_name` string, uri — Resource Name is a Uniform Resource Identifier (URI) that is globally unique across space and time. It is represented as a Confluent Resource Name
    - `created_at` string, date-time — The date and time at which this object was created. It is represented in RFC3339 format and is in UTC.
    - `updated_at` string, date-time — The date and time at which this object was last updated. It is represented in RFC3339 format and is in UTC.
    - `deleted_at` string, date-time — The date and time at which this object was (or will be) deleted. It is represented in RFC3339 format and is in UTC.
  - `config` union — Cloud provider specific configuration for the provider integration. Required only for integrations in `DRAFT` status.
    - object — config schema for GCP cloud service provider.
      - `google_service_account` string — The ID of the Google Service Account that Confluent Cloud uses to impersonate customer Google Service Account when it accesses resources in your GCP project.
      - `customer_google_service_account` string — The ID of the Google Service Account that Confluent Cloud impersonates to access resources in your GCP Project.
      - `kind` string, required — Cloud provider specific config to which access is provided through provider integration.
    - object — config schema for Azure cloud service provider.
      - `confluent_multi_tenant_app_id` string — The ID of the Confluent Multi-Tenant App that Confluent Cloud uses to impersonate customer Azure App when it accesses resources in your Azure subscription.
      - `customer_azure_tenant_id` string — The ID of the customer's Azure Active Directory (Azure AD) tenant
      - `kind` string, required — Cloud provider specific config to which access is provided through provider integration.
    - object — config schema for AWS cloud service provider.
      - `iam_role_arn` string — Amazon Resource Name (ARN) that identifies the Amazon Web Services (AWS) Identity and Access Management (IAM) role that Confluent Cloud uses to assume customer IAM role when it accesses resources in your AWS account.
      - `external_id` string, uuid — Unique external ID that Confluent Cloud uses when it assumes the IAM role in your Amazon Web Services (AWS) account.
      - `customer_iam_role_arn` string — Amazon Resource Name (ARN) that identifies the Amazon Web Services (AWS) Identity and Access Management (IAM) role that Confluent Cloud assumes when it accesses resources in your AWS account.
      - `kind` string, required — Cloud provider specific config to which access is provided through provider integration.
  - `environment` GlobalObjectReference, required — ObjectReference provides information for you to locate the referred object
    - `id` string, required — ID of the referred resource
    - `related` string, uri, required — API URL for accessing or modifying the referred object
    - `resource_name` string, uri, required — CRN reference to the referred resource

## Response `204`

The provider integration configuration is validated successfully.

## Other responses

- `400` — Bad Request
- `401` — The request lacks valid authentication credentials for this resource.
- `403` — The access credentials were considered insufficient to grant access
- `404` — Not Found
- `429` — Rate Limit Exceeded
- `500` — Oops, something went wrong!

---

[API](https://skmtc.dev/confluent/apis/confluent-cloud-apis.md) · [All operations](https://skmtc.dev/confluent/apis/confluent-cloud-apis/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/confluent/confluent-cloud-apis/revisions/a6a73f98a698/schema)