Skip to main content

Deal model

Deals are entities for keeping track of your sales. You can manage them through API.

Properties​

AttributesTypeDescription
idinteger

A unique identifier for the deal which is given by User.com automatically.

custom_idstring

A unique identifier for the deal which is provided by the client.

activities_statusstringA status of an activity assigned to the user.
assigned_tointeger

A unique identifier for the agent which is given by User.com automatically.

company_idinteger

A unique identifier for the company which is given by User.com automatically.

created_atdatetimeA creation date of a deal.
currencyISO 4217 codeA currency of a deal.
expected_close_datedateA date when the deal is expected to be closed.
loss_reasonintegerA reason for a lost deal.
lost_atdatetimeA date when the deal has been marked as lost.
namestringA deal name.
participantsinteger(list)A list of user_ids assigned to a deal.
pipelineintegerAn id of a pipeline where the deal is assigned to.
productsinteger(list)A list of products' ids.
products_custom_idsstring(list)A list of products' ids.
stageintegerAn id of a stage of the pipeline the deal is currently at.
statusinteger

A status of your deal (0 - abandoned, 1 - in progress, 2 - won, 3 - lost, 4 - archived)

tagsstringA list of tags.
updated_atdatetimeA date of last deal update.
user_idinteger

A unique identifier for the user which is given by User.com automatically.

valuenumberA value of a deal.
won_atdatetimeA date when the deal has been marked as won.
order_productslist

A list of basic information per each ordered product which is provided by the client.
Those information have to contain:

  • product_id (integer) OR product_custom_id (string)
  • quantity (integer)
  • value (integer)
  • currency (string)