Meta Ads

Set a frequency cap on a Meta reach ad set

Limits how often one person may see the ads in a reach-optimised ad set: at most max_frequency impressions every interval_days. Use when: the ad set optimises for reach (or ad recall) and frequency is climbing — the usual first response to creative fatigue on a brand campaign. Do not use on a conversion, traffic or engagement ad set. Meta only honours a frequency cap on reach buying, and setting it elsewhere either fails or does nothing; the preview refuses rather than pretending. Do not set an aggressive cap on a small audience: Meta simply stops delivering once the cap binds, and the budget goes unspent. Returns the ad set read back from Meta with the cap that is actually in force. If the user wants "less repetition" on a conversion campaign, the honest answer is to refresh the creative or widen the audience, not to cap frequency.

post/api/v1/tools/meta_set_frequency_cap/execute

Request

  • Base URL: https://adako.ai
  • URL: https://adako.ai/api/v1/tools/meta_set_frequency_cap/execute
  • Auth: HTTP bearer

Headers

Idempotency-Keystring

Optional 8-128 character key. A successful envelope is cached for 24 hours; replaying the key with the same arguments returns it again with Idempotent-Replayed: true, and replaying it with different arguments answers 409.

Request body

Response

The tool ran. A write returns proposal_id and approve_url while the change waits for approval.

successunknown required
toolstring required
dataobject required

Machine-readable result.

markdownstring required

The same result written for a person or a model.

proposal_idstring

Present for writes. Nothing changes on the ad platform until it is approved.

approve_urlstring

Where a person approves the proposal.

request_idstring required

Changes

No recorded changes to this operation across all 1 revision of this API.