Assistant tools · Setup and campaigns

Apple Ads tools

Apple Search Ads organizations and campaigns, delivery report (impressions, taps, installs, spend), daily budget and status changes.

Tool names and descriptions are generated straight from the server code; the descriptions are the original English text the assistant sees.

Read tools3 tools

Read1 credits

Connected Apple Search Ads organizations: org_id, name, currency. Read only; connected=false when none.

This tool takes no parameters.

Read1 credits

Apple Search Ads campaigns: id, name, status, daily budget, App Store adamId, countries. Read only.

Parameter	Type	Description
`org_id`Optional	string	Apple Search Ads organization id; required only when several orgs are connected

Read2 credits

Apple Search Ads delivery report: impressions, taps, installs, spend per campaign. Read only; never invents numbers.

Parameter	Type	Description
`org_id`Optional	string	Apple Search Ads organization id; required only when several orgs are connected
`days`Optional	integer (1–90)	—
`start_date`Optional	string	—
`end_date`Optional	string	—

Write2 credits

Pause or activate an Apple Search Ads campaign. Applied when the user asks; undoable.

Parameter	Type	Description
`org_id`Optional	string	Apple Search Ads organization id; required only when several orgs are connected
`campaign_id`Required	string	—
`status`Required	pause \| activate	—

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

Write2 credits

Set an Apple Search Ads campaign daily budget. Increases above 50% per change are blocked.

Parameter	Type	Description
`org_id`Optional	string	Apple Search Ads organization id; required only when several orgs are connected
`campaign_id`Required	string	—
`daily_budget`Required	number	—

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.