---
title: "Create site screen resolution targeting"
type: reference
method: POST
path: /rest-api/site/{siteId}/targeting/screen-resolution/create.do
tag: "Targeting Rules"
---

# Create site screen resolution targeting

`POST https://YOUR-NETWORK-DOMAIN/rest-api/site/{siteId}/targeting/screen-resolution/create.do`

Creates a screen resolution targeting rule for the specified site. The rule matches requests from devices whose screen resolution meets the specified width and height criteria combined with the given comparison operator. For example, use GREATER_EQUAL with 1920x1080 to target full HD and above. Returns the created targeting rule on success. Requires RESOLUTION targeting permission.

## Path params

| Name | Type | Required | Example | Description |
|---|---|---|---|---|
| `siteId` | integer | yes | `3001` | Unique numeric ID of the site |

## Form params

| Name | Type | Required | Example | Description |
|---|---|---|---|---|
| `rule` | string | yes | `INCLUDE` | Targeting rule type — INCLUDE for whitelist or EXCLUDE for blacklist |
| `relation` | string | yes | `GREATER_EQUAL` | Comparison operator — LOWER, GREATER, LOWER_EQUAL, GREATER_EQUAL, or EQUAL |
| `screenWidth` | integer | yes | `1920` | Screen width in pixels to target |
| `screenHeight` | integer | yes | `1080` | Screen height in pixels to target |

## Responses

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

## Example request

```bash
curl --request POST \
  --url 'https://YOUR-NETWORK-DOMAIN/rest-api/site/3001/targeting/screen-resolution/create.do' \
  --header 'X-Api-Key: YOUR_API_KEY' \
  --header 'Content-Type: application/x-www-form-urlencoded' \
  --data-urlencode 'rule=INCLUDE' \
  --data-urlencode 'relation=GREATER_EQUAL' \
  --data-urlencode 'screenWidth=1920' \
  --data-urlencode 'screenHeight=1080'
```

Source: https://epom.com/ad-server/docs/api/targeting-rules/post-site-targeting-screen-resolution-create