# Manage automation rule (adsap_manage_automation_rule)

Creates, changes, switches on or off, or deletes an automation rule for one ad account.

Canonical: https://adsap.ai/docs/tools/adsap_manage_automation_rule
Updated: 2026-09-13

**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`](/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](/guides/automation/rules) for the workflow around this tool, and the [Tool reference](/tools) for every tool.