Update sponsored product campaigns
Overview
This article explains how to update an existing sponsored product campaign using the API version 3 endpoints.
Main endpoints
| Method | Endpoint | Description | Documentation |
|---|---|---|---|
| DELETE | https://stoplight.io/mocks/kamino-retail/kamino-api/1169659571/ksp-campaigns/{campaign-id} |
Soft-delete a sponsored product campaign. | Delete a KSP campaign |
| PUT | https://api.kaminoretail.dev/v3/ksp-campaigns/{campaign_id} |
Update a sponsored product campaign configuration. | Update a KSP campaign |
The DELETE endpoint is a shortcut for updating a campaign and setting its status to deleted.
Campaign update restrictions
You can update all campaign attributes except website, brand, and DSA.
Attribute-specific rules
The following attributes have additional constraints:
-
Budget: the updated budget must be greater than or equal to the current budget. -
Keywords: you can add or remove keywords from the campaign. -
Promoted products: you can add or remove promoted products from the campaign.
Validation and status changes
If you modify the budget, keywords, or promoted products, the campaign is automatically paused and Kamino submits it for a new retailer validation process.
For more information, see Approve campaigns.