Walmart Connect Advertising API Change Log

Production

ADDED Brand Asset Manager

Brand Asset Manager provides a centralized workflow for creating, reviewing, storing, and reusing approved branded assets across Sponsored Brands manual campaigns. The feature is available to advertisers with brands registered through Supplier One or the Walmart Brand Portal and supports migration from existing Brand Profile campaign workflows.

Create a Brand Asset using POST /api/v1/brand_assets. Required asset fields include brandAssetName
Name used to identify the Brand Asset.
Request Field

, promotedBrand
Brand displayed in the ad as “Sponsored by brand.” The documented character limit is 35 characters.
Request Field

, associatedBrands
All brands to feature in the Sponsored Brands ad. Include the promoted brand when it should also appear in this list.
Request Field

, headlineText
Custom headline for the promoted brand. The documented maximum is 45 characters.
Request Field

, and clickUrl
Walmart destination URL for the ad. Supported destinations include a Search Page, Browse Page, Brand Shop, or Brand Shelf.
Request Field

.
Upload the required logo with POST /api/v1/brand_assets/logo_image_upload. Brand Assets without a logo are rejected during review, and the logo should match the promoted brand.
Optionally upload a custom image using POST /api/v1/brand_assets/custom_image_upload. Custom images must use JPG or PNG format, a 16:9 aspect ratio, minimum dimensions of 1200 × 675 pixels, and must not contain text, graphics, or logos.
Retrieve or modify an asset using GET /api/v1/brand_assets or PUT /api/v1/brand_assets. A Brand Asset cannot be updated while its review is pending, after it has been rejected, or while it is associated with a campaign.
Submit an asset for review using POST /api/v1/brand_assets/reviews. The response returns reviewId
Unique identifier for the Brand Asset review request.
Response Field

, which can be used with GET /api/v1/brand_assets/reviews to retrieve the review status.
Monitor reviewStatus
Current Brand Asset review state. Possible values include pending, inProgress, complete, and cancelled.
Response Field

, reviewReason
Reason returned when the Brand Asset does not pass review.
Response Field

, and customImageReviewReason
Reason returned when the optional custom image does not pass review.
Response Field

. Brand Asset reviews may take up to 72 hours.
Add an approved Brand Asset to a Sponsored Brands manual campaign using POST /adGroups or replace the asset using PUT /adGroups. Each Sponsored Brands campaign is limited to one ad group, and each ad group is limited to one Brand Asset.
Pause a campaign before replacing its Brand Asset. After replacement, resubmit the campaign for review before it can return to normal delivery.
Existing Brand Profile campaigns should migrate by pausing the campaign through PUT /campaigns, disabling the Brand Profile through PUT /v2/sba_profile, and attaching an approved Brand Asset through PUT /adGroups.

Best Practice: Complete the Brand Asset fields and image uploads before submitting the asset for review. After approval, reuse the asset across eligible Sponsored Brands campaigns instead of recreating the same branded content.

Migration Note: Brand Profile Create endpoints will be deprecated on January 31, 2027, and restrictions on updating Brand Profiles and Brand Profile campaigns will apply on that date. Migrate affected campaigns to Brand Asset Manager before January 31, 2027.

To learn more, see the Brand Asset Workflow Guide.