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

# Create advertiser IP range targeting

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

Creates an IP range targeting rule for the specified advertiser and enables targeting if it was previously disabled. Both IPv4 and IPv6 addresses are supported. The ipFrom must be less than or equal to ipTo. Returns the created targeting rule as JSON. Requires IP_RANGE targeting permission and UPDATE permission on the advertiser.

## 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 or EXCLUDE |
| `ipFrom` | string | yes | `192.168.1.0` | Start of the IP range (e.g., '194.222.012.001' for IPv4 or '2001:0db8:85a3:0000:0000:8a2e:0370:7334' for IPv6) |
| `ipTo` | string | yes | `192.168.1.255` | End of the IP range (must be greater than or equal to ipFrom) |

## Responses

- `200` — Success
- `400` — Invalid IP range or ipFrom exceeds ipTo
- `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/ip-range/create.do' \
  --header 'X-Api-Key: YOUR_API_KEY' \
  --header 'Content-Type: application/x-www-form-urlencoded' \
  --data-urlencode 'rule=INCLUDE' \
  --data-urlencode 'ipFrom=192.168.1.0' \
  --data-urlencode 'ipTo=192.168.1.255'
```

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