Add Callout Extensions
Add callout extensions to a campaign.
Callouts are short, non-clickable highlights that appear below your ad. They communicate quick trust signals and differentiators.
IMPORTANT RULES (from google-ads-creative-guidelines.md):
- Max 25 characters each
- 4-8 callouts recommended
- Should NOT be CTAs (no “click”, “buy”, “order”, “call”)
- Should NOT end with periods
GOOD EXAMPLES:
- “Free Shipping”
- “24/7 Support”
- “No Code Required”
- “30 Second Setup”
- “Award Winning”
BAD EXAMPLES (will be rejected):
- “Click Now” (CTA word)
- “Buy Today” (CTA word)
- “Free Shipping.” (ends with period)
Parameters:
- campaign_id: The campaign ID (REQUIRED). Get from list_campaigns.
- callouts: List of callout text strings (REQUIRED). Each max 25 chars.
- customer_id: Optional Google Ads customer ID
Execution time: 2-5 seconds
When to use:
- User wants to add callouts/highlights to their campaign
- User asks about extensions or ad enhancements
- After creating a campaign, suggest adding callouts
Example: User: “Add some callouts to my campaign” Agent:
- Uses list_campaigns to get campaign_id
- Uses add_callout_extensions with relevant callouts
Authorizations
API key from https://adspirer.ai/keys. Prefix sk_live_. Treat as a secret — never commit.
Headers
Client-generated UUID to make writes idempotent. Strongly recommended for write tools. A repeat call with the same key returns the cached result instead of re-executing. Example: 550e8400-e29b-41d4-a716-446655440000
Body
All tool arguments are wrapped in an arguments object. The fields accepted inside arguments are listed below — required fields are marked with a red asterisk.
Input schema for adding callout extensions to a campaign.
Callouts are short, non-clickable highlights that appear below your ad. They communicate quick trust signals and differentiators.
GOOD EXAMPLES: "Free Shipping", "24/7 Support", "No Code Required", "30 Second Setup" BAD EXAMPLES: "Click Now", "Buy Today" (these are CTAs, not allowed)
From google-ads-creative-guidelines.md:
- Max 25 characters each
- 4-8 callouts recommended
- Should NOT be CTAs (no "click", "buy", "order", "call")
- Should NOT end with periods
Response
Tool executed successfully. data.text carries the human-readable result (markdown-friendly). data.quota shows your current usage against the plan limit. data.structured appears when the tool emits machine-parseable structured content. data.content appears for tools that return non-text blocks (images, resources).
Returned on HTTP 200. data.text is the primary human-readable output. data.quota is always present for billable calls. data.structured is set only when the tool emits machine-parseable structured content. data.content is set only when the tool emits non-text content blocks.