---
title: "Create Banner"
method: POST
path: "/companies/{company_id}/banners"
tags: ["banners"]
---

# Create Banner

`POST /companies/{company_id}/banners`

## Request

- Base URL: `https://app.zalster.com` (the document declares no server; this is the origin it was published from)
- URL: `https://app.zalster.com/companies/{company_id}/banners`
- Auth: none declared

A banner: the headline, subline, call to action and badge asked for, the chosen
products' own pictures with their names and prices, the brand's logo, colours and
faces, on a kit colour or a picture sent as a ``data:`` URI. Drawn now and kept
behind ``image_url`` until ``expires_at``. ``preview: true`` adds a small JPEG of
it, base64, for a chat to show. 400 for products that are not active or a picture
that cannot be read; 503 ``banner-busy`` when the render worker cannot draw it in time.

## Path parameters

- `company_id` string, uuid, required: Company id

## Request body

- BannerRequest: A banner to draw (decision 238): its words, its products, its ground.
  - `headline` string, required
  - `subline` string, nullable
  - `cta` string, nullable
  - `badge` string, nullable
  - `product_ids` string[]
  - `shape` 'wide' | 'square' | 'portrait' | 'story'
  - `ground` string, nullable
  - `picture` string, nullable
  - `prices` boolean
  - `preview` boolean

## Response `201`

Successful Response

- BannerOut
  - `id` string, uuid, required
  - `image_url` string, nullable, required
  - `width` integer, required
  - `height` integer, required
  - `shape` string, required
  - `expires_at` string, date-time, required
  - `products` BannerProductOut[], required
    - `product_id` string, uuid, required
    - `title` string, required
    - `price` string, nullable
    - `was` string, nullable
    - `picture` 'cutout' | 'photo', nullable
  - `warnings` string[]
  - `preview` string, nullable
  - `preview_media_type` string, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/zalster/apis/zalster-feed-processor.md) - [All operations](https://skmtc.dev/zalster/apis/zalster-feed-processor/llms.txt) - [OpenAPI document](https://skmtc.dev/zalster/apis/zalster-feed-processor/revisions/d0b9dc66ad36?raw)