v2
latestOpenAPI 3.1.02026-08-075421692.0 MBAd Accounts
Replace a value rule set
THIS IS A FULL REPLACE, NOT A PATCH. Meta's update is declarative: the body you send becomes the rule set.
- GET /v1/ads/value-rule-sets/{valueRuleSetId} FIRST.
- Keep a rule or criterion by echoing its id.
- Create one by including the object WITHOUT an id.
- Delete one by OMITTING it from the array. There is no warning and no undo.
name and rules are both required for exactly this reason: a partial body would silently destroy every rule left out.
Rule order is semantic: the array order you send is the evaluation order, and only the first matching rule adjusts the bid for an overlapping audience.
Existing rule sets created elsewhere may contain LOCATION_DMA criteria. Those went inert on 2026-06-22 and are rejected here; migrate them to LOCATION_COMSCORE_MARKET.
put/v1/ads/value-rule-sets/{valueRuleSetId}
Path parameters
valueRuleSetIdstring required
Platform value rule set id.
Request body
Response
Value rule set replaced