Add Sitelinks
Add sitelink extensions to a campaign.
Sitelinks are clickable links to specific pages on your website. Recommended 4-6 sitelinks per campaign.
CONSTRAINTS:
- link_text max 25 characters
- description1 max 35 characters (optional)
- description2 max 35 characters (required if description1 is set)
EXAMPLE SITELINKS:
{
“link_text”: “How It Works”,
“final_url”: “https://example.com/how-it-works”,
“description1”: “See the platform in action”,
“description2”: “Step-by-step walkthrough”
}
{
“link_text”: “Pricing”,
“final_url”: “https://example.com/pricing”,
“description1”: “Affordable plans for all”,
“description2”: “Start free today”
}
Parameters:
- campaign_id: The campaign ID (REQUIRED). Get from list_campaigns.
- sitelinks: List of sitelink objects with link_text, final_url, and optional descriptions.
- customer_id: Optional Google Ads customer ID
Execution time: 2-5 seconds
When to use:
- User wants to add sitelinks to their campaign
- User asks about adding more links to ads
- After creating a campaign, suggest adding sitelinks
Example: User: “Add sitelinks to my campaign” Agent:
- Uses list_campaigns to get campaign_id
- Uses add_sitelinks with relevant page links
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 sitelink extensions to a campaign.
Sitelinks are clickable links to specific pages on your website. Recommended 4-6 sitelinks per campaign.
EXAMPLE: { "link_text": "How It Works", "final_url": "https://example.com/how-it-works", "description1": "See the platform in action", "description2": "Step-by-step walkthrough" }
Constraints:
- link_text max 25 characters
- description1 max 35 characters (optional)
- description2 max 35 characters (required if description1 set)
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.