---
title: "POST /v2/{+parent}/adunits"
method: POST
path: "/v2/{+parent}/adunits"
tags: ["accounts"]
---

# POST /v2/{+parent}/adunits

`POST /v2/{+parent}/adunits`

Creates an ad unit. This method can be called only by a restricted set of projects, which are usually owned by [AdSense for Platforms](https://developers.google.com/adsense/platforms/) publishers. Contact your account manager if you need to use this method. Note that ad units can only be created for ad clients with an "AFC" product code. For more info see the [AdClient resource](/adsense/management/reference/rest/v2/accounts.adclients). For now, this method can only be used to create `DISPLAY` ad units. See: https://support.google.com/adsense/answer/9183566

## Path parameters

- `parent` string, required

## Request body

- AdUnit — Representation of an ad unit. An ad unit represents a saved ad unit with a specific set of ad settings that have been customized within an account.
  - `reportingDimensionId` string — Output only. Unique ID of the ad unit as used in the `AD_UNIT_ID` reporting dimension.
  - `displayName` string — Required. Display name of the ad unit, as provided when the ad unit was created.
  - `state` 'STATE_UNSPECIFIED' | 'ACTIVE' | 'ARCHIVED' — Required. State of the ad unit.
  - `contentAdsSettings` ContentAdsSettings — Settings specific to content ads (AFC).
    - `type` 'TYPE_UNSPECIFIED' | 'DISPLAY' | 'FEED' | 'ARTICLE' | 'MATCHED_CONTENT' | 'LINK' — Required. Type of the ad unit.
    - `size` string — Required. Size of the ad unit. e.g. "728x90", "1x3" (for responsive ad units).
  - `name` string — Output only. Resource name of the ad unit. Format: accounts/{account}/adclients/{adclient}/adunits/{adunit}

## Response `200`

Successful response

---

[API](https://skmtc.net/google/apis/adsense.md) · [All operations](https://skmtc.net/google/apis/adsense/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/google/adsense/versions/89e10b361ad0/schema)