---
schema_version: "1"
id: f5e7a5668404fd711d4008802a4a5fe83651f6aa7abb41afe0a9dae86565ac24
title: Begin Promotion Import
collection: legacydeveloper
version: current
locale: en-us
portal_url: https://docs.salesforce.com/legacydeveloper/current/en-us/retail_api/begin_promotion_imports.md
canonical_url: https://developer.salesforce.com/docs/atlas.en-us.retail_api.meta/retail_api/begin_promotion_imports.htm
source_site: developer.salesforce.com
content_type: documentation
content_hash: e3b05d91226dee7777851109e90c0817cbfd3c7d49f6c021139105379a9c1f8a
description: This endpoint initializes a promotion import from an external system. You can group a set of promotions using the import ID, retrieved by thie end point. This endpoint announces that the import contains a specified number of promotions to be processed. The system can import the promotions, create, and update them, and trigger a promotion calculation for the given promotions. The status of the import can be monitored with the GET_PROMOTION_IMPORT_STATUS endpoint.
---
# Begin Promotion Import

This endpoint initializes a promotion import from an external system. You can group a set of promotions using the import ID, retrieved by thie end point. This endpoint announces that the import contains a specified number of promotions to be processed. The system can import the promotions, create, and update them, and trigger a promotion calculation for the given promotions. The status of the import can be monitored with the GET\_PROMOTION\_IMPORT\_STATUS endpoint.

## Resource

promotions/initialize

## Available Version

55

## Requires Chatter

No

## HTTP Methods

POST

## Request Body for POST

### JSON Example

{
    "nrOfItems": 500,
    "salesOrg": "0001"
}

### Properties

<table class="featureTable sort_table" summary="">





            <thead class="thead sorted" align="left">
              <tr>
                <th class="featureTableHeader vertical-align-top " id="d145467e122">Name</th>

                <th class="featureTableHeader vertical-align-top " id="d145467e125">Type</th>

                <th class="featureTableHeader vertical-align-top " id="d145467e128">Description</th>

                <th class="featureTableHeader vertical-align-top " id="d145467e131">Required or Optional</th>

                <th class="featureTableHeader vertical-align-top " id="d145467e134">Available Version</th>

              </tr>

            </thead>

            <tbody class="tbody">
              <tr>
                <td class="entry" headers="d145467e122" data-title="Name"><samp class="codeph nolang">nrOfItems</samp></td>

                <td class="entry" headers="d145467e125" data-title="Type">Integer</td>

                <td class="entry" headers="d145467e128" data-title="Description">Number of items that are imported under the given handle. <ul class="ul bulletList">
                    <li class="li"><samp class="codeph nolang">Minimum Value : 1</samp></li>

                    <li class="li"><samp class="codeph nolang">Maximum Value: 10000</samp></li>

                  </ul>
                </td>

                <td class="entry" headers="d145467e131" data-title="Required or Optional">Required</td>

                <td class="entry" headers="d145467e134" data-title="Available Version">55</td>

              </tr>

              <tr>
                <td class="entry" headers="d145467e122" data-title="Name"><samp class="codeph nolang">timeout</samp></td>

                <td class="entry" headers="d145467e125" data-title="Type">Integer</td>

                <td class="entry" headers="d145467e128" data-title="Description">Indicates the timeout in seconds. In the event of a time out, no further
                  messages will be accepted for the import IDs. <p class="p">The default value is 300
                    seconds.</p>
                </td>

                <td class="entry" headers="d145467e131" data-title="Required or Optional">Optional</td>

                <td class="entry" headers="d145467e134" data-title="Available Version">55</td>

              </tr>

              <tr>
                <td class="entry" headers="d145467e122" data-title="Name"><samp class="codeph nolang">salesOrg</samp></td>

                <td class="entry" headers="d145467e125" data-title="Type">SalesOrgName</td>

                <td class="entry" headers="d145467e128" data-title="Description">Indicates the name of the sales organization.</td>

                <td class="entry" headers="d145467e131" data-title="Required or Optional">Required</td>

                <td class="entry" headers="d145467e134" data-title="Available Version">55</td>

              </tr>

            </tbody>

          </table>

## Response Body for POST

[Begin Promotion Import Output Representation](https://developer.salesforce.com/docs/atlas.en-us.retail_api.meta/retail_api/connect_begin_promotion_imports_output.htm "Output representation of the promotion import request.")