---
title: "Store player"
method: POST
path: "/1/radios/{radio_product_id}/players"
tags: ["Players"]
---

# Store player

`POST /1/radios/{radio_product_id}/players`

This endpoint allows you to store a player.

## Path parameters

- `radio_product_id` integer, required

## Request body

- object
  - `background_color` string — Specify the background color used in the player
  - `button_color` string — Specify the button color used in the player
  - `display_name` string, required — Specify the name uses to display in the player
  - `domains` string — Specify the domains allow accessing to the player
  - `facebook_link` string — Specify the Facebook link used in Facebook embed
  - `height` string — Specify the height in px for display the player
  - `history_display` 'none' | 'overlay' | 'split' | 'under' — Specify the history display used in the player
  - `history_hold` integer — Specify if the maximum number of song displayed in history
  - `is_auto_start` boolean — Specify if the auto start is enabled
  - `is_cover` boolean — Specify if the cover will be displayed
  - `is_direct_control` boolean — Is the player in direct control mode ?
  - `is_embed` boolean — Specify if the embed url will be displayed int the player
  - `is_facebook_embed` boolean — Specify if the Facebook embed url will be displayed int the player
  - `is_history_clickable` boolean — Specify if the history could be clickable in history
  - `is_history_time_display` boolean — Specify if the time will be displayed in history
  - `is_hls_buffered` boolean — Specify if the player start at the beginning and buffer hls streams
  - `is_listeners` boolean — Specify if listeners information is displayed
  - `is_listeners_hold` boolean — Specify if listeners hold is used
  - `is_logo` boolean — Specify if the logo Infomaniak is displayed
  - `is_metadata_display` boolean — Specify if the metadata title and artist will be visible
  - `is_spectrum` boolean — Specify if the spectrum will be displayed
  - `is_station_thumbnail` boolean — Specify if the station thumbnail will be displayed
  - `is_twitter_embed` boolean — Specify if the Twitter embed url will be displayed int the player
  - `language` 'de' | 'en' | 'es' | 'fr' | 'it' — Specify the language used in the player
  - `listeners_hold` integer — Specify listeners hold for listeners information
  - `name` string, required — Specify the name of the player, it is not used in the player
  - `secondary_color` string — Specify the secondary color used in the player
  - `stations` object[], required — Specify the list of stations used in the super player
    - `id` integer — Specify the id of the station
    - `is_main` boolean — Specify if the station is the main station to listen
    - `order` integer — Specify the order of the station in the list
    - `streams` object[] — Specify the list of streams used in the super player by station
      - `id` integer — Specify the id of the stream to use
      - `is_main` boolean — Specify if the stream is the main stream of the station
    - `hls_stream` object
      - `id` integer — Specify the HLS Stream id used in the player
      - `is_main` boolean — Specify if the HLS stream is the main stream of this station
  - `twitter_account` string — Specify the Twitter account will be used in Twitter embed
  - `twitter_backlink` string — Specify the Twitter backlink used in Twitter embed
  - `twitter_hashtag` string — Specify the Twitter hashtag used in Twitter embed
  - `type` 1 | 2 | 3 | 4 | 5, required — Specify the type of player
  - `volume` integer — Specify the default volume in the player
  - `width` string — Specify the width in px for display the player

## Response `201`

Created

- object
  - `result` 'success' | 'error' | 'asynchronous', required — Result of the HTTP request
  - `data` boolean

## Other responses

- `404` — Not Found

---

[API](https://skmtc.dev/infomaniak/apis/api-reference-developer-tools.md) · [All operations](https://skmtc.dev/infomaniak/apis/api-reference-developer-tools/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/infomaniak/api-reference-developer-tools/revisions/667aae28fec6/schema)