Skip to content
Last updated

The deals object stores sales opportunities. It is extensible but cannot be deleted.

Standard fields

FieldTypeBehavior
NamestringRequired record title.
StageselectRequired pipeline stage. Defaults to Lead.
UsersprismaRelationAssigned Frontline account users.
Valuenumber (currency, USD)Deal monetary value.
Last Status ChangedateRead-only timestamp updated when Stage changes.

The default Stage options are Lead, In Progress, Won, and Lost. These options can be customized for the account.

Built-in relations

RelationTargetCardinality
PeoplepeopleMany-to-many
CompanycompaniesMany-to-one

The relations are already defined. Link records with the relation endpoints rather than creating replacement fields.

Pipeline behavior

Deals use a Kanban view grouped by Stage by default. The default view also includes a sum aggregation on Value.

Whenever Stage changes, Frontline updates Last Status Change automatically. Do not maintain a duplicate timestamp field through a workflow.

Example

frontline object record create deals --data '{
  "Name": "Acme expansion",
  "Stage": "Lead",
  "Value": 25000
}'

Inspect the live schema and Stage options before writing records:

frontline object schema deals
frontline object field list deals