---
schema_version: "1"
id: ba22110707857b34491514505075f08124dd1711ad2bdaa7de8718f597be5a20
title: Ingest Promotions
collection: legacydeveloper
version: current
locale: en-us
portal_url: https://docs.salesforce.com/legacydeveloper/current/en-us/retail_api/connect_resources_ingest_promotions.md
canonical_url: https://developer.salesforce.com/docs/atlas.en-us.retail_api.meta/retail_api/connect_resources_ingest_promotions.htm
source_site: developer.salesforce.com
content_type: documentation
content_hash: ae339b9f1d6b82c8b1d30093636cbb7ab7a3d4e8d8fa64e8e8d48ad255966fff
description: This endpoint receives the promotions payload that must be processed. The system import promotions, creates and updates them, and triggers the promotion calculation. The status of the import can be monitored with the GET_PROMOTION_IMPORT_STATUS endpoint.
---
# Ingest Promotions

This endpoint receives the promotions payload that must be processed. The system import promotions, creates and updates them, and triggers the promotion calculation. The status of the import can be monitored with the GET\_PROMOTION\_IMPORT\_STATUS endpoint.

## Resource

promotions/ingest

## Available Version

55

## Requires Chatter

No

## HTTP Methods

POST

## Request Body for POST

### 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 |

## Response Body for POST

[Promotion Import Output Representation](https://developer.salesforce.com/docs/atlas.en-us.retail_api.meta/retail_api/connect_responses_ingest_promotion_output.htm "Represents the details of the ingest promotions import status.")