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

# Create a billboard

`POST /billboards`

## Request

- Base URL: `https://api.fanheroapi.com`
- URL: `https://api.fanheroapi.com/billboards`
- Auth: API key in header `apiKey`

## 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.dev/fanhero/apis/headless-cms-endpoints.md) - [All operations](https://skmtc.dev/fanhero/apis/headless-cms-endpoints/llms.txt) - [OpenAPI document](https://skmtc.dev/fanhero/apis/headless-cms-endpoints/revisions/fb8d50c05ee6?raw)