---
title: "Create Free Rounds"
method: POST
path: "/free-rounds"
tags: ["Free Rounds"]
---

# Create Free Rounds

`POST /free-rounds`

Create new free rounds campaign

## Headers

- `X-REQUEST-SIGN` string, required

## Request body

- CreateFreeRoundsRequest
  - `external_id` string, required — Free rounds ID (external). Used as idempotency key. Same ID can be used to create free rounds only once.
  - `cid` string, uuid, required — Client's ID (internal)
  - `external_cid` string, required — External Client's ID (game aggregator or casino)
  - `game_id` string, required — Game's ID
  - `provider_id` string, required — Provider ID. If you're using `Playhub Integration Adapter` pass `playhub` here.
  - `user_ids` string[] — List of player IDs (external). if null then campaign is available for all players.
  - `currency` string, required — Currency code in ISO4217
  - `quantity` integer, required — Number of free rounds.
  - `bet_line` integer, required — Number of bet line configured for this game/provider.
  - `valid_from` string, date-time, required — Start date when free rounds become available. ISO 8601. This should be in future. It's not possible to create Free Rounds campaign in the past. If you want to create a campaign "from now", just add a few seconds to the current time. Creation process is synchronous, so make sure that under heavy load our server could process this request for a few seconds.
  - `valid_until` string, date-time — End date when free rounds become unavailable. Could be setup later. ISO 8601.

## Response `200`

ok

- CreateFreeRoundsResponse
  - `id` string, uuid, required — Free rounds ID (internal)
  - `external_id` string, required — Free rounds ID (external). This is provided in the request.

## Other responses

- `401` — Wrong signature or API key
- `409` — Free rounds campaign already exists
- `500` — Server error occurred

---

[API](https://skmtc.dev/fastplaynetwork/apis/playhub-core-api.md) · [All operations](https://skmtc.dev/fastplaynetwork/apis/playhub-core-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/fastplaynetwork/playhub-core-api/revisions/2cfd86cc6d48/schema)