Contents

API reference / Outreach

Propose offering a meeting link to someone who said yes

POST /api/v1/actions/{action}/meeting

propose_meeting_offer Write MCP tool

When the engine labels the person's reply interested, proposes a short reply holding the workspace's meeting link (Settings → Actions → Meeting link). It is the first link they see, and it goes only when a person approves it in the app, through the engine and in their thread; sending it twice never sends twice. `force` offers it when the reply is a yes the label missed.

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

Parameters

NameTypeDescription
action required
path
string The action's id.

Request body

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

NameTypeDescription
force boolean Offer it although the engine's label is not interested.

Returns

{ data: Action (kind meeting_offer, status proposed), approval }

Example

curl -X POST "https://sniffington.com/api/v1/actions/{action}/meeting" \
  -H "Authorization: Bearer $SCOUT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"force":true}'