---
title: "Create advertiser device format targeting"
type: reference
method: POST
path: /rest-api/advertiser/{advertiserId}/targeting/device-format/create.do
tag: "Targeting Rules"
---

# Create advertiser device format targeting

`POST https://YOUR-NETWORK-DOMAIN/rest-api/advertiser/{advertiserId}/targeting/device-format/create.do`

Creates a device format targeting rule for the specified advertiser. The rule filters ad requests based on the form factor of the user's device, such as DESKTOP, MOBILE, or TABLET. Use the device format values endpoint to retrieve all available options. Requires UPDATE permission on the advertiser and MANAGE_DEMAND_TARGETING user permission.

## Path params

| Name | Type | Required | Example | Description |
|---|---|---|---|---|
| `advertiserId` | integer | yes | `1234` | Unique numeric ID of the advertiser |

## Form params

| Name | Type | Required | Example | Description |
|---|---|---|---|---|
| `rule` | string | yes | `INCLUDE` | Targeting rule type — INCLUDE for whitelist or EXCLUDE for blacklist |
| `deviceFormat` | string | yes | `MOBILE` | Device format enum value (e.g., DESKTOP, MOBILE, TABLET) |

## Responses

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

## Example request

```bash
curl --request POST \
  --url 'https://YOUR-NETWORK-DOMAIN/rest-api/advertiser/1234/targeting/device-format/create.do' \
  --header 'X-Api-Key: YOUR_API_KEY' \
  --header 'Content-Type: application/x-www-form-urlencoded' \
  --data-urlencode 'rule=INCLUDE' \
  --data-urlencode 'deviceFormat=MOBILE'
```

Source: https://epom.com/ad-server/docs/api/targeting-rules/post-advertiser-targeting-device-format-create