> ## Documentation Index
> Fetch the complete documentation index at: https://snowseo.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Draft a Pitch

> Generate a personalized subject and body without sending an email.

Pass the prospect `id` and optionally an `emailId` from [Outreach Contacts](/docs/api-reference/endpoints/outreach-contacts#list-a-prospects-addresses). Omit `emailId` to use the prospect's primary address. Set `useMergeVars` if the returned copy should retain merge variables rather than substitute them.

The response is `{ subject, body }`. This costs 1 AI credit and sends nothing. Review the copy before [queueing a pitch](/docs/api-reference/endpoints/outreach-queue-pitches).


## OpenAPI

````yaml POST /v3/outreach/prospects/{id}/draft
openapi: 3.0.0
info:
  title: SnowSEO API
  description: API documentation for SnowSEO
  version: 1.0.0
servers:
  - url: https://api.snowseo.com
    description: Production server
security: []
tags:
  - name: Keywords
    description: Keyword research and suggestion end-points
  - name: Onboarding
    description: Brand onboarding and strategy end-points
  - name: Brands
    description: Brand management end-points
  - name: Organizations
    description: Organization and member end-points
  - name: Integrations
    description: Google Search Console and other integrations
  - name: Utilities
    description: Common utility end-points like screenshots and uploads
externalDocs:
  url: https://snowseo.com/docs
  description: Find more info here
paths:
  /v3/outreach/prospects/{id}/draft:
    post:
      tags:
        - Outreach
      summary: Draft a pitch email for a prospect
      description: >-
        Write a pitch for one prospect, personalised to the page it was found
        on. Returns a subject and body and sends nothing - pass them to
        outreach_queue_emails once the user has approved the wording. Costs AI
        credits.
      operationId: draftOutreachEmail
      parameters:
        - schema:
            type: string
          in: path
          name: id
          required: true
          description: Prospect ID.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                emailId:
                  type: string
                  description: >-
                    Which contact to write to, from outreach_prospect_emails.
                    Defaults to the prospect's primary address.
                useMergeVars:
                  type: boolean
                  description: >-
                    Leave merge variables unresolved in the returned copy
                    instead of substituting them.
      responses:
        '200':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  subject:
                    type: string
                  body:
                    type: string
                additionalProperties: true

````