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

# Create advertiser custom parameter targeting

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

Creates a custom parameter targeting rule for the specified advertiser. Supports three modes: EXPRESSION for complex boolean expressions (e.g., '($p1==1 || $p1=="a") && ($p2>=12 && $p2<=22)'), VALUE for simple value matching, and SUBSTRING for partial string matching. When using VALUE or SUBSTRING modes, provide the operation and parameter fields. 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 |
| `customValue` | string | yes | `premium_user` | Custom targeting value — an expression, value, or substring depending on customType |
| `customType` | string | no | `VALUE` | Optional custom target type — EXPRESSION, VALUE, or SUBSTRING |
| `operation` | string | no | `EQUALS` | Optional comparison operation — EQUALS, NOT_EQUALS, CONTAINS, or NOT_CONTAINS |
| `parameter` | string | no | `segment` | Optional parameter name for the operation value |

## 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/custom/create.do' \
  --header 'X-Api-Key: YOUR_API_KEY' \
  --header 'Content-Type: application/x-www-form-urlencoded' \
  --data-urlencode 'rule=INCLUDE' \
  --data-urlencode 'customValue=premium_user' \
  --data-urlencode 'customType=VALUE' \
  --data-urlencode 'operation=EQUALS' \
  --data-urlencode 'parameter=segment'
```

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