Before you start
Use an agency team on an active Business, Agency Business or Enterprise plan. Sign in as a Manager or Owner and grantread:pitch-audits and write:pitch-audits. If the assistant looks up your team with list_brands, also grant read:brands. You can instead supply the team ID. See OAuth authentication.
Steps
- Call
create_pitch_auditwith the agencyteamId, prospecturl, marketcountryCodeandpromptCount: 30. LeaveautoStartResponsesoff to review the questions first. - Follow this audit ID until
AWAITING_PROMPTS. Read the full draft and its currentversionwithget_pitch_audit. Stop if the audit returnsFAILED. - Review all 30 prompts with the prospect in mind. In this example you remove two. Send all 28 retained prompt objects, including their
id,text,categoryandtopic, tosave_pitch_audit_promptswith the audit ID, the version just read asexpectedVersion, anddryRun: true. A new draft requires 20 to 100 prompts. - Approve the replacement. Repeat the save with the identical list and version, its
confirmationToken, anddryRunomitted orfalse. The saved draft uses no credits. If its version has changed, read and review the draft again. - Preview
confirm_pitch_auditfor the same audit withdryRun: true. Read the cost and warnings. Approve collection only if you agree to that amount. Repeat this tool call with its own token anddryRunomitted orfalse. Each token is single-use and valid for 10 minutes. - Follow this audit ID to
COMPLETEDand open the report withget_pitch_audit. OnFAILED, stop and inspect the audit in the dashboard. A REST integration can subscribe topitch_audit.completed.
Example conversation
You ask for 30 prompts about the US market for prospect.example. After reviewing them, you approve saving 28. The assistant shows you the cost of collecting answers for those 28. You can stop with the draft saved or give a second approval to start collection.Limits
- Retrying a failed audit and exporting a report remain dashboard actions.
- Content from the prospect website can reach the assistant through the report. Read previews before you confirm. See Security.

