Record an outreach outcome (becomes a learning label)

POST/outcomes

Requires scope: write:outcomes

Parameters

Parameter	In	Type	Description
`Idempotency-Key`required	header	string	Stable logical request ID required for every machine mutation; exact retries replay and changed inputs conflict.

Request body

Field	Type	Allowed values	Description
`store_id`required	string	any string
`action`required	string	`discoveryqualifyingproposalnegotiationwonlost`
`value`	number	any number	Deal value, for won
`occurred_at`	string	any string
`note`	string	any string
`lost_reason`	string	`no_responsetimingbudgetchose_another_agencyproject_cancellednot_a_fitother`	Required when action is lost
`lost_reason_other`	string	any string	Required when lost_reason is other

Responses

Status	Description
`200`	Recorded
`400`	Invalid body
`401`	Missing or invalid API key
`403`	Key lacks the required scope
`429`	Rate limit exceeded (see Retry-After)

Is this page helpful?

Request

curl -X POST "https://vergio.ai/api/v1/outcomes" \
  -H "Authorization: Bearer $VERGIO_API_KEY" \
  -H "Idempotency-Key: replace-with-a-stable-request-id" \
  -H "Content-Type: application/json" \
  -d '{
  "store_id": "b7c9a2e1-0000-4000-8000-000000000000",
  "action": "discovery",
  "value": 0,
  "occurred_at": "2026-07-06T12:00:00Z",
  "note": "string",
  "lost_reason": "no_response",
  "lost_reason_other": "string"
}'

Response (200)

{
  "ok": true,
  "deal_id": "string",
  "created": true
}