FAQ#

Jump to the specific topic:

• Is it possible for me to deactivate promotions?
• Can I remove just one or few SKUs from the promotion?
• What is the campaign size limit?
• Can I set the limitation on how many times the particular promotions can be used?
• When should I expect the promotion to be visible on the front end after creating it via API?
• If I send two requests for the same SKU: one for strikethrough one for BOGO promotion with different overlapping dates, what will be visible on the front end?
• Can I create the same promotion for multiple vendors?
• What are the limitations of Partner API/Promotions?
• How do I access the Shops Integrations Plugin?
• How do I generate credentials to use Partner API/Promotions?

Is it possible for me to deactivate promotions?#

Yes, it is possible to do with the PUT endpoint, setting the “active” parameter as “false”.

Can I remove just one or few SKUs from the promotion?#

Yes, by adding the relevant SKUs to the “discount” parameter and then set the “active” as “false”

What is the campaign size limit?#

Partner can create up to 2 M promotions in one request (skus*vendors)

Can I set the limitation on how many times the particular promotions can be used?#

Yes. This can be done in the “limits” parameter by adding the relevant amount to “global_limit”

When should I expect the promotion to be visible on the front end after creating it via API?#

The promotion creation can take maximum up to 50 minutes if the request reaches the maximum capacity

If I send two requests for the same SKU: one for strikethrough one for BOGO promotion with different overlapping dates, what will be visible on the front end?#

The promotion that has a later start_time will be visible after it overlaps the first promotion.

Can I create the same promotion for multiple vendors?#

Yes. It can be done in “vendors” parameter (can be platform id or partner’s external id mapped in Partner Portal). If vendors = [*] promotion will be applied to all vendors associated with the chain.

What are the limitations of Partner API/Promotions?#

• Promotions created via API must be modified via API
• To modify/delete a promo, the same body request is required
• Currently, there is no item-level error visibility when using Partner API/Promotions
• It is not possible to create promotions for different skus and different vendors in a single request

How do I access the Shops Integrations Plugin?#

• You can access the Shops Integrations plugin in Partner Portal, you will be given access by your account manager or during registration with us.
• It is advised to limit the access to Shops plugins in Partner Portal to only those who need to perform a function for your business - this is because Partner Portal can contain sensitive information i.e. webhook configurations, access tokens
• Please reach out to your account manager if you do not know how to gain access to Partner Portal

How do I generate a token to use Partner API/Promotions?#

Please see the token management section here