---
title: "POST /api/v1/config/gcp-metrics-integrations"
method: POST
path: "/api/v1/config/gcp-metrics-integrations"
tags: ["GcpMetricsIntegration"]
---

# POST /api/v1/config/gcp-metrics-integrations

`POST /api/v1/config/gcp-metrics-integrations`

## Request body

- Configv1CreateGcpMetricsIntegrationRequest
  - `gcp_metrics_integration` Configv1GcpMetricsIntegration
    - `slug` string — Unique identifier of the GcpMetricsIntegration. If a `slug` isn't provided, one will be generated based of the `name` field. You can't modify this field after the GcpMetricsIntegration is created.
    - `name` string — Required. Name of the GcpMetricsIntegration. You can modify this value after the GcpMetricsIntegration is created.
    - `created_at` string, date-time — Timestamp of when the GcpMetricsIntegration was created. Cannot be set by clients.
    - `updated_at` string, date-time — Timestamp of when the GcpMetricsIntegration was last updated. Cannot be set by clients.
    - `service_account` Configv1GcpMetricsIntegrationServiceAccount
      - `client_email` string — Email address of the service account to impersonate.
    - `metric_groups` GcpMetricsIntegrationMetricGroup[] — Metric groups to be ingested for this integration.
      - `project_id` string — Project ID that has access to the metric data.
      - `prefixes` string[] — List of Gcp metric prefixes to ingest.
  - `dry_run` boolean — If true, the GcpMetricsIntegration isn't created, and no response GcpMetricsIntegration will be returned. The response will return an error if the given GcpMetricsIntegration is invalid.

## Response `200`

A successful response containing the created GcpMetricsIntegration.

- Configv1CreateGcpMetricsIntegrationResponse
  - `gcp_metrics_integration` Configv1GcpMetricsIntegration
    - `slug` string — Unique identifier of the GcpMetricsIntegration. If a `slug` isn't provided, one will be generated based of the `name` field. You can't modify this field after the GcpMetricsIntegration is created.
    - `name` string — Required. Name of the GcpMetricsIntegration. You can modify this value after the GcpMetricsIntegration is created.
    - `created_at` string, date-time — Timestamp of when the GcpMetricsIntegration was created. Cannot be set by clients.
    - `updated_at` string, date-time — Timestamp of when the GcpMetricsIntegration was last updated. Cannot be set by clients.
    - `service_account` Configv1GcpMetricsIntegrationServiceAccount
      - `client_email` string — Email address of the service account to impersonate.
    - `metric_groups` GcpMetricsIntegrationMetricGroup[] — Metric groups to be ingested for this integration.
      - `project_id` string — Project ID that has access to the metric data.
      - `prefixes` string[] — List of Gcp metric prefixes to ingest.

## Other responses

- `400` — Cannot create the GcpMetricsIntegration because the request is invalid.
- `409` — Cannot create the GcpMetricsIntegration because there is a conflict with an existing GcpMetricsIntegration.
- `500` — An unexpected error response.
- `default` — An undefined error response.

---

[API](https://skmtc.net/chronosphere/apis/config-v1-api.md) · [All operations](https://skmtc.net/chronosphere/apis/config-v1-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/chronosphere/config-v1-api/versions/530951bd2ccf/schema)