API 2027-01-01: Walmart audiences and 2026-06-01 deprecation
Summary
- API revision 2027-01-01 is available now.
- Strategies can target Walmart audiences, alongside your own uploaded and connected audiences, in one list.
- New
GET /catalog/audiencesendpoint to browse the Walmart audience catalog. - New
frequency_capon strategies. - Interest targeting is removed.
- Revision 2026-06-01 is deprecated on January 1, 2027 and sunsets on February 1, 2027.
What's new in 2027-01-01
| Change | Type |
|---|---|
Strategy audience targeting takes one include / exclude list of audience IDs, so Walmart audiences and your own audiences can be combined | Breaking |
GET /catalog/audiences lists the Walmart audiences you can target | Added |
frequency_cap on strategies | Added |
GET /segments/interests and the interests targeting field are removed | Breaking |
Target Walmart audiences
Strategy targeting now takes a single list of audience IDs. One strategy can include and exclude Walmart audiences together with audiences you've uploaded or connected in Vibe.
// 2026-06-01
"targeting": {
"audiences": {
"upload": { "include": ["<audience_id>"], "exclude": [] }
}
}
// 2027-01-01
"targeting": {
"audiences": {
"include": ["<walmart_audience_id>", "<your_audience_id>"],
"exclude": ["<audience_id>"]
}
}The paths are unchanged. The new targeting shape is used by:
POST /strategiesPATCH /strategies/{strategy_id}GET /strategiesGET /strategies/{strategy_id}POST /strategies/{strategy_id}/duplicatePOST /strategies/{strategy_id}/actions(response)POST /campaigns/{campaign_id}/duplicate(request)
Browse the Walmart audience catalog
GET /catalog/audiences returns every Walmart audience available for strategy targeting, with its category path (category, l1, l2, l3) and its addressable CTV reach (reach). Use each audience's id in targeting.audiences.include or exclude.
- Filters:
type(RECENT_BUYERS,IN_MARKETorPERSONA) andsearch(matches the audience name and every level of its category path). - Ordering: the response isn't paginated, and is ordered by category path so you can rebuild the category tree.
- Scope:
audiences:read. - Terms: your account must accept the Walmart audience terms in the Vibe app first. Until then, the endpoint returns
403with the page to visit. The terms can't be accepted through the API.
Cap frequency on strategies
Strategies accept frequency_cap: the maximum number of plays per household per day. It's an integer of at least 1, and defaults to 5. Campaign goals that don't cap frequency only accept 5.
Interest targeting removed
GET /segments/interests and the interests targeting field aren't available in 2027-01-01. Use audience targeting instead, including Walmart audiences.
How to upgrade
- Send
X-Vibe-Revision: 2027-01-01on your requests. - Move audience IDs from
targeting.audiences.upload.include/excludetotargeting.audiences.include/exclude. - Update any code that reads
targeting.audiences.uploadfrom strategy responses. - Remove any use of
GET /segments/interestsand theinterestsfield. - To add Walmart audiences, accept the terms in the Vibe app https://www.vibe.co/walmart-audience-terms, then pick IDs from
GET /catalog/audiences.
2026-06-01 timeline
| Date | 2026-06-01 |
|---|---|
| January 1, 2027 | Deprecated |
| February 1, 2027 | Sunset |
GET /revisions lists every revision with its release, deprecation and sunset dates.
Questions
Do I have to upgrade now?
No. 2026-06-01 keeps working until February 1, 2027. Upgrade now if you want to target Walmart audiences or set frequency caps.
Can I target Walmart audiences on 2026-06-01?
No. Walmart audience targeting is only available on 2027-01-01.
Can I use both revisions at the same time?
Avoid updating the same strategies from both. 2026-06-01 only sees uploaded audiences, and an update sent on it replaces the strategy's audience set, so it can remove audiences added through 2027-01-01. Move every service that updates strategies to 2027-01-01 together.
Why does GET /catalog/audiences return 403?
Either the Walmart audience terms haven't been accepted for your account yet, or your token is missing the audiences:read scope. The error message says which.
Can every advertiser use Walmart audiences?
No. Advertisers in restricted categories, including political and CBD, can't target Walmart audiences.
How often does the Walmart catalog change?
Catalogs update weekly. Cache the response for at least 24 hours.
How will I know about future revisions?
Follow this changelog or its RSS feed, and check GET /revisions.