# Find any Meta entity by name fast

> Tier: recipe. Operating recipe: real tool sequence, core rules, known traps.

Name-to-entity search, the glue step before any scoped read on accounts with thousands of objects.

**Intent.** Resolve names to IDs across campaigns, ad sets and ads.

## When to use

- Someone references 'the Black Friday campaign' and you need its ID.

## When not to use

- No specific contraindication beyond the preconditions below.

## Sources

Required: Meta Ads

## Preconditions

- The account is ticked in the dashboard, confirmed via list_accounts.

## Inputs

- `window`: Analysis window. Default: last 30 days.

## Procedure

1. Search entities by name fragment. — tools: `meta_search_entities`
2. Confirm the match by reading the entity before acting on it. — tools: `meta_get_campaigns`

## Decision rules

- **When** Several entities share the fragment → **conclude** Never guess: list matches with statuses and ask, or match on the active one only if the request implies it.

## Evidence requirements

- Every figure carries its account, metric and window.
- Anything below a readable sample size is reported as unjudged, not as zero.

## Human approval boundary

- The readout changes nothing. Any change it motivates goes through Safe Writes: preview, human confirmation, then apply.

## Failure modes

- Copied names across years make the newest match a trap: check dates.

## Output

- **Readout**: The figures, with windows and accounts named.
- **Flags**: What deserves a deeper skill or a human decision.
