Salesforce REST Connector Reference¶ The following operations allow you to work with the Salesforce REST Connector. Click an operation name to see parameter details and samples on how to use it. Initialize the connector¶ Salesforce REST API uses the OAuth protocol to allow application users to securely access data without having to reveal their user credentials. For more information on how authentication is done in Salesforce, see Understanding Authentication. You can provide only access token and use it until it expires. After expiry, you will be responsible for getting a new access token and using it. Alternatively, you have the option of providing refresh token, client secret, and client ID which will be used to get access token initially and after every expiry by the connector itself. You will not be required to handle access token expiry in this case. There also option to use basic authentication with username and password. To use the Salesforce REST connector, add the <salesforcerest.init> element in your configuration before carrying out any other Salesforce REST operations. salesforcerest.initThe salesforcerest.init operation initializes the connector to interact with the Salesforce REST API. See the related API documentation for more information. Parameter Name Description Required Sample Value apiVersion The version of the Salesforce API. Yes v32.0 accessToken The access token to authenticate your API calls. No XXXXXXXXXXXX (Replace with your access token) apiUrl The instance URL for your organization. Yes https://ap2.salesforce.com hostName SalesforceOAuth endpoint when issuing authentication requests in your application. Yes https://login.salesforce.com refreshToken The refresh token that you received to refresh the API access token. No XXXXXXXXXXXX (Replace with your refresh token) tokenEndpointHostname The endpoint of the refresh token that you invoke to refresh the API access token. No XXXXXXXXXXXX (Replace this with your refresh token endpoint) clientId The consumer key of the connected application that you created. No XXXXXXXXXXXX (Replace with your client ID) clientSecret The consumer secret of the connected application that you created. No XXXXXXXXXXXX (Replace with your client secret) blocking Indicates whether the connector needs to perform blocking invocations to Salesforce. Yes false Sample configuration <salesforcerest.init> <accessToken>{$ctx:accessToken}</accessToken> <apiUrl>{$ctx:apiUrl}</apiUrl> <hostName>{$ctx:hostName}</hostName> <apiVersion>{$ctx:apiVersion}</apiVersion> <blocking>{$ctx:blocking}</blocking> </salesforcerest.init> Sample request { "hostName": "https://login.salesforce.com", "apiVersion": "v32.0", "accessToken":"XXXXXXXXXXXX (Replace with your access token)", "apiUrl":"https://(your_instance).salesforce.com", "blocking" : "false" } Or if you want conector to handle token expiry Sample configuration <salesforcerest.init> <accessToken>{$ctx:accessToken}</accessToken> <apiUrl>{$ctx:apiUrl}</apiUrl> <hostName>{$ctx:hostName}</hostName> <apiVersion>{$ctx:apiVersion}</apiVersion> <refreshToken>{$ctx:refreshToken}</refreshToken> <clientId>{$ctx:clientId}</clientId> <clientSecret>{$ctx:clientSecret}</clientSecret> <blocking>{$ctx:blocking}</blocking> </salesforcerest.init> Sample request { "hostName": "https://login.salesforce.com", "apiVersion": "v32.0", "refreshToken":"XXXXXXXXXXXX (Replace with your refresh token)", "apiUrl":"https://(your_instance).salesforce.com", "clientId": "XXXXXXXXXXXX (Replace with your client ID)", "clientSecret": "XXXXXXXXXXXX (Replace with your client secret)", "blocking" : "false" } salesforcerest.init for username/password flowThe salesforcerest.init operation initializes the connector to interact with the Salesforce REST API using a username/password flow. See the related API documentation for more information. Parameter Name Description Required Sample Value apiVersion The version of the Salesforce API. Yes v32.0 apiUrl The instance URL for your organization. Yes https://ap2.salesforce.com hostName SalesforceOAuth endpoint when issuing authentication requests in your application. Yes https://login.salesforce.com clientId The consumer key of the connected application that you created. Yes XXXXXXXXXXXX (Replace with your client ID) clientSecret The consumer secret of the connected application that you created. Yes XXXXXXXXXXXX (Replace with your client secret) username The username for Salesforce. Yes [email protected] password The password for Salesforce (need to append the password with security key). Yes xxxxxxxxxxxxxxxxxxxxxx blocking Indicates whether the connector needs to perform blocking invocations to Salesforce. Yes false Sample configuration <salesforcerest.init> <apiUrl>{$ctx:apiUrl}</apiUrl> <clientId>{$ctx:clientId}</clientId> <clientSecret>{$ctx:clientSecret}</clientSecret> <hostName>{$ctx:hostName}</hostName> <apiVersion>{$ctx:apiVersion}</apiVersion> <username>{$ctx:username}</username> <password>{$ctx:password}</password> <blocking>{$ctx:blocking}</blocking> </salesforcerest.init> Sample request { "clientId": "xxxxxxxxxxxxxxxxxxxxxxxx", "clientSecret": "xxxxxxxxxxxxxxxxxxxxxxxx", "hostName": "https://login.salesforce.com", "apiVersion": "v32.0", "username": "[email protected]", "password": "xxxxxxxxxxxxxxxxxxxxxx", "apiUrl":"https://(your_instance).salesforce.com", "blocking" : "false" } AppMenu¶ listItemsInMenuTo retrieve the list of items in either the Salesforce app drop-down menu or the Salesforce1 navigation menu, use salesforcerest.listItemsInMenu and specify the following property. See the related API documentation for more information. Parameter Name Description Required Sample Value menuType The type of the menu, either AppSwitcher or Salesforce. Yes AppSwitcher, Salesforce Sample configuration <salesforcerest.listItemsInMenu> <menuType>{$ctx:menuType}</menuType> </salesforcerest.listItemsInMenu> Sample request { "accessToken":"XXXXXXXXXXXX (Replace with your access token)", "apiUrl":"https://(your_instance).salesforce.com", "hostName": "https://login.salesforce.com", "apiVersion": "v32.0", "menuType": "AppSwitcher", } Sample response {"NetworkTabs":"/services/data/v32.0/appMenu/NetworkTabs","Salesforce1":"/services/data/v32.0/appMenu/Salesforce1","AppSwitcher":"/services/data/v32.0/appMenu/AppSwitcher"} tabsTo retrieve a list of all tabs, use salesforcerest.tabs. See the related API documentation for more information. Sample configuration <salesforcerest.tabs/> Sample request The following is a sample request that can be handled by the tabs operation. { "accessToken":"XXXXXXXXXXXX (Replace with your access token)", "apiUrl":"https://(your_instance).salesforce.com", "hostName": "https://login.salesforce.com", "apiVersion": "v32.0", } Sample response Given below is a sample response for the tabs operation. {"output":"[{\"colors\":[{\"color\":\"4dca76\",\"context\":\"primary\",\"theme\":\"theme4\"},{\"color\":\"319431\",\"context\":\"primary\",\"theme\":\"theme3\"}],\"custom\":true,\"iconUrl\":\"https://sampletest-dev-ed.my.salesforce.com/img/icon/form32.png\",..} themesTo retrieve a list of icons and colors used by themes in the Salesforce application, use salesforcerest.themes. See the related API documentation for more information. Sample configuration <salesforcerest.themes/> Sample request The following is a sample request that can be handled by the themes operation. { "accessToken":"XXXXXXXXXXXX (Replace with your access token)", "apiUrl":"https://(your_instance).salesforce.com", "hostName": "https://login.salesforce.com", "apiVersion": "v32.0", } Sample response Given below is a sample response for the themes operation. { "themeItems":[ { "name":"Account", "icons":[ { "width":32, "theme":"theme3", "contentType":"image/png", "url":"https://kesavan-dev-ed.my.salesforce.com/img/icon/accounts32.png", "height":32 } ] } ] } Approvals¶ listApprovalsTo retrieve the list of approvals in Salesforce, use salesforcerest.listApprovals. See the related API documentation for more information. Sample configuration <salesforcerest.listApprovals/> Sample request The following is a sample request that can be handled by the listApprovals operation. { "accessToken":"XXXXXXXXXXXX (Replace with your access token)", "apiUrl":"https://(your_instance).salesforce.com", "hostName": "https://login.salesforce.com", "apiVersion": "v32.0", } Sample response Given below is a sample response for the listApprovals operation. { "approvals":{ } } Event Monitoring¶ describeEventMonitoringTo retrieve the description of the event monitoring log, use salesforcerest.describeEventMonitoring. See the related API documentation for more information. Sample configuration <salesforcerest.describeEventMonitoring/> Sample request The following is a sample request that can be handled by the describeEventMonitoring operation. { "accessToken":"XXXXXXXXXXXX (Replace with your access token)", "apiUrl":"https://(your_instance).salesforce.com", "hostName": "https://login.salesforce.com", "apiVersion": "v32.0", } Sample response Given below is a sample response for the describeEventMonitoring operation. { "updateable":false, "activateable":false, "childRelationships":[ ], "recordTypeInfos":[ ], "deprecatedAndHidden":false, "searchLayoutable":false, "deletable":false, "replicateable":false, "actionOverrides":[ ], . . ], "labelPlural":"Event Log Files", "triggerable":false } queryEventMonitoringDataTo retrieve the field values from a record, use salesforcerest.queryEventMonitoringData and specify the following properties. See the related API documentation for more information. Parameter Name Description Required Sample Value queryStringForEventMonitoringData The query string to use to get the field values from the log. Yes SELECT+Id+,+EventType+,+LogFile+,+LogDate+,+LogFileLength+FROM+EventLogFile+WHERE+LogDate+>+Yesterday+AND+EventType+=+'API' Sample configuration <salesforcerest.queryEventMonitoringData> <queryStringForEventMonitoringData>{$ctx:queryStringForEventMonitoringData}</queryStringForEventMonitoringData> </salesforcerest.queryEventMonitoringData> Sample request The following is a sample request that can be handled by the queryEventMonitoringData operation. { "accessToken":"XXXXXXXXXXXX (Replace with your access token)", "apiUrl":"https://(your_instance).salesforce.com", "clientId": "3MVG9ZL0ppGP5UrBztM9gSLYyUe7VwAVhD9.yQnZX2mmCu_48Uwc._doxrBTgY4jqmOSDhxRAiUBf8gCr2mk7", "refreshToken": "5Aep861TSESvWeug_ztpnAk6BGQxRdovMLhHso81iyYKO6hTm45JVxz3FLewCKgI4BbUp19OzGfqG2TdCfqa2ZU", "clientSecret": "1187341468789253319", "hostName": "https://login.salesforce.com", "apiVersion": "v34.0", "queryStringForEventMonitoringData": "SELECT+Id+,+EventType+,+LogFile+,+LogDate+,+LogFileLength+FROM+EventLogFile+WHERE+LogDate+>+Yesterday+AND+EventType+=+'API'", } Sample response Given below is a sample response for the queryEventMonitoringData operation. { "totalSize" : 4, "done" : true, "records" : [ { "attributes" : { "type" : "EventLogFile", "url" : "/services/data/v32.0/sobjects/EventLogFile/0ATD000000001bROAQ" } "Id" : "0ATD000000001bROAQ", "EventType" : "API", "LogFile" : "/services/data/v32.0/sobjects/EventLogFile/0ATD000000001bROAQ/LogFile", "LogDate" : "2014-03-14T00:00:00.000+0000", "LogFileLength" : 2692.0 }, . ] } Invocable Actions¶ getListOfActionTo retrieve the list of general action types for the current organization, use salesforcerest.getListOfAction and specify the following properties. See the related API documentation for more information. Parameter Name Description Required actionType The type of the invocable action. Yes Sample configuration <salesforcerest.getListOfAction/> Sample request The following is a sample request that can be handled by the getListOfAction operation. { "accessToken":"XXXXXXXXXXXX (Replace with your access token)", "apiUrl":"https://(your_instance).salesforce.com", "hostName": "https://login.salesforce.com", "apiVersion": "v32.0", } Sample response Given below is a sample response for the getListOfAction operation. { "standard":"/services/data/v32.0/actions/standard", "custom":"/services/data/v32.0/actions/custom" } getSpecificListOfActionTo retrieve an attribute of a single action, use salesforcerest.getAttributeOfSpecificAction and specify the following properties. See the related API documentation for more information. Parameter Name Description Required Sample Value actionType The type of the invocable action. Yes standard Sample configuration <salesforcerest.getSpecificListOfAction> <actionType>{$ctx:actionType}</actionType> </salesforcerest.getSpecificListOfAction> Sample request The following is a sample request that can be handled by the getSpecificListOfAction operation. { "accessToken":"XXXXXXXXXXXX (Replace with your access token)", "apiUrl":"https://(your_instance).salesforce.com", "hostName": "https://login.salesforce.com", "apiVersion": "v32.0", "actionType": "standard", } Sample response Given below is a sample response for the getSpecificListOfAction operation. { "standard":"/services/data/v32.0/actions/standard", "custom":"/services/data/v32.0/actions/custom" } getAttributeOfSpecificActionTo retrieve an attribute of a single action, use salesforcerest.getAttributeOfSpecificAction and specify the following properties. See the related API documentation for more information. Parameter Name Description Required Sample Value actionType The type of the invocable action. Yes standard attribute The attribute whose details you want to retrieve. Yes emailSimple Sample configuration <salesforcerest.getAttributeOfSpecificAction> <actionType>{$ctx:actionType}</actionType> <attribute>{$ctx:attribute}</attribute> </salesforcerest.getAttributeOfSpecificAction> Sample request The following is a sample request that can be handled by the getAttributeOfSpecificAction operation. { "accessToken":"XXXXXXXXXXXX (Replace with your access token)", "apiUrl":"https://(your_instance).salesforce.com", "hostName": "https://login.salesforce.com", "apiVersion": "v32.0", "actionType": "standard", "attribute": "emailSimple", } Sample response Given below is a sample response for the getAttributeOfSpecificAction operation. { "actions":[ { "name":"chatterPost", "label":"Post to Chatter", "type":"CHATTERPOST" }, { "name":"emailSimple", "label":"Send Email", "type":"EMAILSIMPLE" } . ] } Layouts¶ sObjectLayoutsTo retrieve a list of layouts and descriptions (including for actions) for a specific object, use salesforcerest.sObjectLayouts and specify the following properties. See the related API documentation for more information. Parameter Name Description Required Sample Value sObjectName The type of object whose layouts and descriptions you want to retrieve. Yes Account Sample configuration <salesforcerest.sObjectLayouts> <sObjectName>{$ctx:sObjectName}</sObjectName> </salesforcerest.sObjectLayouts> Sample request The following is a sample request that can be handled by the sObjectLayouts operation. { "accessToken":"XXXXXXXXXXXX (Replace with your access token)", "apiUrl":"https://(your_instance).salesforce.com", "hostName": "https://login.salesforce.com", "apiVersion": "v32.0", "sObjectName": "Account", } Sample Response Given below is a sample response for the sObjectLayouts operation. "layouts":[ { "detailLayoutSections":[ { "heading":"Account Information", "columns":2, "tabOrder":"TopToBottom", "useCollapsibleSection":false, "rows":8, "useHeading":false, "layoutRows":[ { "layoutItems":[ { "editableForUpdate":false, "editableForNew":false, "layoutComponents":[ { "tabOrder":1, "details":{ "defaultValue":null, "precision":0, "nameField":false, "type":"reference", "restrictedDelete":false, "relationshipName":"Owner", "calculatedFormula":null, "controllerName":null, "namePointing":false, "defaultValueFormula":null, "calculated":false, "writeRequiresMasterRead":false, "inlineHelpText":null, "picklistValues":[ ] } } ] } . } globalSObjectLayoutsTo retrieve descriptions of global publisher layouts, use salesforcerest.globalSObjectLayouts. See the related API documentation for more information. Sample configuration <salesforcerest.globalSObjectLayouts/> Sample request The following is a sample request that can be handled by the globalSObjectLayouts operation. { "accessToken":"XXXXXXXXXXXX (Replace with your access token)", "apiUrl":"https://(your_instance).salesforce.com", "hostName": "https://login.salesforce.com", "apiVersion": "v32.0", } Sample Response Given below is a sample response for the globalSObjectLayouts operation. { "layouts":[ { "detailLayoutSections":[ ], "relatedContent":null, "editLayoutSections":[ ], "relatedLists":[ ], "buttonLayoutSection":null, "id":"00h28000001hExeAAE", "offlineLinks":[ ], . . } } compactLayoutsTo retrieve a list of compact layouts for multiple objects, use salesforcerest.compactLayouts and specify the following properties. See the related API documentation for more information. Parameter Name Description Required sObjectNameList A comma-separated list of the objects whose compact layouts you want to retrieve. Yes Sample configuration <salesforcerest.compactLayouts/> Sample request The following is a sample request that can be handled by the compactLayouts operation. { "accessToken":"XXXXXXXXXXXX (Replace with your access token)", "apiUrl":"https://(your_instance).salesforce.com", "hostName": "https://login.salesforce.com", "apiVersion": "v32.0", "sObjectNameList":"Account,User", } Sample Response Given below is a sample response for the compactLayouts operation. { "Account":{ "name":"SYSTEM", "id":null, "label":"System Default", "actions":[ { "showsStatus":false, "custom":false, "label":"Call", "overridden":false, "encoding":null, "icons":[ { "width":0, "theme":"theme4", "contentType":"image/svg+xml", "url":"https://kesavan-dev-ed.my.salesforce.com/img/icon/t4v32/action/call.svg", "height":0 }, ], "windowPosition":null, "colors":[ { "color":"F2CF5B", "context":"primary", "theme":"theme4" } ], . . ], "objectType":"User" } } sObjectApprovalLayoutsTo retrieve a list of approval layouts for a specified object, use salesforcerest.sObjectApprovalLayouts and specify the following properties. See the related API documentation for more information. Parameter Name Description Required Sample Value sObjectName The type of object whose layouts you want to retrieve. Yes Account Sample configuration <salesforcerest.sObjectApprovalLayouts> <sObjectName>{$ctx:sObjectName}</sObjectName> </salesforcerest.sObjectApprovalLayouts> Sample request The following is a sample request that can be handled by the sObjectApprovalLayouts operation. { "accessToken":"XXXXXXXXXXXX (Replace with your access token)", "apiUrl":"https://(your_instance).salesforce.com", "hostName": "https://login.salesforce.com", "apiVersion": "v32.0", "sObjectName":"Account", } Sample Response Given below is a sample response for the sObjectApprovalLayouts operation. {"approvalLayouts":[]} sObjectCompactLayoutsTo retrieve a list of compact layouts for a specific object, use salesforcerest.sObjectCompactLayouts and specify the following properties. See the related API documentation for more information. Parameter Name Description Required Sample Value sObjectName The type of object whose layouts you want to retrieve. Yes Account Sample configuration <salesforcerest.sObjectCompactLayouts> <sObjectName>{$ctx:sObjectName}</sObjectName> </salesforcerest.sObjectCompactLayouts> Sample request The following is a sample request that can be handled by the sObjectCompactLayouts operation. { "accessToken":"XXXXXXXXXXXX (Replace with your access token)", "apiUrl":"https://(your_instance).salesforce.com", "hostName": "https://login.salesforce.com", "apiVersion": "v32.0", "sObjectName":"Account", } Sample Response Given below is a sample response for the sObjectCompactLayouts operation. { "compactLayouts":[ { "name":"SYSTEM", "id":null, "label":"System Default", "actions":[ { "showsStatus":false, "custom":false, "label":"Call", "overridden":false, "encoding":null, "icons":[ { "width":0, "theme":"theme4", "contentType":"image/svg+xml", "url":"https://kesavan-dev-ed.my.salesforce.com/img/icon/t4v32/action/call.svg", "height":0 } ], "defaultCompactLayoutId":null . ] } sObjectNamedLayoutsTo retrieve information about alternative named layouts for a specific object, use salesforcerest.sObjectNamedLayouts and specify the following properties. See the related API documentation for more information. Parameter Name Description Required Sample Value sObjectName The type of object whose layouts you want to retrieve. Yes Account layoutName The type of layout. Yes UserAlt Sample configuration <salesforcerest.sObjectNamedLayouts> <sObjectName>{$ctx:sObjectName}</sObjectName> <layoutName>{$ctx:layoutName}</layoutName> </salesforcerest.sObjectNamedLayouts> Sample request The following is a sample request that can be handled by the sObjectCompactLayouts operation. { "accessToken":"XXXXXXXXXXXX (Replace with your access token)", "apiUrl":"https://(your_instance).salesforce.com", "hostName": "https://login.salesforce.com", "apiVersion": "v32.0", "sObjectName":"Account", "layoutName": "UserAlt", } Sample Response Given below is a sample response for the sObjectCompactLayouts operation. { "layouts":[ { "detailLayoutSections":[ { "heading":"About", "columns":2, "tabOrder":"LeftToRight", "useCollapsibleSection":false, "rows":2, "useHeading":false, "layoutRows":[ { "layoutItems":[ { "editableForUpdate":false, "editableForNew":false, "layoutComponents":[ { "components":[ { "tabOrder":2, "details":{ "defaultValue":null, "precision":0, "nameField":false, "type":"string", "restrictedDelete":false, "relationshipName":null, "calculatedFormula":null, "controllerName":null, "namePointing":false, "defaultValueFormula":null, "calculated":false, "writeRequiresMasterRead":false, "inlineHelpText":null, "picklistValues":[ ] } } ] } . } List Views¶ listViewsTo retrieve a list of list views for the specific sObject, use salesforcerest.listViews and specify the following properties. See the related API documentation for more information. Parameter Name Description Required Sample Value sObjectName The type of object whose list views you want to retrieve. Yes Account Sample configuration <salesforcerest.listViews> <sObjectName>{$ctx:sObjectName}</sObjectName> </salesforcerest.listViews> Sample request The following is a sample request that can be handled by the listViews operation. { "accessToken":"XXXXXXXXXXXX (Replace with your access token)", "apiUrl":"https://(your_instance).salesforce.com", "hostName": "https://login.salesforce.com", "apiVersion": "v32.0", "sObjectName": "Account", } Sample Response Given below is a sample response for the listViews operation. { "nextRecordsUrl":null, "size":7, "listviews":[ { "resultsUrl":"/services/data/v32.0/sobjects/Account/listviews/00B280000032AihEAE/results", "soqlCompatible":true, "id":"00B280000032AihEAE", "label":"New This Week", "describeUrl":"/services/data/v32.0/sobjects/Account/listviews/00B280000032AihEAE/describe", "developerName":"NewThisWeek", "url":"/services/data/v32.0/sobjects/Account/listviews/00B280000032AihEAE" }, . . ], "done":true, "sobjectType":"Account" } listViewByIdTo retrieve the basic information about one list view for the specific sObject, use salesforcerest.listViewById and specify the following properties. See the related API documentation for more information. Parameter Name Description Required Sample Value sObjectName The type of object whose list of list views you want to retrieve. Yes Account listViewId The ID of the specific list view whose information you want to return. This can be obtained by listViews operation Yes 00B28000002yqeVEAQ Sample configuration <salesforcerest.listViewById> <listViewID>{$ctx:listViewID}</listViewID> <sObjectName>{$ctx:sObjectName}</sObjectName> </salesforcerest.listViewById> Sample request The following is a sample request that can be handled by the listViewById operation. { "accessToken":"XXXXXXXXXXXX (Replace with your access token)", "apiUrl":"https://(your_instance).salesforce.com", "hostName": "https://login.salesforce.com", "apiVersion": "v32.0", "sObjectName": "Account", "listViewID":"00B28000002yqeVEAQ", } Sample Response Given below is a sample response for the listViewById operation. { "resultsUrl":"/services/data/v32.0/sobjects/Account/listviews/00B280000032AihEAE/results", "soqlCompatible":true, "id":"00B280000032AihEAE", "label":"New This Week", "describeUrl":"/services/data/v32.0/sobjects/Account/listviews/00B280000032AihEAE/describe", "developerName":"NewThisWeek", "url":"/services/data/v32.0/sobjects/Account/listviews/00B280000032AihEAE" } recentListViewsTo retrieve the list of recently used list views for the given sObject type, use salesforcerest.recentListViews and specify the following properties. See the related API documentation for more information. Parameter Name Description Required Sample Value sObjectName The type of object whose recently used list views you want to return. Yes Account Sample configuration <salesforcerest.recentListViews> <sObjectName>{$ctx:sObjectName}</sObjectName> </salesforcerest.recentListViews> Sample request The following is a sample request that can be handled by the recentListViews operation. { "accessToken":"XXXXXXXXXXXX (Replace with your access token)", "apiUrl":"https://(your_instance).salesforce.com", "hostName": "https://login.salesforce.com", "apiVersion": "v32.0", "sObjectName": "Account", } Sample Response Given below is a sample response for the recentListViews operation. { "nextRecordsUrl":null, "size":2, "listviews":[ { "resultsUrl":"/services/data/v32.0/sobjects/Account/listviews/00B280000032AihEAE/results", "soqlCompatible":true, "id":"00B280000032AihEAE", "label":"New This Week", "describeUrl":"/services/data/v32.0/sobjects/Account/listviews/00B280000032AihEAE/describe", "developerName":"NewThisWeek", "url":"/services/data/v32.0/sobjects/Account/listviews/00B280000032AihEAE" } . . ], "done":true, "sobjectType":"Account" } describeListViewByIdTo retrieve detailed information (ID, columns, and SOQL query) about a specific list view for the given sObject type, use salesforcerest.describeListViewById and specify the following properties. See the related API documentation for more information. Parameter Name Description Required Sample Value sObjectName The type of object to which the list view applies. Yes Account listViewID The ID of the list view. Yes 00B28000002yqeVEAQ (obtained by listViews operation) Sample configuration <salesforcerest.describeListViewById> <sObjectName>{$ctx:sObjectName}</sObjectName> <listViewID>{$ctx:listViewID}</listViewID> </salesforcerest.describeListViewById> Sample request The following is a sample request that can be handled by the describeListViewById operation. { "accessToken":"XXXXXXXXXXXX (Replace with your access token)", "apiUrl":"https://(your_instance).salesforce.com", "hostName": "https://login.salesforce.com", "apiVersion": "v32.0", "sObjectName": "Account", "listViewID":"00B28000002yqeVEAQ", } Sample Response Given below is a sample response for the describeListViewById operation. { "whereCondition":{ "field":"CreatedDate", "values":[ "THIS_WEEK" ], "operator":"equals" }, "columns":[ { "fieldNameOrPath":"Name", "sortDirection":"ascending", "hidden":false, "sortIndex":0, "ascendingLabel":"Z-A", "label":"Account Name", "sortable":true, "type":"string", "descendingLabel":"A-Z", "selectListItem":"Name" }, . . ], "query":"SELECT Name, Site, BillingState, Phone, toLabel(Type), Owner.Alias, Id, CreatedDate, LastModifiedDate, SystemModstamp FROM Account WHERE CreatedDate = THIS_WEEK ORDER BY Name ASC NULLS FIRST, Id ASC NULLS FIRST", "scope":null, "orderBy":[ { "fieldNameOrPath":"Name", "sortDirection":"ascending", "nullsPosition":"first" }, { "fieldNameOrPath":"Id", "sortDirection":"ascending", "nullsPosition":"first" } ], "id":"00B280000032Aih", "sobjectType":"Account" } listViewResultsTo execute the SOQL query for the list view and return the resulting data and presentation information, use salesforcerest.listViewResults and specify the following properties. See the related API documentation for more information. Parameter Name Description Required Sample Value sObjectName The type of object to which the list view applies. Yes Account listViewID The ID of the list view (obtained by listViews operation). Yes 00B28000002yqeVEAQ Sample configuration <salesforcerest.listViewResults> <sObjectName>{$ctx:sObjectName}</sObjectName> <listViewID>{$ctx:listViewID}</listViewID> </salesforcerest.listViewResults> Sample request The following is a sample request that can be handled by the listViewResults operation. { "accessToken":"XXXXXXXXXXXX (Replace with your access token)", "apiUrl":"https://(your_instance).salesforce.com", "hostName": "https://login.salesforce.com", "apiVersion": "v32.0", "sObjectName": "Account", "listViewID":"00B28000002yqeVEAQ", } Sample Response Given below is a sample response for the listViewResults operation. { "size":0, "records":[ ], "columns":[ { "fieldNameOrPath":"Name", "sortDirection":"ascending", "hidden":false, "sortIndex":0, "ascendingLabel":"Z-A", "label":"Account Name", "sortable":true, "type":"string", "descendingLabel":"A-Z", "selectListItem":"Name" }, . . ], "id":"00B280000032Aih", "label":"New This Week", "developerName":"NewThisWeek", "done":true } Process Rules¶ listProcessRulesTo retrieve the list of process rules in the organization, use salesforcerest.listProcessRules. See the related API documentation for more information. Sample configuration <salesforcerest.listProcessRules/> Sample request The following is a sample request that can be handled by the listProcessRules operation. { "accessToken":"XXXXXXXXXXXX (Replace with your access token)", "apiUrl":"https://(your_instance).salesforce.com", "hostName": "https://login.salesforce.com", "apiVersion": "v32.0", } Sample Response Given below is a sample response for the listProcessRules operation. { "rules":{ } } getSpecificProcessRuleTo retrieve the metadata for a specific sObject process rule, use salesforcerest.getSpecificProcessRule and specify the following properties. See the related API documentation for more information. Parameter Name Description Required Sample Value sObjectName The object whose process rule you want to retrieve. Yes Account workflowRuleId The ID of the process rule. You can get IDs using operation listProcessRules. Yes 01QD0000000APli Sample configuration <salesforcerest.getSpecificProcessRule> <sObjectName>{$ctx:sObjectName}</sObjectName> <workflowRuleId>{$ctx:workflowRuleId}</workflowRuleId> </salesforcerest.getSpecificProcessRule> Sample request The following is a sample request that can be handled by the getSpecificProcessRule operation. { "accessToken":"XXXXXXXXXXXX (Replace with your access token)", "apiUrl":"https://(your_instance).salesforce.com", "hostName": "https://login.salesforce.com", "apiVersion": "v32.0", "sObjectName": "Account", "workflowRuleId": "01QD0000000APli", } Sample Response Given below is a sample response for the getSpecificProcessRule operation. { "actions" : [ { "id" : "01VD0000000D2w7", "name" : "ApprovalProcessTask", "type" : "Task" } ], "description" : null, "id" : "01QD0000000APli", "name" : "My Rule", "namespacePrefix" : null, "object" : "Account" } Queries¶ queryTo retrieve data from an object, use salesforcerest.query and specify the following properties. If you want your results to include deleted records in the Recycle Bin, use salesforcerest.queryAll in place of salesforcerest.query. See the related API documentation for more information. Parameter Name Description Required Sample Value queryString The SQL query to use to search for records. Yes select id, name from Account Sample configuration query: <salesforcerest.query> <queryString>{$ctx:queryString}</queryString> </salesforcerest.query> queryAll: <salesforcerest.queryAll> <queryString>{$ctx:queryString}</queryString> </salesforcerest.queryAll> Sample request The following is a sample request that can be handled by the query operation. { "accessToken":"XXXXXXXXXXXX (Replace with your access token)", "apiUrl":"https://(your_instance).salesforce.com", "hostName": "https://login.salesforce.com", "apiVersion": "v32.0", "queryString": "select id, name from Account", } Sample Response Given below is a sample response for the query operation. { "done" : false, "totalSize" : 2014, "nextRecordsUrl" : "/services/data/v20.0/query/01gD0000002HU6KIAW-2000", "records" : [ { "attributes" : { "type" : "Account", "url" : "/services/data/v20.0/sobjects/Account/001D000000IRFmaIAH" }, "Name" : "Test 1" }, { "attributes" : { "type" : "Account", "url" : "/services/data/v20.0/sobjects/Account/001D000000IomazIAB" }, "Name" : "Test 2" }, ... ] } queryMoreIf the results from the query or queryAll operations are too large, the first batch of results is returned along with an ID that you can use with salesforcerest.queryMore to get additional results. If you want your results to include deleted records in the Recycle Bin, use salesforcerest.queryAllMore in place of salesforcerest.queryMore. See the related API documentation for queryMore and queryAllMore for more information. Parameter Name Description Required Sample Value nextRecordsUrl The query identifier for retrieving additional results. Yes QWE45HUJ39D9UISD00 Sample configuration queryMore: <salesforcerest.queryMore> <nextRecordsUrl>{$ctx:nextRecordsUrl}</nextRecordsUrl> </salesforcerest.queryMore> queryAllMore: <salesforcerest.queryAllMore> <nextRecordsUrl>{$ctx:nextRecordsUrl}</nextRecordsUrl> </salesforcerest.queryAllMore> Sample request The following is a sample request that can be handled by the queryMore operation. { "accessToken":"XXXXXXXXXXXX (Replace with your access token)", "apiUrl":"https://(your_instance).salesforce.com", "hostName": "https://login.salesforce.com", "apiVersion": "v32.0", "nextRecordsUrl": "QWE45HUJ39D9UISD00", } Sample Response Given below is a sample response for the queryMore operation. { "done" : true, "totalSize" : 3214, "records" : [...] } queryPerformanceFeedbackTo get feedback on how Salesforce will execute your query, use the salesforcerest.queryPerformanceFeedback operation. It uses the Query resource along with the explain parameter to get feedback. Salesforce analyzes each query to find the optimal approach to obtain the query results. Depending on the query and query filters, an index or internal optimization might be used. See the related API documentation for more information. Parameter Name Description Required Sample Value queryString The SQL query to use to get feedback for a query. Yes select id, name from Account Sample configuration <salesforcerest.queryPerformanceFeedback> <queryString>{$ctx:queryString}</queryString> </salesforcerest.queryPerformanceFeedback> Sample request The following is a sample request that can be handled by the queryPerformanceFeedback operation. { "accessToken":"XXXXXXXXXXXX (Replace with your access token)", "apiUrl":"https://(your_instance).salesforce.com", "hostName": "https://login.salesforce.com", "apiVersion": "v32.0", "queryString": "select id, name from Account", } Sample Response Given below is a sample response for the queryPerformanceFeedback operation. { "plans":[ { "leadingOperationType":"TableScan", "relativeCost":2.8324836601307193, "sobjectCardinality":2549, "fields":[ ], "cardinality":2549, "sobjectType":"Account" } ] } listviewQueryPerformanceFeedbackFor retrieving query performance feedback on a report or list view, use salesforcerest.listviewQueryPerformanceFeedback and specify the following properties. See the related API documentation for more information. Parameter Name Description Required Sample Value listViewID The ID of the report or list view to get feedback for a query. Yes 00B28000002yqeVEAQ Sample configuration <salesforcerest.listviewQueryPerformanceFeedback> <listViewID>{$ctx:listViewID}</listViewID> </salesforcerest.listviewQueryPerformanceFeedback> Sample request The following is a sample request that can be handled by the listviewQueryPerformanceFeedback operation. { "accessToken":"XXXXXXXXXXXX (Replace with your access token)", "apiUrl":"https://(your_instance).salesforce.com", "hostName": "https://login.salesforce.com", "apiVersion": "v32.0", "listViewID":"00B28000002yqeVEAQ", } Sample Response Given below is a sample response for the listviewQueryPerformanceFeedback operation. { "plans":[ { "leadingOperationType":"Index", "relativeCost":0, "sobjectCardinality":2549, "fields":[ "CreatedDate" ], "cardinality":0, "sobjectType":"Account" }, . . ] } Quick Actions¶ quickActionsTo retrieve a list of global actions, use salesforcerest.quickActions. See the related API documentation for more information. Parameter Name Description Required queryString The SQL query to use to search for records. Yes Sample configuration <salesforcerest.quickActions/> Sample request The following is a sample request that can be handled by the quickActions operation. { "accessToken":"XXXXXXXXXXXX (Replace with your access token)", "apiUrl":"https://(your_instance).salesforce.com", "hostName": "https://login.salesforce.com", "apiVersion": "v32.0", } Sample Response Given below is a sample response for the quickActions operation. { "output":"[ {\"label\":\"Log a Call\", \"name\":\"LogACall\", \"type\":\"LogACall\", \"urls\":{\"defaultValues\":\"/services/data/v32.0/quickActions/LogACall/defaultValues\",\"quickAction\":\"/services/data/v32.0/quickActions/LogACall\",\"describe\":\"/services/data/v32.0/quickActions/LogACall/describe\",\"defaultValuesTemplate\":\"/services/data/v32.0/quickActions/LogACall/defaultValues/{ID}\"}}, . . ]" } sObjectActionTo retrieve a list of object-specific actions, use salesforcerest.sObjectAction and specify the following property. See the related API documentation for more information. Parameter Name Description Required Sample Value sObjectName The type of object for which you want to retrieve a list of quick actions. Yes Account Sample configuration <salesforcerest.sObjectAction> <sObjectName>{$ctx:sObjectName}</sObjectName> </salesforcerest.sObjectAction> Sample request The following is a sample request that can be handled by the sObjectAction operation. { "accessToken":"XXXXXXXXXXXX (Replace with your access token)", "apiUrl":"https://(your_instance).salesforce.com", "hostName": "https://login.salesforce.com", "apiVersion": "v32.0", "sObjectName": "Account", } Sample Response Given below is a sample response for the sObjectAction operation. { "output":"[ {\"label\":\"Log a Call\", \"name\":\"LogACall\",\"type\":\"LogACall\", \"urls\":{\"defaultValues\":\"/services/data/v32.0/quickActions/LogACall/defaultValues\", \"quickAction\":\"/services/data/v32.0/quickActions/LogACall\", \"describe\":\"/services/data/v32.0/quickActions/LogACall/describe\", \"defaultValuesTemplate\":\"/services/data/v32.0/quickActions/LogACall/defaultValues/{ID}\"}}, . . ]" } getSpecificActionTo retrieve a specific action, use salesforcerest.getSpecificAction and specify the following properties. See the related API documentation for more information. Parameter Name Description Required Sample Value actionName The name of action to return. Yes hariprasath__LogACall Sample configuration <salesforcerest.getSpecificAction> <actionName>{$ctx:actionName}</actionName> </salesforcerest.getSpecificAction> Sample request The following is a sample request that can be handled by the getSpecificAction operation. { "accessToken":"XXXXXXXXXXXX (Replace with your access token)", "apiUrl":"https://(your_instance).salesforce.com", "hostName": "https://login.salesforce.com", "apiVersion": "v32.0", "actionName":"hariprasath__LogACall", } Sample Response Given below is a sample response for the getSpecificAction operation. { "iconName":null, "targetRecordTypeId":null, "targetSobjectType":"Task", "canvasApplicationName":null, "label":"Log a Call", "accessLevelRequired":null, "icons":[ { "width":0, "theme":"theme4", "contentType":"image/svg+xml", "url":"https://kesavan-dev-ed.my.salesforce.com/img/icon/t4v32/action/log_a_call.svg", "height":0 }, . . ], "targetParentField":null, "iconUrl":"https://kesavan-dev-ed.my.salesforce.com/img/icon/log_a_call_32.png", "height":null } getDescribeSpecificActionTo retrieve the description of a specific action, use salesforcerest.getDescribeSpecificAction and specify the following properties. See the related API documentation for more information. Parameter Name Description Required Sample Value actionName The action whose description you want to return. Yes hariprasath__LogACall Sample configuration <salesforcerest.getDescribeSpecificAction> <actionName>{$ctx:actionName}</actionName> </salesforcerest.getDescribeSpecificAction> Sample request The following is a sample request that can be handled by the getDescribeSpecificAction operation. { "accessToken":"XXXXXXXXXXXX (Replace with your access token)", "apiUrl":"https://(your_instance).salesforce.com", "hostName": "https://login.salesforce.com", "apiVersion": "v32.0", "sObjectName":"Account", } Sample Response Given below is a sample response for the getDescribeSpecificAction operation. { "iconName":null, "targetRecordTypeId":null, "targetSobjectType":"Task", "canvasApplicationName":null, "label":"Log a Call", "accessLevelRequired":null, "icons":[ { "width":0, "theme":"theme4", "contentType":"image/svg+xml", "url":"https://kesavan-dev-ed.my.salesforce.com/img/icon/t4v32/action/log_a_call.svg", "height":0 } ], . . "targetParentField":null, "iconUrl":"https://kesavan-dev-ed.my.salesforce.com/img/icon/log_a_call_32.png", "height":null } getDefaultValueOfActionTo return a specific action’s default values, including default field values, use salesforcerest.getDefaultValueOfAction and specify the following properties. See the related API documentation for more information. Parameter Name Description Required Sample Value actionName The specific action. Yes hariprasath__LogACall Sample configuration <salesforcerest.getDefaultValueOfAction> <actionName>{$ctx:actionName}</actionName> </salesforcerest.getDefaultValueOfAction> Sample request The following is a sample request that can be handled by the getDefaultValueOfAction operation. { "accessToken":"XXXXXXXXXXXX (Replace with your access token)", "apiUrl":"https://(your_instance).salesforce.com", "hostName": "https://login.salesforce.com", "apiVersion": "v32.0", "actionName":"hariprasath__LogACall", } Sample Response Given below is a sample response for the getDefaultValueOfAction operation. { "WhoId":null, "Description":null, "WhatId":null, "attributes":{ "type":"Task" }, "Subject":"Call" } Records¶ createTo create a record, use salesforcerest.create and specify the following properties. See the related API documentation for more information. Parameter Name Description Required Sample Value sObjectName The type of object for which you will create a record. Yes Account fieldAndValue The .json format property used to create the record. Include all mandatory fields according to the requirements for the specified sObject. Yes { "name": "wso2", "description":"This Account belongs to WSO2"} Note: For example, if you are creating a record for the Account sObject, "name" is a mandatory parameter, and you might want to include the optional description, so the fieldAndValue property would look like this: { "name":"wso2", "description":"This account belongs to WSO2" } Sample configuration <salesforcerest.create> <sObjectName>{$ctx:sObjectName}</sObjectName> <fieldAndValue>{$ctx:fieldAndValue}</fieldAndValue> </salesforcerest.create> Sample request The following is a sample request that can be handled by the create operation. { "accessToken":"XXXXXXXXXXXX (Replace with your access token)", "apiUrl":"https://(your_instance).salesforce.com", "hostName": "https://login.salesforce.com", "apiVersion": "v32.0", "sObjectName":"Account",, "fieldAndValue": { "name": "wso2", "description":"This Account belongs to WSO2" } } Sample Response Given below is a sample response for the create operation. { "success":true, "id":"0010K00001uiAn8QAE", "errors":[ ] } createMultipleRecordsTo create multiple records of the same sObject type, use salesforcerest.createMultipleRecords and specify the following properties. See the related API documentation for more information. Parameter Name Description Required Sample Value sObjectName The type of object for which you will create a record. Yes Account fieldAndValue The .json format property, which specifies each record as an entry within the records array. Include all mandatory fields according to the requirements for the specified sObject. Yes { "records": [ { "attributes": {"type": "Account", "referenceId": "ref1"}, "name": "wso2", "phone": "1111111", "website": "www.salesforce1.com" }, { "attributes": {"type": "Account", "referenceId": "ref2"}, "name": "slwso2", "phone": "22222222", "website": "www.salesforce2.com" }] } Note: For example, if you are creating a record for the Account sObject, "name" is a mandatory parameter, and you might want to include the optional description, so the fieldAndValue property would look like this: { "records": [ { "attributes": {"type": "Account", "referenceId": "ref1"}, "name": "wso2", "phone": "1111111", "website": "www.salesforce1.com" }, { "attributes": {"type": "Account", "referenceId": "ref2"}, "name": "slwso2", "phone": "22222222", "website": "www.salesforce2.com" }] } Sample configuration <salesforcerest.createMultipleRecords> <sObjectName>{$ctx:sObjectName}</sObjectName> <fieldAndValue>{$ctx:fieldAndValue}</fieldAndValue> </salesforcerest.createMultipleRecords> Sample request The following is a sample request that can be handled by the createMultipleRecords operation. { "accessToken":"XXXXXXXXXXXX (Replace with your access token)", "apiUrl":"https://(your_instance).salesforce.com", "hostName": "https://login.salesforce.com", "apiVersion": "v32.0", "sObjectName":"Account",, "fieldAndValue": { "records": [ { "attributes": {"type": "Account", "referenceId": "ref1"}, "name": "wso2", "phone": "1111111", "website": "www.salesforce1.com" }, { "attributes": {"type": "Account", "referenceId": "ref2"}, "name": "slwso2", "phone": "22222222", "website": "www.salesforce2.com" }] } } Sample Response Given below is a sample response for the createMultipleRecords operation. { "hasErrors" : false, "results" : [{ "referenceId" : "ref1", "id" : "001D000000K1YFjIAN" },{ "referenceId" : "ref2", "id" : "001D000000K1YFkIAN" },{ "referenceId" : "ref3", "id" : "001D000000K1YFlIAN" },{ "referenceId" : "ref4", "id" : "001D000000K1YFmIAN" }] } createNestedRecordsTo create nested records for a specific sObject, use salesforcerest.createNestedRecords and specify the following properties. See the related API documentation for more information. Parameter Name Description Required Sample Value sObjectName The type of object for which you will create a record. Yes fieldAndValue The .json format property, which specifies each record as an entry within the records array. Include all mandatory fields according to the requirements for the specified sobject. Yes { "records" :[{ "attributes" : {"type" : "Account", "referenceId" : "ref1"}, "name" : "SampleAccount1", "phone" : "1234567890", "website" : "www.salesforce.com", "numberOfEmployees" : "100", "type" : "Analyst", "industry" : "Banking", "Contacts" : { "records" : [{ "attributes" : {"type" : "Contact", "referenceId" : "ref2"}, "lastname" : "Smith", "Title" : "President", "email" : "[email protected]" },{ "attributes" : {"type" : "Account", "referenceId" : "ref3"}, "lastname" : "Evans", "title" : "Vice President", "email" : "[email protected]" }] } },{ "attributes" : {"type" : "Account", "referenceId" : "ref4"}, "name" : "SampleAccount2", "phone" : "1234567890", "website" : "www.salesforce.com", "numberOfEmployees" : "52000", "type" : "Analyst", "industry" : "Banking", "childAccounts" : { "records" : [{ "attributes" : {"type" : "Account", "referenceId" : "ref5"}, "name" : "SampleChildAccount1", "phone" : "1234567890", "website" : "www.salesforce.com", "numberOfEmployees" : "100", "type" : "Analyst", "industry" : "Banking" }] }, "Contacts" : { "records" : [{ "attributes" : {"type" : "Contact", "referenceId" : "ref6"}, "lastname" : "Jones", "title" : "President", "email" : "[email protected]" }] } }] } Note: For example, if you are creating records for the Account sObject, "name" is a mandatory parameter, and you might want to include additional optional values for each record, so the fieldAndValue property might look like this: { "records" :[{ "attributes" : {"type" : "Account", "referenceId" : "ref1"}, "name" : "SampleAccount1", "phone" : "1234567890", "website" : "www.salesforce.com", "numberOfEmployees" : "100", "type" : "Analyst", "industry" : "Banking", "Contacts" : { "records" : [{ "attributes" : {"type" : "Contact", "referenceId" : "ref2"}, "lastname" : "Smith", "Title" : "President", "email" : "[email protected]" },{ "attributes" : {"type" : "Contact", "referenceId" : "ref3"}, "lastname" : "Evans", "title" : "Vice President", "email" : "[email protected]" }] } },{ "attributes" : {"type" : "Account", "referenceId" : "ref4"}, "name" : "SampleAccount2", "phone" : "1234567890", "website" : "www.salesforce.com", "numberOfEmployees" : "52000", "type" : "Analyst", "industry" : "Banking", "childAccounts" : { "records" : [{ "attributes" : {"type" : "Account", "referenceId" : "ref5"}, "name" : "SampleChildAccount1", "phone" : "1234567890", "website" : "www.salesforce.com", "numberOfEmployees" : "100", "type" : "Analyst", "industry" : "Banking" }] }, "Contacts" : { "records" : [{ "attributes" : {"type" : "Contact", "referenceId" : "ref6"}, "lastname" : "Jones", "title" : "President", "email" : "[email protected]" }] } }] } Sample configuration <salesforcerest.createNestedRecords> <sObjectName>{$ctx:sObjectName}</sobject> <fieldAndValue>{$ctx:fieldAndValue}</fieldAndValue> </salesforcerest.createNestedRecords> Sample request The following is a sample request that can be handled by the createNestedRecords operation. { "accessToken":"XXXXXXXXXXXX (Replace with your access token)", "apiUrl":"https://(your_instance).salesforce.com", "hostName": "https://login.salesforce.com", "apiVersion": "v32.0", "sObjectName":"Account",, "fieldAndValue": { "records" :[{ "attributes" : {"type" : "Account", "referenceId" : "ref1"}, "name" : "SampleAccount1", "phone" : "1234567890", "website" : "www.salesforce.com", "numberOfEmployees" : "100", "type" : "Analyst", "industry" : "Banking", "Contacts" : { "records" : [{ "attributes" : {"type" : "Contact", "referenceId" : "ref2"}, "lastname" : "Smith", "Title" : "President", "email" : "[email protected]" },{ "attributes" : {"type" : "Account", "referenceId" : "ref3"}, "lastname" : "Evans", "title" : "Vice President", "email" : "[email protected]" }] } },{ "attributes" : {"type" : "Account", "referenceId" : "ref4"}, "name" : "SampleAccount2", "phone" : "1234567890", "website" : "www.salesforce.com", "numberOfEmployees" : "52000", "type" : "Analyst", "industry" : "Banking", "childAccounts" : { "records" : [{ "attributes" : {"type" : "Account", "referenceId" : "ref5"}, "name" : "SampleChildAccount1", "phone" : "1234567890", "website" : "www.salesforce.com", "numberOfEmployees" : "100", "type" : "Analyst", "industry" : "Banking" }] }, "Contacts" : { "records" : [{ "attributes" : {"type" : "Contact", "referenceId" : "ref6"}, "lastname" : "Jones", "title" : "President", "email" : "[email protected]" }] } }] } } Sample Response Given below is a sample response for the createNestedRecords operation. { "hasErrors" : false, "results" : [{ "referenceId" : "ref1", "id" : "001D000000K0fXOIAZ" },{ "referenceId" : "ref4", "id" : "001D000000K0fXPIAZ" },{ "referenceId" : "ref2", "id" : "003D000000QV9n2IAD" },{ "referenceId" : "ref3", "id" : "003D000000QV9n3IAD" },{ "referenceId" : "ref5", "id" : "001D000000K0fXQIAZ" },{ "referenceId" : "ref6", "id" : "003D000000QV9n4IAD" }] } updateTo update a record, use salesforcerest.update and specify the following properties. See the related API documentation for more information. Parameter Name Description Required Sample Value sObjectName The type of object for which you will create a record. Yes Account fieldAndValue The json format property with the new definition for the record. Yes { "name": "wso2", "description":"This Account belongs to WSO2" } Id The ID of the record you are updating. Yes 00128000002OOhD Sample configuration <salesforcerest.update> <sObjectName>{$ctx:sObjectName}</sObjectName> <fieldAndValue>{$ctx:fieldAndValue}</fieldAndValue> <Id>{$ctx:Id}</Id> </salesforcerest.update> Sample request The following is a sample request that can be handled by the update operation. { "accessToken":"XXXXXXXXXXXX (Replace with your access token)", "apiUrl":"https://(your_instance).salesforce.com", "hostName": "https://login.salesforce.com", "apiVersion": "v32.0", "sObjectName":"Account", "Id":"00128000002OOhD",, "fieldAndValue": { "name": "wso2", "description":"This Account belongs to WSO2" } } deleteTo delete a record, use salesforcerest.delete and specify the following properties. See the related API documentation for more information. Parameter Name Description Required Sample Value sObjectName The object type of the record. Yes Account Id The ID of the record you are deleting. Yes 00128000002OOhD Sample configuration <salesforcerest.update> <sObjectName>{$ctx:sObjectName}</sObjectName> <fieldAndValue>{$ctx:fieldAndValue}</fieldAndValue> <Id>{$ctx:Id}</Id> </salesforcerest.update> Sample request The following is a sample request that can be handled by the delete operation. { "accessToken":"XXXXXXXXXXXX (Replace with your access token)", "apiUrl":"https://(your_instance).salesforce.com", "hostName": "https://login.salesforce.com", "apiVersion": "v32.0", "sObjectName":"Account", "idToDelete":"00128000002OOhD", } recentlyViewedItemTo retrieve the recently viewed items, use salesforcerest.recentlyViewedItem and specify the following properties. See the related API documentation for more information. Parameter Name Description Required Sample Value limit The maximum number of records to be returned. Yes 5 Sample configuration <salesforcerest.recentlyViewedItem> <limit>{$ctx:limit}</limit> </salesforcerest.recentlyViewedItem> Sample request The following is a sample request that can be handled by the recentlyViewedItem operation. { "accessToken":"XXXXXXXXXXXX (Replace with your access token)", "apiUrl":"https://(your_instance).salesforce.com", "hostName": "https://login.salesforce.com", "apiVersion": "v32.0", "limit":"5", } Sample Response Given below is a sample response for the recentlyViewedItem operation. { "output":"[{\"attributes\": {\"type\":\"User\", \"url\":\"/services/data/v32.0/sobjects/User/00528000000ToIrAAK\"}, \"Id\":\"00528000000ToIrAAK\", \"Name\":\"kesan yoga\"}, . . ]" } retrieveFieldValuesTo retrieve specific field values for a specific sObject, use salesforcerest.retrieveFieldValues and specify the following properties. See the related API documentation for more information. Parameter Name Description Required Sample Value sObjectName The object type whose metadata you want to retrieve. Yes Account rowId The ID of the record whose values you want to retrieve. Yes 00128000005YjDnAAK fields A comma-separated list of fields whose values you want to retrieve. Yes AccountNumber,BillingPostalCode Sample configuration <salesforcerest.retrieveFieldValues> <sObjectName>{ctx:sObjectName}</sObjectName> <rowId>{ctx:rowId}</rowId> <fields>{ctx:fields}</fields> </salesforcerest.retrieveFieldValues> Sample request The following is a sample request that can be handled by the retrieveFieldValues operation. { "accessToken":"XXXXXXXXXXXX (Replace with your access token)", "apiUrl":"https://(your_instance).salesforce.com", "hostName": "https://login.salesforce.com", "apiVersion": "v32.0", "sObjectName": "Account", "rowId":"00128000005YjDnAAK", "fields":"AccountNumber,BillingPostalCode", } Sample Response Given below is a sample response for the retrieveFieldValues operation. { "AccountNumber" : "CD656092", "BillingPostalCode" : "27215", } upsertTo create or update (upsert) a record using an external ID, use salesforcerest.upsert and specify the following properties. This method is used to create records or update existing records based on the value of a specified external ID field. See the related API documentation for more information. * If the specified value does not exist, a new record is created. * If a record does exist with that value, the field values specified in the request body are updated. Parameter Name Description Required Sample Value sObjectName The object type whose value you want to upsert. Yes Account externalIDField The external Id Field of the subject. Yes sample__c Id The value of the customExtIdField. Yes 15222 fieldAndValue The json format property/payload used to create the record. Yes { "Name":"john" } Sample configuration <salesforcerest.upsert> <sObjectName>{$ctx:sObjectName}</sObjectName> <externalIDField>{$ctx:externalIDField}</externalIDField> <Id>{$ctx:Id}</Id> <fieldAndValue>{$ctx:fieldAndValue}</fieldAndValue> </salesforcerest.upsert> Sample request The following is a sample request that can be handled by the upsert operation. { "accessToken":"00D280000017q6q!AQoAQMMZWoN9MQZcXLW475YYoIdJFUICTjbGh67jEfAeV7Q57Ac2Ov.0ZuM_2Zx6SnrOmwpml8Qf.XclstTQiXtCYSGRBcEv", "apiUrl":"https://(your_instance).salesforce.com", "clientId": "3MVG9ZL0ppGP5UrBrnsanGUZRgHqc8gTV4t_6tfuef8Zz4LhFPipmlooU6GBszpplbTzVXXWjqkGHubhRip1s", "refreshToken": "5Aep861TSESvWeug_ztpnAk6BGQxRdovMLhHso81iyYKO6hTm68KfebpK7UYtEzF0ku8JCz7CNto8b3YMRmZrhy", "clientSecret": "9104967092887676680", "hostName": "https://login.salesforce.com", "apiVersion": "v32.0", "sObjectName":"Account",, "intervalTime" : "2400000", "externalIDField":"sample__c", "Id":"15222", "fieldAndValue": { "Name":"john" } } Sample Response Given below is a sample response for the upsert operation. { "id" : "00190000001pPvHAAU", "errors" : [ ], "success" : true } getDeletedTo retrieve a list of individual records that have been deleted within the given timespan for the specified object, use salesforcerest.getDeleted. The date and time should be provided in ISO 8601 format:YYYY-MM-DDThh:mm:ss+hh:mm. See the related API documentation for more information. Parameter Name Description Required Sample Value sObjectName The object where you want to look for deleted records Yes Account startTime Starting date/time (Coordinated Universal Time (UTC)—not local—timezone) of the timespan for which to retrieve the data. Yes 2015-10-05T12:30:30+05:30 endTime Ending date/time (Coordinated Universal Time (UTC)—not local—timezone) of the timespan for which to retrieve the data. Yes 2015-10-10T20:30:30+05:30 Sample configuration <salesforcerest.getDeleted> <sObjectName>{$ctx:sObjectName}</sObjectName> <startTime>{$ctx:startTime}</startTime> <endTime>{$ctx:endTime}</endTime> </salesforcerest.getDeleted> Sample request The following is a sample request that can be handled by the getDeleted operation. { "accessToken":"XXXXXXXXXXXX (Replace with your access token)", "apiUrl":"https://(your_instance).salesforce.com", "hostName": "https://login.salesforce.com", "apiVersion": "v32.0", "sObjectName":"Account", "startTime":"2015-10-05T12:30:30+05:30", "endTime":"2015-10-10T20:30:30+05:30" } Sample Response Given below is a sample response for the getDeleted operation. { "earliestDateAvailable":"2018-09-20T07:52:00.000+0000", "deletedRecords":[ ], "latestDateCovered":"2018-10-27T15:00:00.000+0000" } getUpdatedTo retrieve a list of individual records that have been updated within the given timespan for the specified object, use salesforcerest.getUpdated. The date and time should be provided in ISO 8601 format:YYYY-MM-DDThh:mm:ss+hh:mm. See the related API documentation for more information. Parameter Name Description Required Sample Value sObjectName The object where you want to look for updated records Yes Account startTime Starting date/time (Coordinated Universal Time (UTC)—not local—timezone) of the timespan for which to retrieve the data. Yes 2015-10-05T12:30:30+05:30 endTime Ending date/time (Coordinated Universal Time (UTC)—not local—timezone) of the timespan for which to retrieve the data. Yes 2015-10-10T20:30:30+05:30 Sample configuration <salesforcerest.getUpdated> <sObjectName>{$ctx:sObjectName}</sObjectName> <startTime>{$ctx:startTime}</startTime> <endTime>{$ctx:endTime}</endTime> </salesforcerest.getUpdated> Sample request The following is a sample request that can be handled by the getUpdated operation. { "accessToken":"XXXXXXXXXXXX (Replace with your access token)", "apiUrl":"https://(your_instance).salesforce.com", "hostName": "https://login.salesforce.com", "apiVersion": "v32.0", "sObjectName":"Account", "startTime":"2015-10-05T12:30:30+05:30", "endTime":"2015-10-10T20:30:30+05:30" } Sample Response Given below is a sample response for the getDeleted operation. { "ids":[ ], "latestDateCovered":"2018-10-27T15:00:00.000+0000" } sObjects¶ describeGlobalTo retrieve a list of the objects that are available in the system, use salesforcerest.describeGlobal. You can then get metadata for an object or objects as described in the next sections. See the related API documentation for more information. Sample configuration <salesforcerest.describeGlobal/> Sample request The following is a sample request that can be handled by the describeGlobal operation. { "accessToken":"XXXXXXXXXXXX (Replace with your access token)", "apiUrl":"https://(your_instance).salesforce.com", "hostName": "https://login.salesforce.com", "apiVersion": "v32.0", } Sample Response Given below is a sample response for the describeGlobal operation. { "maxBatchSize":200, "sobjects":[ { "updateable":false, "activateable":false, "deprecatedAndHidden":false, "layoutable":false, "custom":false, "deletable":false, "replicateable":false, "undeletable":false, "label":"Accepted Event Relation", "keyPrefix":null, "searchable":false, "queryable":true, "mergeable":false, "urls":{ "rowTemplate":"/services/data/v32.0/sobjects/AcceptedEventRelation/{ID}", "describe":"/services/data/v32.0/sobjects/AcceptedEventRelation/describe", "sobject":"/services/data/v32.0/sobjects/AcceptedEventRelation" }, "createable":false, "feedEnabled":false, "retrieveable":true, "name":"AcceptedEventRelation", "customSetting":false, "labelPlural":"Accepted Event Relations", "triggerable":false }, . . ], "encoding":"UTF-8" } describeSObjectTo get metadata (such as name, label, and fields, including the field properties) for a specific object type, use salesforcerest.describeSObject and specify the following properties. See the related API documentation for more information. Parameter Name Description Required Sample Value sObjectName The object type whose metadata you want to retrieve. Yes Account Sample configuration <salesforcerest.describeSObject> <sObjectName>{$ctx:sObjectName}</sObjectName> </salesforcerest.describeSObject> Sample request The following is a sample request that can be handled by the describeSObject operation. { "accessToken":"XXXXXXXXXXXX (Replace with your access token)", "apiUrl":"https://(your_instance).salesforce.com", "hostName": "https://login.salesforce.com", "apiVersion": "v32.0", "sObjectName":"Account", } Sample Response Given below is a sample response for the describeSObject operation. { "updateable":true, "activateable":false, "childRelationships":[ { "relationshipName":"ChildAccounts", "field":"ParentId", "deprecatedAndHidden":false, "childSObject":"Account", "cascadeDelete":false, "restrictedDelete":false }, { "relationshipName":"AccountCleanInfos", "field":"AccountId", "deprecatedAndHidden":false, "childSObject":"AccountCleanInfo", "cascadeDelete":true, "restrictedDelete":false }, . ] } listAvailableApiVersionTo retrieve a list of summary information about each REST API version that is currently available, use salesforcerest.listAvailableApiVersion. See the related API documentation for more information. Sample configuration <salesforcerest.listAvailableApiVersion/> Sample request The following is a sample request that can be handled by the listAvailableApiVersion operation. { "accessToken":"XXXXXXXXXXXX (Replace with your access token)", "apiUrl":"https://(your_instance).salesforce.com", "hostName": "https://login.salesforce.com", "apiVersion": "v32.0", } Sample Response Given below is a sample response for the listAvailableApiVersion operation. { "output":"[ {\"label\":\"Winter '11\",\"url\":\"/services/data/v20.0\",\"version\":\"20.0\"}, . . ]" } listOrganizationLimitsTo retrieve the limit information for your organization, use salesforcerest.listOrganizationLimits. See the related API documentation for more information. Sample configuration <salesforcerest.listOrganizationLimits/> Sample request The following is a sample request that can be handled by the listOrganizationLimits operation. { "accessToken":"XXXXXXXXXXXX (Replace with your access token)", "apiUrl":"https://(your_instance).salesforce.com", "hostName": "https://login.salesforce.com", "apiVersion": "v32.0", } Sample Response Given below is a sample response for the listOrganizationLimits operation. { "DailyApiRequests":{ "Dataloader Bulk":{ "Max":0, "Remaining":0 }, "test":{ "Max":0, "Remaining":0 }, "Max":5000, "Salesforce Mobile Dashboards":{ "Max":0, "Remaining":0 }, . . } listResourcesByApiVersionTo retrieve the resources that are available in the specified API version, use salesforcerest.listResourcesByApiVersion. You can then get the details of those resources. See the related API documentation for more information. Sample configuration <salesforcerest.listResourcesByApiVersion/> Sample request The following is a sample request that can be handled by the listResourcesByApiVersion operation. { "accessToken":"XXXXXXXXXXXX (Replace with your access token)", "apiUrl":"https://(your_instance).salesforce.com", "hostName": "https://login.salesforce.com", "apiVersion": "v32.0", } Sample Response Given below is a sample response for the listResourcesByApiVersion operation. { "tooling":"/services/data/v32.0/tooling", "folders":"/services/data/v32.0/folders", "eclair":"/services/data/v32.0/eclair", "prechatForms":"/services/data/v32.0/prechatForms", "chatter":"/services/data/v32.0/chatter", "tabs":"/services/data/v32.0/tabs", "appMenu":"/services/data/v32.0/appMenu", "quickActions":"/services/data/v32.0/quickActions", "queryAll":"/services/data/v32.0/queryAll", "commerce":"/services/data/v32.0/commerce", . } sObjectBasicInfoTo retrieve the individual metadata for the specified object, use salesforcerest.sObjectBasicInfo. See the related API documentation for more information. Parameter Name Description Required Sample Value sObjectName The object type whose metadata you want to retrieve. Yes Account Sample configuration <salesforcerest.sObjectBasicInfo> <sObjectName>{$ctx:sObjectName}</sObjectName> </salesforcerest.sObjectBasicInfo> Sample request The following is a sample request that can be handled by the sObjectBasicInfo operation. { "accessToken":"XXXXXXXXXXXX (Replace with your access token)", "apiUrl":"https://(your_instance).salesforce.com", "hostName": "https://login.salesforce.com", "apiVersion": "v32.0", "sObjectName":"Account", } Sample Response Given below is a sample response for the sObjectBasicInfo operation. { "objectDescribe":{ "updateable":true, "activateable":false, "deprecatedAndHidden":false, "layoutable":true, "custom":false, "deletable":true, "replicateable":true, "undeletable":true, "label":"Account", "keyPrefix":"001", "searchable":true, "queryable":true, "mergeable":true, "urls":{ "compactLayouts":"/services/data/v32.0/sobjects/Account/describe/compactLayouts", "rowTemplate":"/services/data/v32.0/sobjects/Account/{ID}" }, "createable":true, "feedEnabled":true, "retrieveable":true, "name":"Account", "customSetting":false, "labelPlural":"Accounts", "triggerable":true }, . } sObjectGetDeletedTo retrieve a list of individual records that have been deleted within the given timespan for the specified object, use salesforcerest.sObjectGetDeleted. The date and time should be provided in ISO 8601 format:YYYY-MM-DDThh:mm:ss+hh:mm. See the related API documentation for more information. Parameter Name Description Required Sample Value sObjectName The object type whose metadata you want to retrieve. Yes Account startTime Starting date/time (Coordinated Universal Time (UTC)—not local—timezone) of the timespan for which to retrieve the data. Yes 2015-10-05T12:30:30+05:30 endTime Ending date/time (Coordinated Universal Time (UTC)—not local—timezone) of the timespan for which to retrieve the data. Yes 2015-10-10T20:30:30+05:30 Sample configuration <salesforcerest.sObjectGetDeleted> <sObjectName>{$ctx:sObjectName}</sObjectName> <startTime>{$ctx:startTime}</startTime> <endTime>{$ctx:endTime}</endTime> </salesforcerest.sObjectGetDeleted> Sample request The following is a sample request that can be handled by the sObjectGetDeleted operation. { "accessToken":"XXXXXXXXXXXX (Replace with your access token)", "apiUrl":"https://(your_instance).salesforce.com", "hostName": "https://login.salesforce.com", "apiVersion": "v32.0", "sObjectName":"Account", "startTime":"2015-10-05T12:30:30+05:30", "endTime":"2015-10-10T20:30:30+05:30", } Sample Response Given below is a sample response for the sObjectGetDeleted operation. { "objectDescribe":{ "updateable":true, "activateable":false, "deprecatedAndHidden":false, "layoutable":true, "custom":false, "deletable":true, "replicateable":true, "undeletable":true, "label":"Account", "keyPrefix":"001", "searchable":true, "queryable":true, "mergeable":true, "urls":{ "compactLayouts":"/services/data/v32.0/sobjects/Account/describe/compactLayouts", "rowTemplate":"/services/data/v32.0/sobjects/Account/{ID}" }, "createable":true, "feedEnabled":true, "retrieveable":true, "name":"Account", "customSetting":false, "labelPlural":"Accounts", "triggerable":true }, . } sObjectGetUpdatedTo retrieve a list of individual records that have been updated within the given timespan for the specified object, use salesforcerest.sObjectGetUpdated. The date and time should be provided in ISO 8601 format:YYYY-MM-DDThh:mm:ss+hh:mm. See the related API documentation for more information. Parameter Name Description Required Sample Value sObjectName The object type whose metadata you want to retrieve. Yes Account startTime Starting date/time (Coordinated Universal Time (UTC)—not local—timezone) of the timespan for which to retrieve the data. Yes 2015-10-05T12:30:30+05:30 endTime Ending date/time (Coordinated Universal Time (UTC)—not local—timezone) of the timespan for which to retrieve the data. Yes 2015-10-10T20:30:30+05:30 Sample configuration <salesforcerest.sObjectGetUpdated> <sObjectName>{$ctx:sObjectName}</sObjectName> <startTime>{$ctx:startTime}</startTime> <endTime>{$ctx:endTime}</endTime> </salesforcerest.sObjectGetUpdated> Sample request The following is a sample request that can be handled by the sObjectGetUpdated operation. { "accessToken":"XXXXXXXXXXXX (Replace with your access token)", "apiUrl":"https://(your_instance).salesforce.com", "hostName": "https://login.salesforce.com", "apiVersion": "v32.0", "sObjectName":"Account", "startTime":"2015-10-05T12:30:30+05:30", "endTime":"2015-10-10T20:30:30+05:30", } Sample Response Given below is a sample response for the sObjectGetUpdated operation. { "ids":[ ], "latestDateCovered":"2018-10-27T15:00:00.000+0000" } sObjectPlatformActionTo retrieve the description of the PlatformAction, use salesforcerest.sObjectPlatformAction. See the related API documentation for more information. Sample configuration <salesforcerest.sObjectPlatformAction/> Sample request The following is a sample request that can be handled by the sObjectPlatformAction operation. { "accessToken":"XXXXXXXXXXXX (Replace with your access token)", "apiUrl":"https://(your_instance).salesforce.com", "hostName": "https://login.salesforce.com", "apiVersion": "v32.0", } Sample Response Given below is a sample response for the sObjectPlatformAction operation. { "objectDescribe":{ "updateable":false, "activateable":false, "deprecatedAndHidden":false, "layoutable":false, "custom":false, "deletable":false, "replicateable":false, "undeletable":false, "label":"Platform Action", "keyPrefix":"0JV", "searchable":false, "queryable":true, "mergeable":false, "urls":{ "rowTemplate":"/services/data/v32.0/sobjects/PlatformAction/{ID}", "describe":"/services/data/v32.0/sobjects/PlatformAction/describe", "sobject":"/services/data/v32.0/sobjects/PlatformAction" }, "createable":false, "feedEnabled":false, "retrieveable":false, "name":"PlatformAction", "customSetting":false, "labelPlural":"Platform Actions", "triggerable":false }, "recentItems":[ ] } sObjectRowsTo retrieve details of a specific record, use salesforcerest.sObjectRows. See the related API documentation for more information. Parameter Name Description Required Sample Value sObjectName The object type of the record. Yes Account rowId The ID of the record whose details you want to retrieve. Yes 00128000005YjDnAAK Sample configuration <salesforcerest.sObjectRows> <sObjectName>{$ctx:sObjectName}</sObjectName> <rowId>{$ctx:rowId}</rowId> </salesforcerest.sObjectRows> Sample request The following is a sample request that can be handled by the sObjectRows operation. { "accessToken":"XXXXXXXXXXXX (Replace with your access token)", "apiUrl":"https://(your_instance).salesforce.com", "hostName": "https://login.salesforce.com", "apiVersion": "v32.0", "sObjectName":"Account", "rowId":"00128000005YjDnAAK", } Sample Response Given below is a sample response for the sObjectRows operation. { "AccountNumber" : "CD656092", "BillingPostalCode" : "27215" } Search¶ searchTo search for records, use salesforcerest.search and specify the search string. See the related API documentation for more information. Parameter Name Description Required Sample Value searchString The SQL query to use to search for records. Yes sample string Sample configuration <salesforcerest.search> <searchString>{$ctx:searchString}</searchString> </salesforcerest.search> Sample request The following is a sample request that can be handled by the search operation. { "accessToken":"XXXXXXXXXXXX (Replace with your access token)", "apiUrl":"https://(your_instance).salesforce.com", "hostName": "https://login.salesforce.com", "apiVersion": "v32.0", "searchString": "FIND {map*} IN ALL FIELDS RETURNING Account (Id, Name), Contact, Opportunity, Lead", } Sample Response Given below is a sample response for the search operation. { {"output":"[{\"attributes\":{\"type\":\"Account\",\"url\":\"/services/data/v32.0/sobjects/Account/00128000005dMcSAAU\"},\"Id\":\"00128000005dMcSAAU\",\"Name\":\"GenePoint\"}]"} } searchScopeAndOrderTo retrieve the search scope and order for the currently logged-in user, use salesforcerest.searchScopeAndOrder. See the related API documentation for more information. Sample configuration <salesforcerest.searchScopeAndOrder/> Sample request The following is a sample request that can be handled by the searchScopeAndOrder operation. { "accessToken":"XXXXXXXXXXXX (Replace with your access token)", "apiUrl":"https://(your_instance).salesforce.com", "hostName": "https://login.salesforce.com", "apiVersion": "v32.0", } Sample Response Given below is a sample response for the searchScopeAndOrder operation. { {"output":"[]"} } searchResultLayoutTo retrieve the search result layouts for one or more sObjects, use salesforcerest.searchResultLayout and specify the following properties. See the related API documentation for more information. Parameter Name Description Required Sample Value sObjectNameList A comma-delimited list of the objects whose search result layouts you want to retrieve. Yes Account,User Sample configuration <salesforcerest.searchResultLayout> <sObjectNameList>{$ctx:sObjectNameList}</sObjectNameList> </salesforcerest.searchResultLayout> Sample request The following is a sample request that can be handled by the searchResultLayout operation. { "accessToken":"XXXXXXXXXXXX (Replace with your access token)", "apiUrl":"https://(your_instance).salesforce.com", "hostName": "https://login.salesforce.com", "apiVersion": "v32.0", "sObjectNameList": "Account,User", } Sample Response Given below is a sample response for the searchResultLayout operation. { {"output":"[{\"errorMsg\":null,\"label\":\"Search Results\",\"limitRows\":25,\"objectType\":\"Account\",\"searchColumns\":[{\"field\":\"Account.Name\",\"format\":null,\"label\":\"Account Name\",\"name\":\"Name\"},{\"field\":\"Account.Site\",\"format\":null,\"label\":\"Account Site\",\"name\":\"Site\"},.]"} } searchSuggestedRecordsTo return a list of suggested records whose names match the user’s search string, use salesforcerest.searchSuggestedRecords and specify the following properties. See the related API documentation for more information. Parameter Name Description Required Sample Value stringForSearch The object type that the search is scoped to. Yes hari sObjectName The SOQL query to execute the search. Yes Account Sample configuration <salesforcerest.searchSuggestedRecords> <stringForSearch>{$ctx:stringForSearch}</stringForSearch> <sObjectName>{$ctx:sObjectName}</sObjectName> </salesforcerest.searchSuggestedRecords> Sample request The following is a sample request that can be handled by the searchSuggestedRecords operation. { "accessToken":"XXXXXXXXXXXX (Replace with your access token)", "apiUrl":"https://(your_instance).salesforce.com", "hostName": "https://login.salesforce.com", "apiVersion": "v32.0", "sObjectName": "Account", "stringForSearch": "hari", } Sample Response Given below is a sample response for the searchSuggestedRecords operation. { {"autoSuggestResults":[],"hasMoreResults":false} } Users¶ getUserInformationTo retrieve information about a specific user, use salesforcerest.getUserInformation and specify the following property. See the related API documentation for more information. Parameter Name Description Required Sample Value userId The ID of the user whose information you want to retrieve. Yes 00528000000yl7j Sample configuration <salesforcerest.getUserInformation> <userId>{$ctx:userId}</userId> </salesforcerest.getUserInformation> Sample request The following is a sample request that can be handled by the getUserInformation operation. { "accessToken":"XXXXXXXXXXXX (Replace with your access token)", "apiUrl":"https://(your_instance).salesforce.com", "hostName": "https://login.salesforce.com", "apiVersion": "v32.0", "userId": "00528000000yl7j", } Sample Response Given below is a sample response for the getUserInformation operation. { "ProfileId":"00e28000000xIEQAA2", "LastModifiedDate":"2016-11-29T05:40:45.000+0000", "Address":{ "country":"LK", "city":null, "street":null, "latitude":null, "postalCode":null, "geocodeAccuracy":null, "state":null, "longitude":null }, "LanguageLocaleKey":"en_US", "EmailPreferencesAutoBccStayInTouch":false . . } resetPasswordTo reset the password of a specific user, use salesforcerest.resetPassword and specify the following property. See the related API documentation for more information. Parameter Name Description Required Sample Value userId The ID of the user whose information you want to retrieve. Yes 00528000000yl7j Sample configuration <salesforcerest.getUserInformation> <userId>{$ctx:userId}</userId> </salesforcerest.getUserInformation> Sample request The following is a sample request that can be handled by the getUserInformation operation. { "accessToken":"XXXXXXXXXXXX (Replace with your access token)", "apiUrl":"https://(your_instance).salesforce.com", "hostName": "https://login.salesforce.com", "apiVersion": "v32.0", "userId": "00528000000yl7j", } Sample Response Given below is a sample response for the getUserInformation operation. { "NewPassword" : "myNewPassword1234" } Reports¶ getReportTo retrieve information about a report, use salesforcerest.getReport and specify the following property. See the related API documentation for more information. Note: This operation is available only with Salesforce REST Connector v1.1.2 and above. Parameter Name Description Required Sample Value reportId The ID of the report that you want to retrieve. Yes 00O8d000004MWaGEAW Sample configuration <salesforcerest.getReport> <reportId>{$ctx:reportId}</reportId> </salesforcerest.getReport> Sample request The following is a sample request that can be handled by the getReport operation. { "reportId": "00O8d000004MWaGEAW", } Sample Response Given below is a sample response from the getReport operation. { "attributes": { "describeUrl": "/services/data/v55.0/analytics/reports/00O8d000004MWaGEAW/describe", "instancesUrl": "/services/data/v55.0/analytics/reports/00O8d000004MWaGEAW/instances", "reportId": "00O8d000004MWaGEAW", "reportName": "SampleReport", "type": "Report" }, "allData": true, "factMap": { "T!T": { "aggregates": [ { "label": "13", "value": 13 } ], "rows": [ { "dataCells": [ { "label": "Customer - Direct", "recordId": "0018d00000FgQblAAF", "value": "Customer - Direct" }, { "label": "Warm", "recordId": "0018d00000FgQblAAF", "value": "Warm" }, { "label": "-", "recordId": "0018d00000FgQblAAF", "value": null }, { "label": "16/08/2022", "value": "2022-08-15" }, . . . ] } ] } } }