Create a free spins campaign

Add MCP server to your AI tool

Allow AI tools and LLMs to interact with the API documentation portal through MCP.

MCP server URL

https://operator.fizzybubbly.com/mcp

Standard setup for AI tools providing an mcp.json file

mcp.json
{
  "Fizzy Bubbly Operator API MCP server": {
    "url": "https://operator.fizzybubbly.com/mcp"
  }
}

Close
POST /free-spins-campaigns/create

Headers

  • Signature string Required
  • Public-Key string Required
application/json

Body Required

  • betCount integer(int32) Required

    Minimum value is 1.

  • betLevel integer(int32)

    Zero-based index into the game's available bet values for the given currency, sorted ascending (0 = the lowest bet value). The list can be retrieved via /free-spins-campaigns/bet-values. Mutually exclusive with betValue: exactly one of betValue or betLevel must be provided. Cannot be used for games that accept any bet value.

    Minimum value is 0.

  • betValue number

    The bet value the campaign freespins are offered to the player. Mutually exclusive with betLevel: exactly one of betValue or betLevel must be provided.

  • brandId string Required

    Non blank brand ID

    Format should match the following pattern: ^(?!\s*$).+.

  • campaignId string Required

    Non blank campaign ID

    Minimum length is 1, maximum length is 40. Format should match the following pattern: ^(?!\s*$).+.

  • campaignName string Required

    Non blank campaign name

    Format should match the following pattern: ^(?!\s*$).+.

  • consumeBefore integer(int64) Required

    Unix epoch time in milliseconds. Must be in the future. Consume before is considered to be hard end date, after which the campaign should be expired. In aggregation mode a player's campaign is additionally voided 15 days after their first free spin if not consumed by then, even when consumeBefore is later.

  • currency string Required

    Non blank currency

    Format should match the following pattern: ^(?!\s*$).+.

  • gameId string Required

    Non blank game ID

    Format should match the following pattern: ^(?!\s*$).+.

  • handoverAfter integer(int64) Required

    Unix epoch time in milliseconds. Start date of the campaign. Must be in the future.

  • playerIds array[string]

    At most 3,000 player IDs per request; larger requests are rejected with 400 ERROR_BAD_REQUEST.

    At least 0 but not more than 3000 elements. Minimum length of each is 1, maximum length of each is 45. Format of each should match the following pattern: ^(?!\s*$).+.

Responses

  • 200 application/json

    Successful response

    Hide response attribute Show response attribute object
    • id string Required

      Unique ID for the created campaign

  • 400 application/json

    Request could not be processed

    Hide response attributes Show response attributes object
    • code string

      Values are ERROR_UNKNOWN_ERROR, ERROR_BAD_REQUEST, ERROR_BAD_REQUEST_PLAYER_BLOCKED, ERROR_INVALID_SESSION, ERROR_SESSION_EXPIRED, ERROR_TRANSACTION_DUPLICATE, ERROR_TRANSACTION_WITHDRAW_NOT_FOUND, ERROR_TRANSACTION_INSUFFICIENT_FUNDS, ERROR_TRANSACTION_LIMIT_EXCEEDED, ERROR_TRANSACTION_REALITY_CHECK, ERROR_TRANSACTION_NOT_FOUND, ERROR_ROLLBACK_TRANSACTION_NOT_FOUND, ERROR_GAME_NOT_ACTIVE, or ERROR_BRAND_NOT_ACTIVE.

    • description string

      Message describing the error

    • traceId string

      Internal ID to trace the request when debugging

  • 401 application/json

    Request public key or signature is missing or invalid

    Hide response attributes Show response attributes object
    • code string

      Value is ERROR_INVALID_SIGNATURE.

    • description string

      Message describing the error

    • traceId string

      Internal ID to trace the request when debugging

  • 429 application/json

    Request rate for the operator or brand is over the allowed limit, retry after a short delay

    Hide response attributes Show response attributes object
    • code string

      Value is ERROR_RATE_LIMIT_EXCEEDED.

    • description string

      Message describing the error

    • traceId string

      Internal ID to trace the request when debugging

  • 500 application/json

    Internal error / Unknown error

    Hide response attributes Show response attributes object
    • code string

      Values are ERROR_UNKNOWN_ERROR or ERROR_TIMEOUT.

    • description string

      Message describing the error

    • traceId string

      Internal ID to trace the request when debugging

POST /free-spins-campaigns/create
curl \
 --request POST 'BASE_URL/free-spins-campaigns/create' \
 --header "Content-Type: application/json" \
 --header "Signature: string" \
 --header "Public-Key: string" \
 --data '{
  "betCount": 42,
  "betLevel": 0,
  "betValue": 42.0,
  "brandId": "string",
  "campaignId": "string",
  "campaignName": "string",
  "consumeBefore": 641779201000,
  "currency": "string",
  "gameId": "string",
  "handoverAfter": 641779201000,
  "playerIds": [
    "string"
  ]
}'
Request examples
# Headers
Signature: string
Public-Key: string

# Payload
{
  "betCount": 42,
  "betLevel": 0,
  "betValue": 42.0,
  "brandId": "string",
  "campaignId": "string",
  "campaignName": "string",
  "consumeBefore": 641779201000,
  "currency": "string",
  "gameId": "string",
  "handoverAfter": 641779201000,
  "playerIds": [
    "string"
  ]
}
Response examples (200)
{
  "id": "string"
}
Response examples (400)
{
  "code": "ERROR_UNKNOWN_ERROR",
  "description": "string",
  "traceId": "string"
}
Response examples (401)
{
  "code": "ERROR_INVALID_SIGNATURE",
  "description": "string",
  "traceId": "string"
}
Response examples (429)
{
  "code": "ERROR_RATE_LIMIT_EXCEEDED",
  "description": "string",
  "traceId": "string"
}
Response examples (500)
{
  "code": "ERROR_UNKNOWN_ERROR",
  "description": "string",
  "traceId": "string"
}