# Create mapping

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

Use this method to create a new mapping.

#### **Headers**

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

#### **Body**

```typescript
{
  placement: {
    id: number, // Mandatory, placementId (looks like 1723)
    name?: string,
  },
  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
  }
}

```

#### **Response**

{% tabs %}
{% tab title="200 : OK Mapping added" %}
{% code fullWidth="false" %}

```json
{
  "id": number,
  "placement": {
      "id": number,
      "name": string
  },
  "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 }[]
  }
}

```

{% endcode %}
{% endtab %}

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

```json
{
  "missingProperty": "placement_id"
}
```

{% endtab %}
{% endtabs %}