v2

latestOpenAPI 3.1.02026-08-075421692.0 MB
Ad Accounts

List value rule sets

Lists the ad account's value rule sets (Meta's /act_X/value_rule_set). A value rule set adjusts the auction bid up or down for audience segments you value differently; attach one to an ad set with valueRuleSetId on POST /v1/ads/create or PUT /v1/ads/ad-sets/{adSetId}.

Rows are returned in the same camelCase shape the PUT body takes, ids included, so a set round-trips 1:1: the update is a full replace, not a patch, so you GET, mutate and send the whole thing back.

Limits: 6 rule sets per ad account, 10 rules per set, 4 criteria per rule.

Rule order is semantic. Rules are evaluated in array order and only the FIRST matching rule adjusts the bid for an overlapping audience. The order you send is the order that is stored and returned.

Eligibility: value rule sets apply only to ad sets on the LOWEST_COST_WITHOUT_CAP (auto-bid) or COST_CAP bid strategies. Meta rejects the rest server-side.

get/v1/ads/value-rule-sets

Query parameters

accountIdstring required

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

adAccountIdstring required

Meta ad account id (act_<n>).

limitinteger

Rows per page

afterstring

Cursor from paging.after of the previous page. Meta does not document paging on this edge; after comes back null when it omits cursors.

Response

Value rule sets

adAccountIdstring