Events

Walmart.ca runs many promotional events and campaigns all year long, which provides you with an excellent opportunity to drive traffic to your items.

Events can be seasonal, cultural or themed to take advantage of shopping occasions throughout the year. Campaigns are recurring all year long, such as our very successful “Deals of the Week” or “Daily Deals” programs.

While you can set up promotions for your items at any time to offer great value to customers, events and campaigns provide extra visibility to boost sales at key times of the year.

You can set up your offers for sale on Walmart.ca by participating in specific events and campaigns through the Event Management API.

Note: You need to complete seller registration, and get your API Key (Client Secret and Client ID) to start item integration. To access your API Key, go to My Account. Select Login Type, choose Marketplace to get to API Keys.

Steps to participate in Events and Campaigns

As a seller, you need to follow to below steps to participate in an event/campaign.

This is a fundamental API in understanding all the active and upcoming events/campaigns that you can participate in. 

Each event metadata consists of key information such as event name, guidelines, submission window and the actual event dates.

All these data points serve you to make a decision on whether you want to participate in a specific campaign or not. 

Once you choose the list of events/campaigns that you want to take part in. The next step is download the submission template using the download template API.

This template is common across all events & campaigns hence, you could treat this as an optional step post downloading it or the first time.

The submission template consists of attributes such as SKU ID, Promo retail price, eligible start & end date time. These attributes are mandatory for a particular submission to be validated.

Once the submission template is populated with the required SKUs details, you can upload the template file as an attachment to the submit template API.

Each template submission is for a specific event/campaign only.

To participate in multiple events or campaigns, you will need to make multiple uploads, one per event.

Once the filled template is submitted, you can check on the status of the submission by using the get submission status API.

Each template consists of multiple of SKUs, the submission status will be provided for each SKU on whether it was accepted or rejected.

In case a particular SKU was rejected, then the feedback for why it was rejected and what needs to be done will be provided as part of the status API response.

This is the final step in the event participation flow.

In Get submission status, you will find the submission status will be reflecting each SKU ID present in the submission file.

Based on the submission status (Ex: 7 SKU IDs are selected, 2 SKU IDs are rejected, 1 SKU ID is in process), you can call the API called Upload Approved Candidates for Promo, this API call will ensure that every single SKU ID which was approved (selected) will be auto published as and when the eligible date time provided for the SKU is met.