---
title: "Update banner pricing"
type: reference
method: POST
path: /rest-api/banner/{bannerId}/pricing.do
tag: "Banners"
---

# Update banner pricing

`POST https://YOUR-NETWORK-DOMAIN/rest-api/banner/{bannerId}/pricing.do`

Creates or updates the pricing configuration for the specified banner. Accepts price (double, 0 to 1000000), pricingType (CPM, CPC, or CPA), paymentModel (REVENUE_SHARE or FIXED_PRICE) and useGlobalActionPricing as form parameters. Only the fields sent are changed; the rest keep their stored values (an empty price clears the banner's own price). If no pricing record exists for this banner, a new one is created with FIXED_PRICE, CPM and no price for whatever is not sent. Requires UPDATE permission on the banner's advertiser and MANAGE_PRICING permission, and setting a pricing type (including the CPM of a new record) requires that type's permission, e.g. CPM_PRICING_TYPE.

## Path params

| Name | Type | Required | Example | Description |
|---|---|---|---|---|
| `bannerId` | integer | yes | `3001` | ID of the banner to update pricing for |

## Form params

| Name | Type | Required | Example | Description |
|---|---|---|---|---|
| `paymentModel` | string | no | `FIXED_PRICE` | Payment model (FIXED_PRICE, REVENUE_SHARE) |
| `price` | number | no | `2.50` | Price value in the selected pricing type; null when no global price is set |
| `pricingType` | string | no | `CPM` | Pricing type (CPM, CPC, CPA, COST_PER_DAY, COST_PER_MONTH) |
| `useGlobalActionPricing` | boolean | no | `true` | Whether to use global action pricing from the action definition |

## Responses

- `200` — Banner pricing updated
- `400` — Invalid request, e.g. a price out of range, naming the field
- `401` — Authentication error
- `403` — Not enough permissions
- `404` — Banner not found

## Example request

```bash
curl --request POST \
  --url 'https://YOUR-NETWORK-DOMAIN/rest-api/banner/3001/pricing.do' \
  --header 'X-Api-Key: YOUR_API_KEY' \
  --header 'Content-Type: application/x-www-form-urlencoded' \
  --data-urlencode 'paymentModel=FIXED_PRICE' \
  --data-urlencode 'price=2.50' \
  --data-urlencode 'pricingType=CPM'
```

Source: https://epom.com/ad-server/docs/api/banners/post-banner-pricing