Request

POST /banner

Headers

Header	Value
`Authorization`	`Bearer <token>`
`Content-Type`	`application/json`

Request Body

Field	Type	Required	Description
`name`	string	Yes	Internal display name for the banner.
`active`	boolean	Yes	Whether the banner is active.
`listType`	string	Yes	The page type: `search`, `category`, or `manufacturer`.
`language`	string	Yes	Language code this banner applies to (e.g. `de`, `en`).
`title`	string	No	Banner display title.
`description`	string	No	Banner description text.
`link`	string	No	Target URL when the banner is clicked.
`images`	array	No	Array of image objects for the banner.
`position`	string	No	Position of the banner on the page.
`searchAutosuggestBoth`	string	No	When `listType` is `search`, specify whether the banner shows on `search`, `autosuggest`, or `both`.
`activeTiming`	boolean	No	When `true`, the `activeFrom` and `activeTo` scheduling fields are used.
`activeFrom`	string	No	ISO 8601 start date/time for scheduled activation.
`activeTo`	string	No	ISO 8601 end date/time for scheduled deactivation.
`type`	integer	No	Banner type identifier.
`identifier`	array	No	Array of search terms or category/manufacturer IDs this banner is triggered by.

Example Request

{
  "name": "Summer Sale Banner",
  "active": true,
  "listType": "search",
  "language": "de",
  "title": "Summer Sale",
  "link": "/summer-sale",
  "searchAutosuggestBoth": "both",
  "identifier": ["summer", "sale"]
}

Response

Returns the created banner object.