create_audit_cta
create_audit_cta MCP tool: add a call-to-action to the workspace, to use on teased sections of GEO Audit reports.
Updated 2026-11-05
create_audit_cta adds a CTA to the workspace: the overlay shown on the teased sections of a shared GEO Audit report.
When to use
Before launching an audit with a teaser, when list_audit_ctas has no CTA that fits. CTAs are reused across audits.
Input
| Field | Type | Default | Description |
|---|---|---|---|
name |
string | required | Internal label, unique in the workspace, 60 characters at most |
title |
string | required | Headline of the overlay, 120 characters at most |
description |
string | none | Sub-headline, 280 characters at most |
buttonLabel |
string | required | Button text, 40 characters at most |
buttonUrl |
string | required | Button destination, http or https |
Response
{
"success": true,
"cta": {
"id": "clx_cta_1",
"name": "Discovery call",
"title": "Want the full report?",
"description": "Book a 20-minute call and we'll walk you through it.",
"buttonLabel": "Book a call",
"buttonUrl": "https://cal.com/agency/discovery",
"createdAt": "2026-11-05T09:00:00.000Z"
}
}
Errors: name_already_used, audits_unavailable (needs an active Agency plan, audits enabled and an admin API key).
Tips and patterns
- Use it at launch: pass the
idasconfig.ctaIdwithconfig.teaserSectionsinrun_geo_audit. - Use it afterwards: pass the
idtoset_geo_audit_section_visibility.
Related tools
- list_audit_ctas: the workspace's CTAs.
- update_audit_cta: change a CTA.
- run_geo_audit: launch an audit with this CTA.