# Create Placement

<mark style="color:green;">`POST`</mark> `/placement`

Use this method to create a new placement.

#### **Headers**

| Name          | Value           |
| ------------- | --------------- |
| Authorization | `Basic <token>` |

#### **Body**

```typescript
{
  name: string, // Name must only contain alphabets, numeric and space
  is_archived?: boolean,
  account: {
    id: number, // Mandatory, accountId (looks like 1234)
    name?: string,
  },
  tag_id: {     // Default tagId
    id: string, // Mandatory, tagId (looks like '0bonobfw')
    name?: string,
  },
  mappings?: [  // Array of targeted elements
    {
      id?: number, // Optional, for updating existing mappings
      tag_id: {
        id: string, // Mandatory, tagId (looks like '0bonobfw')
        name?: string,
      },
      mapping: {
        adunit_code?: string[],
        bundle?: string[],
        country?: string[], // Array of country codes (e.g. 'FR', 'US')
        device?: string[], // desktop | mobile | tablet | tv | other
        domain?: string[], // Must be in this format 'domain.com'
        gam_ad_unit_path?: string[], // GAM ad unit path
        gpid?: string[], // Supports wildcard prefix matching with '*' (e.g. '/5144/desktop/vip/*')
        mediatype?: string[], // audio | banner | native | video
        size?: { w: number, h: number }[], // Array of sizes
      },
      placement?: {
        id: number, // Optional, link to existing placement
        name?: string,
      },
    }
  ]
}

```

#### **Response**

{% tabs %}
{% tab title="200 : OK Placement created" %}
{% code fullWidth="false" %}

```json
{
  "id": number,
  "external_id": string,
  "name": string,
  "is_archived": boolean,
  "tag_id": {
    "id": string,
    "name": string
  },
  "account": {
    "id": number,
    "name": string
  },
  "mappings": [
    {
      "id": number,
      "tag_id": {
        "id": string,
        "name": string
      },
      "mapping": {
        "adunit_code": string[],
        "bundle": string[],
        "country": string[],
        "device": string[],
        "domain": string[],
        "gam_ad_unit_path": string[],
        "gpid": string[],
        "mediatype": string[],
        "size": { "w": number, "h": number }[]
      },
      "placement": {
        "id": number,
        "name": string
      }
    }
  ]
}

```

{% endcode %}
{% endtab %}

{% tab title="400 : Bad request no account ID provided" %}

```json
{
  "missingProperty": "account_id"
}
```

{% endtab %}
{% endtabs %}