---
title: "Change a fee plan's rates, or add a plan"
type: reference
method: POST
path: /rest-api/ad-server-fees/plans.do
tag: "Ad Server Fees"
---

# Change a fee plan's rates, or add a plan

`POST https://YOUR-NETWORK-DOMAIN/rest-api/ad-server-fees/plans.do`

With id, changes only the rates the call names on that plan and leaves every other one as it is. Without id, adds a plan - name is required then, and the new plan is never the one the network runs on: moving the network onto it is its own change (activePlanId on ad-server-fees.do). Every value is checked the way the console's form checks it, and a call that breaks a rule changes nothing at all. A rate the network's pricing type does not charge against is stored and named under notCharged, so it is clear it will not reach a bill while the network bills that way. Changing the plan the network is on changes what it pays from the next time the month's charges are refreshed. Requires the Ad Server Fees Management console permission.

## Form params

| Name | Type | Required | Example | Description |
|---|---|---|---|---|
| `id` | integer | no | `3` | The plan to change; leave it out to add a plan |
| `name` | string | no | `Standard` | What the plan is called, up to 128 characters |
| `planPrice` | number | no | `500` | What the plan costs a month, before any overage |
| `globalImpressions` | integer | no | `50000000` | Impressions of every kind the plan includes; charged under GLOBAL pricing |
| `desktopImpressions` | integer | no | `30000000` | Desktop impressions the plan includes; charged under SPLIT pricing |
| `mobileImpressions` | integer | no | `20000000` | Mobile impressions the plan includes; charged under SPLIT pricing |
| `videoImpressions` | integer | no | `5000000` | Video impressions the plan includes; charged under SPLIT pricing |
| `trafficAmountInGb` | integer | no | `1000` | Traffic the plan includes, in GB |
| `globalImpressionOverageCpm` | number | no | `0.02` | Charged per thousand impressions of any kind beyond what the plan includes |
| `desktopImpressionOverageCpm` | number | no | `0.02` | Charged per thousand desktop impressions beyond what the plan includes |
| `mobileImpressionOverageCpm` | number | no | `0.03` | Charged per thousand mobile impressions beyond what the plan includes |
| `videoImpressionOverageCpm` | number | no | `0.05` | Charged per thousand video impressions beyond what the plan includes |
| `trafficOveragePricePerGb` | number | no | `0.1` | Charged per GB of traffic beyond what the plan includes |
| `premiumAccount` | boolean | no | `false` | Whether the plan is a premium account |
| `premiumAccountPrice` | number | no | `100` | What a premium account adds to the monthly price |
| `flexiblePrice` | boolean | no | `false` | Charge every impression at the prices below instead of only the ones beyond the plan |
| `globalImpressionPriceCpm` | number | no | `0.01` | With flexible pricing: charged per thousand impressions of any kind |
| `desktopImpressionPriceCpm` | number | no | `0.01` | With flexible pricing: charged per thousand desktop impressions |
| `mobileImpressionPriceCpm` | number | no | `0.02` | With flexible pricing: charged per thousand mobile impressions |
| `videoImpressionPriceCpm` | number | no | `0.04` | With flexible pricing: charged per thousand video impressions |
| `hbFillsAsImpressions` | boolean | no | `true` | Count a header-bidding fill won by other demand as an impression, at this plan's rates |
| `hbFillPriceCpm` | number | no | `0.01` | What a header-bidding fill costs per thousand when it is not counted as an impression |
| `autoSwitchForwardBillingPlanId` | string | no | `4` | Plan to move up to when this one is outgrown; empty to clear |
| `autoSwitchBackwardBillingPlanId` | string | no | `2` | Plan to fall back to when this one is not used up; empty to clear |
| `aiEpomKeyEnabled` | boolean | no | `true` | Let this network run the AI assistant on the ad server's own key, billed |
| `aiPriceMultiplier` | string | no | `2` | Billed AI cost is the list price times this, 1-100; empty for the platform default |
| `aiPromoUntil` | string | no | `2026-12-31` | Last day (UTC) on which AI assistant calls cost the network nothing, yyyy-MM-dd; empty for no promo |
| `aiPromoAllowanceUsd` | string | no | `100` | What the promo waives for the whole network, in USD; empty for the platform default |

## Responses

- `200` — {success, id, created, changed:[...], notCharged:{...}, plan:{...}}
- `400` — A value the console's form would refuse, naming the field; or no field named
- `401` — Authentication error
- `403` — The caller does not hold AD_SERVER_FEES_MANAGEMENT
- `404` — No plan with that id

## Example request

```bash
curl --request POST \
  --url 'https://YOUR-NETWORK-DOMAIN/rest-api/ad-server-fees/plans.do' \
  --header 'X-Api-Key: YOUR_API_KEY' \
  --header 'Content-Type: application/x-www-form-urlencoded' \
  --data-urlencode 'id=3' \
  --data-urlencode 'name=Standard' \
  --data-urlencode 'planPrice=500' \
  --data-urlencode 'globalImpressions=50000000'
```

Source: https://epom.com/ad-server/docs/api/ad-server-fees/post-ad-server-fees-plans