Manage automation rule (adsap_manage_automation_rule)
Platform: Meta · Read or write: Write · Plan: Early Access · Consumes a task: No · Preview supported: Yes
What it does
Creates, changes, switches on or off, or deletes an automation rule for one ad account. A rule checks the account every day. When every condition is true, it either reports the match or turns the entity off. Ask for a preview first: the copilot reads the parsed rule back to you, including its guardrails, and applies it only after you confirm.
Parameters
Descriptions are shortened from the tool schema. Your assistant sees the full text.
| Name | Type | Required | Description |
|---|---|---|---|
action | one of create, update, enable, disable, delete | Yes | |
account_id | string | Yes | Meta act_… or bare 10-digit Google Ads customer id. |
rule_id | string | No | Required for update, enable, disable and delete. |
name | string | No | |
level | one of campaign, ad_set, ad | No | |
entity_ids | array of string | No | Limit the rule to these specific entities. Omit to watch every entity at that level in the account. |
conditions | array of object | No | |
conditions[].metric | one of spend, impressions, clicks, conversions, cpa, roas, ctr, link_ctr | Yes | cpa = cost per conversion, roas = return on spend, ctr = click rate. |
conditions[].operator | one of >, <, >=, <= | No | |
conditions[].value | number | Yes | |
conditions[].timeframe_preset | one of yesterday, last_3_days, last_7_days, last_14_days | No | |
min_spend | number | No | Required on create. The entity must have spent at least this much before the rule may act. |
cooldown_hours | integer | No | Default 24. |
mode | one of notify, auto_act | No | |
dry_run | boolean | No | Preview only: the request is validated and the resolved payload returned, nothing is created or changed. |
Example prompts
- “Create a rule that pauses any ad set spending more than $100 with zero purchases over 3 days.”
- “Set up a notify-only rule that flags ads with a cost per lead above 25 EUR after 50 EUR of spend.”
- “Disable the ‘Kill losers’ rule for now, and show me what it has done this month.”
Notes
Every rule needs a minimum spend before it fires, and conditions combine with AND. On Meta a rule never acts on entities still in the learning phase or changed in the last two days. On Google, rules work at the campaign and ad set levels only.
Related tools
adsap_get_recommendations: Verified recommendations AND alerts computed by Adsap’s daily/weekly checks from the client’s own data.adsap_list_automation_rules: List the automation rules on one ad account, and optionally what they have done.
Guide
Read Automation rules for the workflow around this tool, and the Tool reference for every tool.