v2

latestOpenAPI 3.1.02026-08-075421692.0 MB
Ad 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

accountIdstring required

Zernio SocialAccount id (posting or ads variant) used to resolve the Meta token.

namestring required

Required: the update replaces the whole set.

Response

Value rule set replaced

valueRuleSetIdstring
namestring
messagestring