August 22 2025 Changelog

API Change Log

Production

ADDED Custom Image

This launch enhances the Sponsored Brands ad format by enabling the use of custom images, such as lifestyle, creating a more visually compelling and engaging shopper experience

  • Use the POST /api/v2/sba_custom_image_upload endpoint with the file
    Upload the custom image in the file object.

    Requirements
    File format: JPG or PNG
    Max file size: 1 MB
    Aspect ratio: 16:9
    Dimensions: minimum 1200 x 675 px (or larger)
    Object
    object to upload custom image. See the documentation for details.
  • Use the DELETE /api/v2/sba_profile/:sba_profile_id/custom_image endpoint with the sbaProfileId
    The ID of the Sponsored Brands profile.
    Path Parameter
    path parameter to delete the custom image for a campaign that is not under review and not live. See the documentation for details.
  • Use POST /api/v2/sba_profile (existing endpoint) to set up a Sponsored Brands profile with an optional custom image. See the documentation for details.
  • Use GET /api/v1/sba_profile (existing endpoint) to list Sponsored Brands profiles. Refer to customImageReviewStatusNew!
    Current status of the custom image review performed by the AdOps team.
    Possible values: pending, approved, rejected.
    Field
    and customImageReviewReasonNew!
    The reason provided when customImageReviewStatus is rejected. Example: Invalid logo.
    Field
    . See the documentation for details.
  • Use POST /api/v1/review (existing endpoint) to submit the Sponsored Brands profile—with an optional custom image—for review. See the documentation for details.
  • Use GET /api/v1/review (existing endpoint) to fetch the Sponsored Brands review status. See the documentation for details.

Note: Adding a custom image is optional. If the custom image is rejected, the Sponsored Brands profile will still be approved as long as the brand logo is approved.