---
title: "Add a custom parameter"
type: reference
method: POST
path: /rest-api/custom-parameters.do
tag: "Custom Parameters"
---

# Add a custom parameter

`POST https://YOUR-NETWORK-DOMAIN/rest-api/custom-parameters.do`

Registers a parameter the ad tags send. name is needed. Invalid values come back per field in errors; fields that were sent but not applied are listed in 'ignoredFields'. Ad serving reads the change within a minute. Requires the CUSTOM_PARAMETERS admin permission (Admin → Targeting presets → Custom parameters).

## Body

A JSON body. An example, built from the field definitions:

```json
{
  "name": "genre",
  "label": "Content genre",
  "description": "Genre of the page, from the publisher's CMS",
  "valueMode": "STATIC"
}
```

## Responses

- `200` — {parameter, ignoredFields}
- `400` — Invalid body, each problem named in errors by field
- `401` — Authentication error
- `403` — Insufficient permissions, naming the missing one
- `409` — A parameter with this name already exists

## Example request

```bash
curl --request POST \
  --url 'https://YOUR-NETWORK-DOMAIN/rest-api/custom-parameters.do' \
  --header 'X-Api-Key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
  "name": "genre",
  "label": "Content genre",
  "description": "Genre of the page, from the publisher'\''s CMS",
  "valueMode": "STATIC"
}'
```

Source: https://epom.com/ad-server/docs/api/custom-parameters/post-custom-parameters