---
schema_version: "1"
id: 321ada1faa6c94ebf3b7105747e115f836a5a850b96bd872f66ce2154ac4d843
title: Ingest Promotions Input
collection: legacydeveloper
version: current
locale: en-us
portal_url: https://docs.salesforce.com/legacydeveloper/current/en-us/retail_api/connect_requests_ingest_promotions_input.md
canonical_url: https://developer.salesforce.com/docs/atlas.en-us.retail_api.meta/retail_api/connect_requests_ingest_promotions_input.htm
source_site: developer.salesforce.com
content_type: documentation
content_hash: bb3208e3ee4e84940a714b708ce1f57a33bb0c6a0040a9b54cc9bb598ee0d137
description: Input representation of the ingest promotions request.
---
# Ingest Promotions Input

Input representation of the ingest promotions request.

## Root XML tag

POST promotions/ingest

## JSON Example

{
    "workflow" : "Create",
    "importId" : "12345678-1234-1234-1234-123456789012",
    "salesOrg" : "0001",
    "promotions": \[
    {
      "AnchorAccount": "CS\_Atlanta",// external Id
      "PromotionTemplate": "Customer Promotion",
      "Comment": "250aup new bom gcp",
      "Slogan": "250aup new bom gcp ",
      "DateFrom": "2024-01-01",
      "DateThru": "2024-12-31",
      "PlacementDateFrom": "2024-03-01",
      "PlacementDateThru": "2024-04-30",
      "DeliveryDateFrom": "2024-08-01",
      "DeliveryDateThru": "2024-09-30",
      "OrderDateFrom": "2024-06-01",
      "OrderDateThru": "2024-07-30",
      "CommitDate": "2024-01-10",
      "ProductFilter": {
        "Criteria": {
          "Category": \[
            "Snacks",
            "Beverages"
          \],
          "Brand": \[
            "Empower\_Cola",
            "HiChoc"
          \]
        }
      },
      "ManualInputs": \[
        {
          "KPI": "ProPlanTotalVolume",
          "Value": 900000
        }
      \],
      "Tactics": \[
        {
          "Amount": 2500,
          "CompensationModel": "PerCase",
          "DateFrom": "2024-05-01",
          "DateThru": "2024-07-30",
          "InStoreDateFrom": "2024-05-01",
          "InStoreDateThru": "2024-07-15",
          "ShipmentDateFrom": "2024-05-16",
          "ShipmentDateThru": "2024-07-30",
          "TacticTemplate": "PriceReduction"
        }
      \]
    }
  \]
}

## Properties

| Name | Type | Description | Required or Optional | Available Version |
| --- | --- | --- | --- | --- |
| importId | Integer | ImportId of the process. If not passed, a new import transaction will be created. | Optional | 55 |
| workflow | Integer | Promotion Business Object API workflow name to execute. | Required | 55 |
| salesOrg | SalesOrgName | Sales organization. | Optional | 55 |
| promotions | List <Object> | List of Promotion payloads. Max 50 items. | Required | 55 |