Docs menu
Get started
What is Opus GrowthQuickstartAdd to your AIHow it worksSafety and approvalCreditsPlansFAQAI apps
All AI appsChatGPTClaudeGrokPerplexityClaude CodeCodexGemini CLIOpenClawCursorVS CodeWindsurfOther MCPConnect ad platforms
Google AdsMeta AdsLinkedIn AdsMicrosoft AdvertisingTikTok AdsChatGPT AdsAgencies and MCCConnect data sources
Search ConsoleGoogle AnalyticsYouTubeBusiness ProfileTag ManagerWebsites and SEO
AI ServerWordPressSEO IntelligenceClick fraudTool reference
All toolsGoogle AdsMeta AdsTikTok AdsLinkedIn AdsMicrosoft AdvertisingChatGPT AdsSearch ConsoleGoogle AnalyticsYouTubeBusiness ProfileTag ManagerWordPressAI ServerSEO IntelligenceClick fraudCross-channelAccount and billingLanguage
Create Responsive Search Ad
Adds a Responsive Search Ad (RSA) to an ad group.
- Type
- Makes changes
- Credits
- 8
- Platform
- Google Ads
- Approval
- Preview first, applied after you approve
What it does
Adds a Responsive Search Ad (RSA) to an ad group. status: 'PAUSED' (default) | 'ENABLED'. NOTE: the ad's own status is INDEPENDENT of the campaign — a PAUSED ad stays paused even after the campaign is switched on, so a draft handed over with paused ads serves nothing until someone also enables them. When you are building a campaign for review, pass status='ENABLED': the campaign itself is created PAUSED, which already guarantees nothing spends, and the reviewer then needs a single campaign-level switch to go live. update_ad_status changes it later. At least 3 headlines, 2 descriptions. DISPLAY URL PATHS: path1 / path2 are the two segments shown after the domain — ftapi.com/sicherer/datenraum comes from path1="sicherer", path2="datenraum". Up to 15 characters each, no slashes; they do not have to exist as real pages. They are not decoration: the display URL is an expected-CTR signal, so an ad left on a bare domain is measurably weaker than the rest of the account. Optional: final_mobile_url (separate mobile landing page) and tracking_url_template (ad-level tracking template). PINNING: headline_pins / description_pins are optional lists in the SAME ORDER as headlines/descriptions; each entry pins that text to a fixed position — headline 1/2/3, description 1/2 (0 or empty = unpinned, Google rotates it). headline_pins lists a position per headline in the same order (1 pins that headline to position 1, 0 leaves it unpinned). Assets pinned to the same position compete only for that position; Google cannot fill the others. confirm=false → dry-run.
MCP: create_responsive_search_ad
How to use it
You don't call tools by name. Write what you want in ChatGPT, Claude or another assistant connected to Opus Growth, in your own words; it picks this tool when it fits.
Parameters
| Name | Type | Required | Default | |
|---|---|---|---|---|
| customer_id | string | Required | · | Google Ads customer account ID to query or change. Use the numeric ID returned by list_accounts; omit separators unless this tool explicitly says otherwise. |
| ad_group_id | string | Required | · | Exact ad group identifier to target. Use the ID returned by an Opus Growth list or create operation, not a display name. |
| final_url | string | Required | · | Final landing-page URL users should reach after clicking the ad. |
| headlines | array | Required | · | Ordered list of ad headline text variants, within the provider's character and policy requirements. |
| descriptions | array | Required | · | Ordered list of ad description text variants, within the provider's character and policy requirements. |
| headline_pins | array | Optional | · | Headline pins value for create responsive search ad. Follow the documented provider format and use values returned by Opus Growth discovery tools where possible. |
| description_pins | array | Optional | · | Description pins value for create responsive search ad. Follow the documented provider format and use values returned by Opus Growth discovery tools where possible. |
| path1 | string | Optional | · | First optional display-path segment for the ad's visible URL; do not include a slash. |
| path2 | string | Optional | · | Second optional display-path segment for the ad's visible URL; do not include a slash. |
| final_mobile_url | string | Optional | · | Final mobile url URL used by create responsive search ad. |
| tracking_url_template | string | Optional | · | Provider tracking-template string to apply to the selected campaign, ad group, or ad. |
| status | string | Optional | PAUSED | PAUSED · ENABLED · Desired provider status for this resource; choose an allowed value from this schema. |
| confirm | boolean | Optional | false | Safety confirmation for a state-changing operation. Leave false to preview or validate; set true only after the user explicitly approves the shown change. |
Related tools
account_auditAccount Snapshotaccount_snapshotAdd Keywordsadd_keywordsAdd Negative Keywordadd_negative_keywordAdd PMax Imagesadd_pmax_imagesApply Recommendationapply_recommendationBudget Pacing Alertsbudget_pacing_alertsCompetitor Adscompetitor_adsConnect Business Profileconnect_business_profile