August 19 2026 Changelog

API Change Log

Production

ADDED Brand Asset Manager API

Brand Asset Manager is now available, adding a standalone set of endpoints for creating, updating, and reviewing Brand Assets independently of a Sponsored Brands campaign.

  • Create a Brand Asset with POST /brand_assets. The request introduces promotedBrand
    The brand shown in the ad as "Sponsored by 'brand'." Must be a valid, approved brand name. Limited to 35 characters.
    Request Field
    , associatedBrands
    All brands to feature in the Sponsored Brands ad, including the promoted brand if it should also appear. Limited to 255 characters.
    Request Field
    , and headlineText
    Custom headline copy explaining the brand's value to shoppers. Maximum 45 characters; avoid using all special characters.
    Request Field
    . A new Brand Asset is created in a "Pending" state and must be reviewed and approved before it can be added to an ad group.
  • Retrieve a single Brand Asset with GET /brand_assets. The response includes a new status
    Current lifecycle state of the Brand Asset, such as draft, pending, approved, or rejected.
    Response Field
    field along with logoUrl, customImageUrl, createdAt, and an adGroups array listing every ad group (and parent campaign) the Brand Asset is currently attached to.
  • Update Brand Asset fields with PUT /brand_assets, and remove a Brand Asset with DELETE /brand_assets/:brandAssetId. Changing headlineText, clickUrl, or the associated brands on an approved asset resets it to pending review. Brand Assets already submitted for review, rejected, or attached to a campaign cannot be updated or deleted.
  • Upload creative with POST /brand_assets/logo_image_upload and POST /brand_assets/custom_image_upload. A previously uploaded custom image can be removed with DELETE /brand_assets/:brandAssetId/custom_image.
  • Submit a Brand Asset for review with POST /brand_assets/reviews, and check review progress with GET /brand_assets/reviews. The review response adds reviewStatus
    Status of the Brand Asset review: pending, inProgress, complete, or cancelled.
    Response Field
    and customImageStatus
    Separate review status for the uploaded custom image, independent of the overall Brand Asset review status.
    Response Field
    , along with reviewReason and customImageReviewReason for rejected assets.

Best Practice: Every Brand Asset requires a logo image — assets submitted for review without one will be rejected. Each Sponsored Brands ad group can hold only one Brand Asset, and each Sponsored Brands campaign is limited to one ad group.

To learn more, see the Brand Asset Workflow Guide.

Sponsored Brands Profile

With Brand Asset Manager now available, Sponsored Brands Profile creation endpoints are scheduled for deprecation in early 2027, alongside new restrictions on updating brand profiles and campaigns tied to an active brand profile. Exact dates are published in the Deprecation Schedule & Log; the new restrictions take effect on that same date.

  • Campaigns using an active sba_profile
    Legacy Sponsored Brands Profile attached to a campaign via the v2/sba_profile endpoints. Scheduled for deprecation in early 2027.
    Existing Endpoint
    should migrate to a PUT /adGroups
    Attach an approved Brand Asset to the ad group. No campaign review resubmission is required for the swap.
    New Endpoint
    Brand Asset. Once an ad group has a Brand Asset attached, the brand profile cannot be re-enabled.
  • For campaigns still on an active brand profile, PUT /campaigns can no longer change the end date, and status updates are blocked for profiles in a completed or proposal state.
  • PUT v2/sba_profile now blocks all operations except changing status to disabled.
  • POST/PUT /adItems and POST/PUT /keywords can no longer add new items or keywords to an ad group tied to an active brand profile.
  • Across all manual Sponsored Brands campaigns, PUT /adGroups no longer allows clearing every Brand Asset by submitting an empty array — after deprecation, a Brand Asset can only be replaced with another Brand Asset, not removed outright.

Migration Note: Migrate active brand-profile campaigns before the deprecation date takes effect: pause the campaign, disable the brand profile, and attach an approved Brand Asset to the ad group. Because re-enabling a brand profile is not possible once a Brand Asset is attached, treat this as a one-way switch per campaign.

To learn more, see Operations Allowed After Brand Profile Deprecation and the Sponsored Brands API Workflow Guide.