sfdcCreateOpportunity
Syntax
sfdcCreateOpportunity(sfdcConnection, sfdcOpportunity, [sfdcAPIVersion])
Description
Creates an opportunity in the Salesforce environment.
Parameters
Parameter | Type | Required | Description |
---|---|---|---|
sfdcConnection | Yes | Salesforce connection - it is the object resulted from the call to the connectToSalesforce function | |
sfdcOpportunity | Yes | Structure containing the fields of the opportunity that will be created. This is a predefined structure type described below. When creating an opportunity, there are three required fields that must have values: Name, CloseDate, and StageName. | |
sfdcAPIVersion | string | No | The Salesforce API version to be called when creating the opportunity, it should have the following form: "vXX.X" - eg: "v43.0", "v42.0". |
SFDCOpportunity fields and types
Note
CloseDate, Name, and StageName attributes are required when creating a new SFDCOpportunity type. See SFDCOpportunity for more details.
Return type
string - the Salesforce Opportunity ID
Example
The following example will create an opportunity in Salesforce with the specified fields.
SFDCConnection conn = connectToSalesforce("SFDC_test");
logPrint("WARN", "Connected to SF: " + conn.instance_url + " - " + conn.access_token);
SFDCOpportunity opp;
opp.Name = "Test Opp using function";
opp.CloseDate = currentDate();
opp.StageName = "Prospecting";
string oppId = sfdcCreateOpportunity(conn, opp, "v43.0");
logPrint("WARN", "Created opportunity with id: " + oppId);