---
title: "Create traffic modifier"
method: POST
path: "/forecaster/modifiers/traffic"
tags: ["Traffic Modifiers"]
---

# Create traffic modifier

`POST /forecaster/modifiers/traffic`

## Request

- Base URL: `https://api.kevel.co/v1`
- URL: `https://api.kevel.co/v1/forecaster/modifiers/traffic`
- Auth: API key in header `X-Adzerk-ApiKey`

Create a Forecast Traffic Modifier

## Request body

- object: A traffic modifier that multiplies the targeted Ad Requests by a constant amount. If this Traffic Modifier is active during a forecast, a `MODTRF` warning will be triggered.
  - `Id` string, required: Unique identifier of the Traffic Modifier.
  - `StartDate` string, date-time, required: Start date for the traffic modifier, as `yyyy-mm-dd'T'HH:mm:SS` or `yyyy-mm-dd` (default time of `00:00:00`).
  - `EndDate` string, date-time, required: End date for the traffic modifier, as `yyyy-mm-dd'T'HH:mm:SS` or `yyyy-mm-dd` (default time of `23:59:59`).
  - `TimeZone` string: The time zone of the modifier's start and end dates ([available time zones](https://www.joda.org/joda-time/timezones.html)). Additionally, the rule is evaluated in the modifier's time zone, i.e. if the modifier is set to "EST" a rule like `$datetime.hour > 10` assumes that the given hour is in "EST".
  - `Rule` string: The rule used to filter the Ad Requests (Zerkel query). The traffic modifier will only be applied to Ad Requests who conform to this rule.
  - `Type` 'adRequestMultiplier', required
  - `Multiplier` number, required: How many times to multiply traffic in the range.

## Response `200`

The JSON object of the traffic modifier that was created successfully.

- union
  - 0 (unresolved $ref)
  - 1 (unresolved $ref)
  - 2 (unresolved $ref)

## Other responses

- `400`: The entity in the body is invalid.

---

[API](https://skmtc.dev/kevel/apis/forecast-api.md) - [All operations](https://skmtc.dev/kevel/apis/forecast-api/llms.txt) - [OpenAPI document](https://skmtc.dev/kevel/apis/forecast-api/revisions/f07c8784a32d?raw)