Skip to main content
Prepare a prospect audit from a conversation: the assistant creates the audit and prepares prompts, you review them, and you confirm before any credit is used. This guide uses MCP. The REST API offers the same lifecycle in Create a Pitch Audit.

Before you start

Use an agency team on an active Business, Agency Business or Enterprise plan. Sign in as a Manager or Owner and grant read: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

  1. Call create_pitch_audit with the agency teamId, prospect url, market countryCode and promptCount: 30. Leave autoStartResponses off to review the questions first.
  2. Follow this audit ID until AWAITING_PROMPTS. Read the full draft and its current version with get_pitch_audit. Stop if the audit returns FAILED.
  3. 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, category and topic, to save_pitch_audit_prompts with the audit ID, the version just read as expectedVersion, and dryRun: true. A new draft requires 20 to 100 prompts.
  4. Approve the replacement. Repeat the save with the identical list and version, its confirmationToken, and dryRun omitted or false. The saved draft uses no credits. If its version has changed, read and review the draft again.
  5. Preview confirm_pitch_audit for the same audit with dryRun: true. Read the cost and warnings. Approve collection only if you agree to that amount. Repeat this tool call with its own token and dryRun omitted or false. Each token is single-use and valid for 10 minutes.
  6. Follow this audit ID to COMPLETED and open the report with get_pitch_audit. On FAILED, stop and inspect the audit in the dashboard. A REST integration can subscribe to pitch_audit.completed.
A draft with 30 prompts becomes a saved list of 28 after the first approval. A second approval starts the priced collection.

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.