---
title: "Create a web integration account"
method: POST
path: "/api/v2/web-integrations/{integration_name}/accounts"
tags: ["Web Integrations"]
---

# Create a web integration account

`POST /api/v2/web-integrations/{integration_name}/accounts`

## Request

- Base URL: `https://api.datadoghq.com`
- URL: `https://api.datadoghq.com/api/v2/web-integrations/{integration_name}/accounts`
- Auth: API key in header `DD-API-KEY` and API key in header `DD-APPLICATION-KEY`

Create a new account for a given web integration.

## Path parameters

- `integration_name` string, required

## Request body

- WebIntegrationAccountCreateRequest: Payload schema when adding a web integration account.
  - `data` WebIntegrationAccountCreateRequestData, required: Data object for creating a web integration account.
    - `attributes` WebIntegrationAccountCreateRequestAttributes, required: Attributes object for creating a web integration account.
      - `name` string, required: A human-readable name for the account. Must be unique among accounts of the same integration.
      - `secrets` WebIntegrationAccountSecrets, required: Integration-specific secrets. The shape of this object varies by integration. Secrets are write-only and never returned by the API.
      - `settings` WebIntegrationAccountSettings, required: Integration-specific settings. The shape of this object varies by integration.
    - `type` 'Account', required: Account resource type.

## Response `201`

CREATED

- WebIntegrationAccountResponse: The expected response schema when getting a single web integration account.
  - `data` WebIntegrationAccountResponseData: Data object of a web integration account.
    - `attributes` WebIntegrationAccountResponseAttributes, required: Attributes object of a web integration account. Secrets are never returned.
      - `name` string, required: A human-readable name for the account.
      - `settings` WebIntegrationAccountSettings: Integration-specific settings. The shape of this object varies by integration.
    - `id` string, required: The unique identifier of the web integration account.
    - `type` 'Account', required: Account resource type.

## Other responses

- `400`: Bad Request
- `403`: Forbidden
- `404`: Not Found
- `422`: The server cannot process the request because it contains invalid data.
- `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)