Skip to main content
POST
Draft a pitch email for a prospect
Pass the prospect id and optionally an emailId from Outreach Contacts. Omitting emailId does not fall back to the primary address: the draft is then written to the site rather than a named person. 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. A 400 means teamId is missing or your brand name is not set in settings. Review the copy before queueing a pitch.

Authorizations

Authorization
string
header
required

Your SnowSEO API key (sk_...).

Path Parameters

id
string
required

Prospect ID.

Body

application/json
emailId
string

Which contact to write to, from outreach_prospect_emails. Omit it to write to the site rather than a named person.

useMergeVars
boolean

Leave merge variables unresolved in the returned copy instead of substituting them.

Response

200 - application/json

Default Response

subject
string
body
string