Deals
Stores sales opportunities with fields for stage, amount, probability, and related accounts or contacts.
Table-Specific Information
Select
This table supports COQL for filtering, meaning that most filters comparing columns to values are submitted server-side.
Insert
INSERT INTO Deals (DealName, Stage) VALUES ('Converting company XYZ into our client.', 'Qualification')
Required fields: DealName.
Any field which is not read-only (ReadOnly = false in the table below) can be inserted.
Delete
You must specify the Id in the WHERE clause when executing a delete against this table.
DELETE FROM Deals WHERE Id = '3152079000000153079'
Update
You must specify the Id in the WHERE clause when executing an update against this table.
UPDATE Deals SET Description = 'Updated from API' WHERE Id = '3152079000000153079'
Required fields: Id.
Any field which is not read-only (ReadOnly = false in the table below) can be updated.
Columns
| Name | Type | ReadOnly | Description |
| Id [KEY] | String | True |
Unique identifier for the deal record. |
| DealOwner_Id | String | False |
Identifier of the user who owns the deal. |
| DealOwner_FirstName | String | True |
First name of the user who owns the deal. |
| DealOwner_LastName | String | True |
Last name of the user who owns the deal. |
| DealOwner_Email | String | True |
Email address of the user who owns the deal. |
| DealOwner_Name | String | True |
Full name of the user who owns the deal. |
| Amount | Decimal | False |
Monetary value associated with the deal. |
| DealName | String | False |
Name assigned to the deal. |
| ClosingDate | Date | False |
Expected closing date for the deal. |
| AccountName_Id | String | False |
Identifier of the associated account. |
| AccountName_Name | String | True |
Name of the associated account. |
| Stage | String | False |
Current stage of the deal in the sales pipeline. |
| Type | String | False |
Type classification for the deal. |
| Probability(%) | Int | False |
Probability percentage of successfully closing the deal. |
| ExpectedRevenue | Decimal | True |
Projected revenue based on the deal's probability and amount. |
| NextStep | String | False |
Planned next step for progressing the deal. |
| LeadSource | String | False |
Source from which the deal originated. |
| CampaignSource_Id | String | False |
Identifier of the related marketing campaign. |
| CampaignSource_Name | String | True |
Name of the related marketing campaign. |
| ContactName_Id | String | False |
Identifier of the associated contact. |
| ContactName_Name | String | True |
Name of the associated contact. |
| CreatedBy_Id | String | False |
Identifier of the user who created the deal record. |
| CreatedBy_FirstName | String | True |
First name of the user who created the deal record. |
| CreatedBy_LastName | String | True |
Last name of the user who created the deal record. |
| CreatedBy_Email | String | True |
Email address of the user who created the deal record. |
| CreatedBy_Name | String | True |
Full name of the user who created the deal record. |
| ModifiedBy_Id | String | False |
Identifier of the user who last modified the deal record. |
| ModifiedBy_FirstName | String | True |
First name of the user who last modified the deal record. |
| ModifiedBy_LastName | String | True |
Last name of the user who last modified the deal record. |
| ModifiedBy_Email | String | True |
Email address of the user who last modified the deal record. |
| ModifiedBy_Name | String | True |
Full name of the user who last modified the deal record. |
| CreatedTime | Datetime | False |
Date and time when the deal record was created. |
| ModifiedTime | Datetime | False |
Date and time when the deal record was last modified. |
| LastActivityTime | Datetime | True |
Timestamp of the most recent activity related to the deal. |
| LeadConversionTime | Int | True |
Number of days between lead creation and conversion. |
| SalesCycleDuration | Int | True |
Number of days the deal remained in the sales pipeline. |
| OverallSalesDuration | Int | True |
Total duration of the deal from lead creation to closure. |
| Tag | String | False |
Tags assigned to the deal for classification or filtering. |
| Description | String | False |
Additional information or notes about the deal. |
| ChangeLogTime | Datetime | True |
Timestamp of the last change made to the deal. |
| Locked | Bool | True |
Indicates whether the deal record is locked from updates. |
| ReasonForLoss | String | False |
Explanation for why the deal was marked as lost. |
Pseudo-Columns
Pseudo column fields are used in the WHERE clause of SELECT statements and offer a more granular control over the tuples that are returned from the data source.
| Name | Type | Description |
| DuplicateCheckFields | String |
Fields used to identify duplicate records during an upsert operation. The REST API allows multiple fields while the BULK API supports only one. |
| Trigger | String |
Specifies whether to activate automation rules when inserting the record. |
| CustomViewId | Long |
Custom view identifier used for filtering this record. Applies when the useCOQL parameter is set to false. |