---
title: "Add logged custom parameter or cookie names"
type: reference
method: POST
path: /rest-api/analytics-configuration/request-filters/add.do
tag: "Analytics"
---

# Add logged custom parameter or cookie names

`POST https://YOUR-NETWORK-DOMAIN/rest-api/analytics-configuration/request-filters/add.do`

Adds names to one kind's list - the console's Analytics configuration page, which adds them one at a time. 'names' takes one name or several, comma-separated, each at most 128 characters; blanks are ignored and a name already on the list is reported under 'alreadyPresent' rather than stored twice, so the call can be repeated. Each kind's list is read one of two ways, and the answer says which under 'mode': INCLUDE, the default - only these names are logged - or EXCLUDE, where these are the names left out and everything else is logged. The switch is the *Blacklist* toggle on the console's Analytics configuration page (stored as the analyticsCustomParametersFilteringExclude / analyticsCookieNamesFilteringExclude network preference) and is not changed here, so read it before adding a name: in EXCLUDE mode a name you add stops being logged. While a kind's filtering is switched off in the ad-server configuration the list has no effect at all. The answer is the kind's whole list after the add, so it can be confirmed. Requires the ANALYTICS_CONFIGURATION admin permission (Admin -> Analytics configuration).

## Form params

| Name | Type | Required | Example | Description |
|---|---|---|---|---|
| `names` | array<string> | yes | `utm_source` | The names, comma-separated or repeated; each at most 128 characters, blanks ignored |
| `type` | string | yes | `CUSTOM_PARAMETER` | CUSTOM_PARAMETER or COOKIE_NAME |

## Responses

- `200` — {success, type, mode, added, alreadyPresent, total, names}
- `400` — 'names' is empty, names more than 200 at once, or holds one over 128 characters; 'type' names no filter kind
- `401` — Authentication error
- `403` — Without the ANALYTICS_CONFIGURATION admin permission

## Example request

```bash
curl --request POST \
  --url 'https://YOUR-NETWORK-DOMAIN/rest-api/analytics-configuration/request-filters/add.do' \
  --header 'X-Api-Key: YOUR_API_KEY' \
  --header 'Content-Type: application/x-www-form-urlencoded' \
  --data-urlencode 'names=utm_source' \
  --data-urlencode 'type=CUSTOM_PARAMETER'
```

Source: https://epom.com/ad-server/docs/api/analytics/post-analytics-configuration-request-filters-add