---
title: "Create an incident Google Chat configuration"
method: POST
path: "/api/v2/incidents/config/google-chat-configurations"
tags: ["Incidents"]
---

# Create an incident Google Chat configuration

`POST /api/v2/incidents/config/google-chat-configurations`

## Request

- Base URL: `https://api.datadoghq.com`
- URL: `https://api.datadoghq.com/api/v2/incidents/config/google-chat-configurations`
- 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: `incident_settings_write`
- TypeScript: <https://skmtc.dev/datadog/apis/datadog-api-v2-collection/docs/api/v2/incidents/config/google-chat-configurations/post.ts> (a function with typed inputs; its response is checked against the schema)

Create a Google Chat configuration for incidents.

## Request body

- IncidentGoogleChatConfigurationRequest: Request payload for creating a Google Chat configuration.
  - `data` IncidentGoogleChatConfigurationDataRequest, required: Google Chat configuration data in a create request.
    - `attributes` IncidentGoogleChatConfigurationDataAttributesRequest, required: Attributes for creating a Google Chat configuration.
      - `domain_id` string, required: The Google Chat domain ID.
      - `space_name_template` string, required: The template for the Google Chat space name.
      - `space_target_audience_id` string, required: The target audience ID for the Google Chat space.
      - `space_time_zone` string, required: The time zone for the Google Chat space.
    - `relationships` IncidentGoogleChatConfigurationRelationshipsRequest, required: Relationships for a Google Chat configuration create request.
      - `incident_type` RelationshipToIncidentType, required: Relationship to an incident type.
        - `data` RelationshipToIncidentTypeData, required: Relationship to incident type object.
          - `id` string, required: The incident type's ID.
          - `type` 'incident_types', required: Incident type resource type.
    - `type` 'google_chat_configurations', required: Google Chat configuration resource type.

## Response `201`

Created

- IncidentGoogleChatConfigurationResponse: Response with a Google Chat configuration.
  - `data` IncidentGoogleChatConfigurationDataResponse, required: Google Chat configuration data in a response.
    - `attributes` IncidentGoogleChatConfigurationDataAttributesResponse, required: Attributes of a Google Chat configuration.
      - `created_at` string, date-time, required: Timestamp when the configuration was created.
      - `domain_id` string, required: The Google Chat domain ID.
      - `modified_at` string, date-time, required: Timestamp when the configuration was last modified.
      - `space_name_template` string, required: The template for the Google Chat space name.
      - `space_target_audience_id` string, required: The target audience ID for the Google Chat space.
      - `space_time_zone` string, required: The time zone for the Google Chat space.
    - `id` string, uuid, required: The configuration identifier.
    - `relationships` IncidentGoogleChatConfigurationRelationships: Relationships for a Google Chat configuration.
      - `created_by_user` RelationshipToUser: Relationship to user.
        - `data` RelationshipToUserData, required: Relationship to user object.
          - `id` string, required: A unique identifier that represents the user.
          - `type` 'users', required: Users resource type.
      - `incident_type` RelationshipToIncidentType: Relationship to an incident type.
        - `data` RelationshipToIncidentTypeData, required: Relationship to incident type object.
          - `id` string, required: The incident type's ID.
          - `type` 'incident_types', required: Incident type resource type.
      - `last_modified_by_user` RelationshipToUser: Relationship to user.
        - `data` RelationshipToUserData, required: Relationship to user object.
          - `id` string, required: A unique identifier that represents the user.
          - `type` 'users', required: Users resource type.
    - `type` 'google_chat_configurations', required: Google Chat configuration resource type.
  - `included` IncidentUserData[]: Included related resources.
    - `attributes` IncidentUserAttributes: Attributes of user object returned by the API.
      - `email` string: Email of the user.
      - `handle` string: Handle of the user.
      - `icon` string: URL of the user's icon.
      - `name` string, nullable: Name of the user.
      - `uuid` string: UUID of the user.
    - `id` string: ID of the user.
    - `type` 'users': Users resource type.

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `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/3f70db624329?raw)