---
title: "Create or update the Datadog integration"
method: PUT
path: "/api/v4/groups/{id}/integrations/datadog"
tags: ["integrations"]
---

# Create or update the Datadog integration

`PUT /api/v4/groups/{id}/integrations/datadog`

## Request

- Base URL: `https://gitlab.com`
- URL: `https://gitlab.com/api/v4/groups/{id}/integrations/datadog`
- Auth: none declared

Creates or updates the Datadog integration.

## Path parameters

- `id` integer, required

## Request body

- PutApiV4GroupsIdIntegrationsDatadog: Create or update the Datadog integration
  - `datadog_site` string: Datadog site to send data to. Learn more about Datadog sites in the <a target="_blank" rel="noopener noreferrer" href="https://docs.datadoghq.com/getting_started/site/">documentation</a>.
  - `api_url` string: Full URL of your Datadog site. Only required if you do not use a standard Datadog site.
  - `api_key` string, required: <a target="_blank" rel="noopener noreferrer" href="https://docs.datadoghq.com/account_management/api-app-keys/">API key</a> used for authentication with Datadog.
  - `datadog_ci_visibility` boolean: Enable CI Visibility
  - `archive_trace_events` boolean: When enabled, job logs are collected by Datadog and displayed along with pipeline execution traces.
  - `datadog_service` string: Tag all pipeline data from this GitLab instance in Datadog. Can be used when managing several self-managed deployments.
  - `datadog_env` string: For self-managed deployments, `env` tag for all the data sent to Datadog.
  - `datadog_tags` string: Custom tags in Datadog. Specify one tag per line in the format `key:value\nkey2:value2`.
  - `pipeline_events` boolean: Trigger event when a pipeline status changes.
  - `build_events` boolean: Trigger event when a build is created.
  - `push_events` boolean: Trigger event for pushes to the repository.
  - `merge_requests_events` boolean: Trigger event when a merge request is created, updated, or merged.
  - `note_events` boolean: Trigger event for new comments.
  - `tag_push_events` boolean: Trigger event for new tags pushed to the repository.
  - `subgroup_events` boolean
  - `project_events` boolean
  - `use_inherited_settings` boolean: Indicates whether to inherit the default settings. Defaults to `false`.

## Response `200`

Create or update the Datadog integration

- APIEntitiesIntegrationBasic: API_Entities_IntegrationBasic model
  - `id` integer, required
  - `title` string, required
  - `slug` string, required
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required
  - `active` boolean, required
  - `commit_events` boolean, required
  - `push_events` boolean, required
  - `issues_events` boolean, required
  - `incident_events` boolean, required
  - `alert_events` boolean, required
  - `confidential_issues_events` boolean, required
  - `merge_requests_events` boolean, required
  - `tag_push_events` boolean, required
  - `deployment_events` boolean, required
  - `note_events` boolean, required
  - `confidential_note_events` boolean, required
  - `pipeline_events` boolean, required
  - `wiki_page_events` boolean, required
  - `job_events` boolean, required
  - `comment_on_event_enabled` boolean, required
  - `inherited` boolean, required
  - `vulnerability_events` boolean, required

## Other responses

- `400`: Bad request
- `401`: Unauthorized
- `404`: Not found
- `422`: Unprocessable entity

---

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