---
title: "Add a default invocation-code parameter"
type: reference
method: POST
path: /rest-api/placements/{placementId}/default-invocation-params.do
tag: "Placements"
---

# Add a default invocation-code parameter

`POST https://YOUR-NETWORK-DOMAIN/rest-api/placements/{placementId}/default-invocation-params.do`

Adds a parameter every invocation code of the placement carries by default. A multi-valued type (CUSTOM_PARAMETER) gains the value, any other type has its value replaced. A custom parameter must be written as name=value. Requires UPDATE access to the placement's site.

## Path params

| Name | Type | Required | Example | Description |
|---|---|---|---|---|
| `placementId` | integer | yes | `4001` | Placement ID |

## Form params

| Name | Type | Required | Example | Description |
|---|---|---|---|---|
| `type` | string | yes | `CHANNEL` | Parameter type, from GET /rest-api/placements/default-invocation-param-types |
| `value` | string | no | `sports` | Parameter value; name=value for CUSTOM_PARAMETER |

## Responses

- `200` — {success, data:[{type, value}]} — the placement's parameters after the change
- `400` — Unknown type, or a custom parameter not in name=value form
- `401` — Authentication error
- `403` — No UPDATE access to the site
- `404` — Placement, its zone or its site not found or deleted

## Example request

```bash
curl --request POST \
  --url 'https://YOUR-NETWORK-DOMAIN/rest-api/placements/4001/default-invocation-params.do' \
  --header 'X-Api-Key: YOUR_API_KEY' \
  --header 'Content-Type: application/x-www-form-urlencoded' \
  --data-urlencode 'type=CHANNEL' \
  --data-urlencode 'value=sports'
```

Source: https://epom.com/ad-server/docs/api/placements/post-placements-default-invocation-params