Skip to main content
POST
Record insights
Records what a call or email taught you about your own business. Send every insight from one source in one call. Facts about the account itself belong in a note. category is one of product, positioning, market, or buyer. Near-duplicates of existing insights are skipped, so written can be lower than submitted.

Authorizations

Authorization
string
header
required

Workspace API key. Create one in Settings → API keys.

Body

application/json
insights
object[]
required
Minimum array length: 1
source_label
string

Where these came from, for example Acme discovery call.

occurred_at
string<date-time>

Response

How many were written.

written
integer

Insights written. Lower than submitted when some were duplicates or had an unknown category.

submitted
integer

Insights that passed validation.