post
https://{yourinstance}.makaira.io/banner
Creates a new advertising banner.
Requires authentication.
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.
Created