Record an outreach outcome (becomes a learning label)

POST/outcomes

Requires scope: write:outcomes

Parameters

Parameter	In	Type	Description
`Idempotency-Key`	header	string	Stable caller event ID. Retrying it returns the original deal instead of recording the outcome twice.

Request body

Field	Type	Allowed values	Description
`store_id`required	string	any string
`action`required	string	`contactedrepliedcall_bookedproposalwonlost`
`value`	number	any number	Deal value, for won
`occurred_at`	string	any string
`note`	string	any string

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 "Content-Type: application/json" \
  -d '{
  "store_id": "b7c9a2e1-0000-4000-8000-000000000000",
  "action": "contacted",
  "value": 0,
  "occurred_at": "2026-07-06T12:00:00Z",
  "note": "string"
}'

Response (200)

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