---
title: "Create a billboard"
method: POST
path: "/billboards"
tags: ["Billboards"]
---

# Create a billboard

`POST /billboards`

## Headers

- `channel` string, required
- `organization` string, required

## Request body

- CreateBillboardInput
  - `target` 'LIVE' | 'HOME', required — Will the billboard be displayed on the **Home** screen or the **Live** screen?
  - `title` string, required — Billboard title
  - `description` string, required — Billboard description
  - `sort` number — Position in the carousel, when multiple billboards are displayed.
  - `delay` number — The number of seconds the billboard is displayed in the carousel.
  - `customization` BillboardCustomizationInput
    - `mobile` string — Media ID for the mobile version banner image
    - `desktop` string — Media ID for the desktop version banner image
  - `actions` string[] — IDs of the buttons on the billboard
  - `deleted` boolean — If **True**, the billboard has been deleted.

## Response `201`

Billboard created.

---

[API](https://skmtc.net/fanhero/apis/tenant-endpoints.md) · [All operations](https://skmtc.net/fanhero/apis/tenant-endpoints/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/fanhero/tenant-endpoints/versions/8e7584c449dc/schema)