Contents

API reference / Outreach

Draft the outreach email for an account's conversation

POST /api/v1/accounts/{account}/posts/{post}/outreach

draft_outreach Write MCP tool

For a ready conversation of a target account (the `post` of get_account or the end of a brief item's mention_id): one short email to the person who wrote it, quoting their own post word for word and linking nothing (no address, no domain: a link only comes after they reply), in the honest voice of the project that sells. The product facts it states are the project's fact sheet and description, nothing else. One model call, counted against the plan's drafts a day; a second only if the first breaks a rule, and a plain template if the second does too. Saved as a draft: nothing is sent, nothing is proposed. Refuses a post a bot or a company wrote, one the account already answered and one marked not relevant. The same conversation returns its draft again; redo writes it again.

A full-access key (ss_sk_…), or an editor or owner signed in.

Parameters

NameTypeDescription
account required
path
string The account's id.
post required
path
string The post's id.

Request body

JSON, sent with Content-Type: application/json.

NameTypeDescription
redo boolean Write the email again (only while it is still a draft).

Returns

{ data: Action (kind outreach, status draft), existing }

Example

curl -X POST "https://sniffington.com/api/v1/accounts/{account}/posts/{post}/outreach" \
  -H "Authorization: Bearer $SCOUT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"redo":true}'