---
title: "Creates a boost and bury"
method: POST
path: "/boostandbury"
tags: ["BoostAndBury"]
---

# Creates a boost and bury

`POST /boostandbury`

## Request

- The document declares no server URL.
- Auth: API key in header `TWN-InstanceKey` and API key in header `TWN-Authentication`

## Request body

- ApiBoostAndBuryCreate: Represents the data required to create a new boost and bury configuration
  - `Name` string: Name of the boost and bury
  - `Type` 'Boost' | 'Bury'
  - `StartDate` string, date-time, nullable: Start date of the boost and bury
  - `EndDate` string, date-time, nullable: End date of the boost and bury
  - `Weight` number, double: Weight of the boost and bury
  - `Enabled` boolean, nullable: Indicates if the boost and bury is enabled
  - `Component` PersonalMerchandisingItemApiModel: Builder item
    - `ComponentId` string, uuid: Unique id of the builder item
    - `RecommendationId` integer, nullable: Recommendation id
    - `RecommendationGroupKey` string, nullable: Recommendation groupkey
    - `Type` 'featuredrec' | 'lastviewedproduct' | 'productrecgroup' | 'lastpurchasedproduct' | 'personalproduct' | 'brandproduct' | 'property' | 'externaldata' | 'contentitem' | 'organic' | 'aipersonal': Type of the builder item
    - `ContentItemType` string, nullable: Content itemtype
    - `BrandValue` string, nullable: Brand value
    - `AttributeId` integer, nullable: Attribute id
    - `ItemId` string, nullable: Item id
    - `AttributeValue` string, nullable: Attribute value
    - `ExternalDataComponentId` integer, nullable: External data component id
    - `Position` integer: Position of the item on page
    - `ColSpan` integer: Column span of the item
    - `RowSpan` integer: Row span of the item
  - `Triggers` ApiBoostAndBuryTriggerBase[]: Triggers associated with the boost and bury.
    - union: Base model for boost and bury triggers
      - object: Represents a boost and bury trigger that matches one of the given search phrases
        - `discriminator` 'ApiBoostAndBurySearchPhraseTrigger', required
        - `SearchPhrases` string[]: Search phrases that activate this trigger
        - `BoostAndBuryId` integer: Identifier of the boost and bury this trigger belongs to
        - `BoostAndBuryTriggerId` integer: Unique identifier of the boost and bury trigger
      - object: Represents a boost and bury trigger that matches one of the given categories
        - `discriminator` 'ApiBoostAndBuryCategoryTrigger', required
        - `Categories` integer[]: Category ids that activate this trigger
        - `BoostAndBuryId` integer: Identifier of the boost and bury this trigger belongs to
        - `BoostAndBuryTriggerId` integer: Unique identifier of the boost and bury trigger
      - object: Represents a boost and bury trigger that matches any category
        - `discriminator` 'ApiBoostAndBuryAnyCategoryTrigger', required
        - `BoostAndBuryId` integer: Identifier of the boost and bury this trigger belongs to
        - `BoostAndBuryTriggerId` integer: Unique identifier of the boost and bury trigger
      - object: Represents a boost and bury trigger that matches any search term
        - `discriminator` 'ApiBoostAndBuryAnySearchTermTrigger', required
        - `BoostAndBuryId` integer: Identifier of the boost and bury this trigger belongs to
        - `BoostAndBuryTriggerId` integer: Unique identifier of the boost and bury trigger
      - object: Represents a boost and bury trigger that matches every combination of the given categories and search phrases
        - `discriminator` 'ApiBoostAndBuryCategorySearchPhraseTrigger', required
        - `Categories` integer[]: Category ids that (combined with each of the search phrases) activate this trigger
        - `SearchPhrases` string[]: Search phrases that (combined with each of the categories) activate this trigger
        - `BoostAndBuryId` integer: Identifier of the boost and bury this trigger belongs to
        - `BoostAndBuryTriggerId` integer: Unique identifier of the boost and bury trigger

## Response `200`

OK

- integer

## Other responses

- `400`: Bad Request

---

[API](https://skmtc.dev/tweakwise/apis/app-api.md) - [All operations](https://skmtc.dev/tweakwise/apis/app-api/llms.txt) - [OpenAPI document](https://skmtc.dev/tweakwise/apis/app-api/revisions/dc936bf76941?raw)