This function creates a new record in a Salesforce object. The Salesforce 18-digit object identifier is returned by the function.

NOTE: This function can only be used to create records in standard or custom Salesforce objects, not other objects such as big objects or external objects.



Ordinal Type Required Description
1 String True API name of the Salesforce object
2 Integer True Number of fields inserted when creating the record
3 String True API field name
4 String, integer or Boolean True Value to insert
5a String False Additional API field name (see note)
5b String, integer or Boolean False Additional value to insert (see note)

NOTE: Additional API field name and value pairs can be appended as arguments. The quantity of pairs should match parameter 2.


The following code is used on a landing page for a Lead Capture form. When the user completes the form, the CreateSalesforceObject function creates a new Lead record in Sales Cloud from the form field values and displays the 18-digit Salesforce identifier of the new record on the page.


if RequestParameter("submitted") == true then

  var @createLead
  set @createLead = CreateSalesforceObject(
        "Lead", 4,
        "FirstName", RequestParameter("firstname"),
        "LastName", RequestParameter("lastname"),
        "Company", RequestParameter("company"),
        "Email", RequestParameter("email")


<!DOCTYPE html>
      %%[ if not empty(@createLead) then ]%%
         <p>%%=v(@createLead)=%% record created in Lead Object</p>
      %%[ endif ]%%
      <form action="%%=RequestParameter('PAGEURL')=%%" method="post">
         <label>First name</label>
         <input type="text" name="firstname">
         <label>Last name</label>
         <input type="text" name="lastname">
         <input type="text" name="company">
         <input type="text" name="email">
         <input name="submitted" type="hidden" value="true" />
         <input type="submit" value="Submit">


The following element will be displayed on the page, before the form. 00Q6F00001APnymUAD is the Salesforce identifier of the new record.

<p>00Q6F00001APnymUAD record created in Lead Object</p>