---
title: "Create placement device release year targeting"
type: reference
method: POST
path: /rest-api/placement/{placementId}/targeting/device-release-year/create.do
tag: "Targeting Rules"
---

# Create placement device release year targeting

`POST https://YOUR-NETWORK-DOMAIN/rest-api/placement/{placementId}/targeting/device-release-year/create.do`

Creates a device release year targeting rule for the specified placement. Targets viewers based on the manufacturing year of their device. Use the relation parameter to specify comparison logic (e.g., GREATER for devices newer than the given year). Returns an error if a valid target value cannot be built from the parameters. Requires UPDATE permission on the placement and MANAGE_SUPPLY_PRE_TARGETING user permission.

## Path params

| Name | Type | Required | Example | Description |
|---|---|---|---|---|
| `placementId` | integer | yes | `4001` | Unique numeric ID of the placement |

## Form params

| Name | Type | Required | Example | Description |
|---|---|---|---|---|
| `rule` | string | yes | `INCLUDE` | Targeting rule type — INCLUDE for whitelist or EXCLUDE for blacklist |
| `deviceReleaseYear` | integer | yes | `2020` | Device release year to target (e.g., 2020) |
| `relation` | string | yes | `GREATER_EQUAL` | Comparison relation — LOWER, GREATER, LOWER_EQUAL, GREATER_EQUAL or EQUAL |

## Responses

- `200` — Success
- `400` — Invalid targeting value
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Placement not found
- `500` — Internal server error

## Example request

```bash
curl --request POST \
  --url 'https://YOUR-NETWORK-DOMAIN/rest-api/placement/4001/targeting/device-release-year/create.do' \
  --header 'X-Api-Key: YOUR_API_KEY' \
  --header 'Content-Type: application/x-www-form-urlencoded' \
  --data-urlencode 'rule=INCLUDE' \
  --data-urlencode 'deviceReleaseYear=2020' \
  --data-urlencode 'relation=GREATER_EQUAL'
```

Source: https://epom.com/ad-server/docs/api/targeting-rules/post-placement-targeting-device-release-year-create