Create Task (Salesforce) v3.0.13 Help

Creates a new task in Salesforce and associates it with a lead, contact, campaign, contract, or another record.

How can I use the Step?

You can use the Step to automate adding new task information to a Salesforce database. The Step lets you quickly and efficiently input task data without manual entry, saving time and reducing errors. Additionally, it can be integrated with other systems or applications to streamline overall business processes.

How does the Step work?

You authorize the Step and input task details such as the task subject, due date, priority, status, and a record it is related to. The Step takes these inputs and requests Salesforce API to create a new task record with the specified details.

To learn more about tasks, review the Salesforce documentation on Tasks.

Prerequisites

Before you get started, you must do the following:

Obtain the Consumer Key and Consumer Secret of the Salesforce Connected App you want to authorize the Step with. For more information about creating and configuring a Connected App, see Create a Connected App documentation.

Authorization

To authorize the Step, you can inherit authorization from a previous Step, select existing authorization or create a new one.

Here are the steps to create a new Salesforce authorization:

For Select authorization in the current Step, choose the Create a new authorization option from the dropdown.
In the Add an authorization popup, do the following:
- For Your Connected Apps, select an existing Connected App or click Add a new Connected App and provide the required details in a popup:
  - Name this Connected App: Connected App name.
  - Environment: Environment choice for the Connected App in Salesforce. Either production or sandbox.
  - Consumer Key: Consumer Key for Connected App in Salesforce (see Prerequisites).
  - Consumer Secret: Consumer Secret for Connected App in Salesforce (see Prerequisites).
  - Callback URL: OAuth 2.0 redirect URL. You must use it as Callback URL when creating Connected App on Salesforce.
- Name your new authorization.
- Choose where to save the authorization.
- Authorize the Step by clicking Authorize now or pasting the authorization URL into a web browser.

Once the Step is authorized, all related settings are automatically updated, and you can continue with the Step settings.

Task information

The inputs for this section refer to the Task Fields in Salesforce and contain a range of parameters to help you manage and track your to-do list related to your leads, contacts, campaigns, contracts, and other records.

Advanced settings

You can use this section to configure the following parameter:

API version: The Salesforce API version for requests. The value must be in the format 50 or 50.0 and contain at least two characters. The default API version is 50, and the minimum supported version is 21.

Merge field settings

The Step returns the result as a JSON object and stores it in the Merge field variable. So you can use the retrieved data in subsequent Steps or other Flows.

Output example

The output depends on the development and settings you provide. It contains the record ID, success status, errors, and a data object with the fields of the task record populated.

To learn more, see the following output example:

json

{
    "response": {
        "id": "00T1r00004FTfTrEAL",
        "success": true,
        "errors": []
    },
    "data": {
        "Subject": "subject",
        "ActivityDate": "2018-05-31",
        "WhoId": "0031r000023uy7cAAA",
        "WhatId": "0011r00001mTKXVAA4",
        "OwnerId": "0051r000007h4AEAAY",
        "Status": "Not Started",
        "Priority": "Normal",
        "Description": "Comments"
    }
}

{
    "response": {
        "id": "00T1r00004FTfTrEAL",
        "success": true,
        "errors": []
    },
    "data": {
        "Subject": "subject",
        "ActivityDate": "2018-05-31",
        "WhoId": "0031r000023uy7cAAA",
        "WhatId": "0011r00001mTKXVAA4",
        "OwnerId": "0051r000007h4AEAAY",
        "Status": "Not Started",
        "Priority": "Normal",
        "Description": "Comments"
    }
}

Error Handling

By default, the Handle error toggle is on, and the Step handles errors with a separate exit. If any error occurs during the Step execution, the Flow proceeds down the error exit.

If the Handle error toggle is disabled, the Step does not handle errors. In this case, if any error occurs during the Step execution, the Flow fails immediately after exceeding the Flow timeout. To prevent the Flow from being suspended and continue handling errors, you can place the Flow Error Handling Step before the main logic or your Flow.

Reporting

After the Step completes, it generates a report that includes its execution status and other details. You can customize the report by adjusting the Step's log level and adding tags.

Log level

By default, the Step's log level matches that of the Flow. You can change the Step's log level by selecting an appropriate option from the Log level dropdown.

Service dependencies

flow builder v2.28.3
event-manager v2.3.0
deployer v2.6.0
library v2.11.3
studio v2.64.1
authorizer 2 service v2.1.6
salesforce data provider

Release notes

v3.0.13

Add API version selection to the Step UI

v3.0.12

Update dropdown behavior

v3.0.11

Reorder dropdown options

v3.0.9

Update Authorization Manager v 1.2.9
Add the None option to dropdown

v3.0.8

Update UI tooltips
Update error handling
Remove extra data

v3.0.7

Implement Authorization Manager v 1.1.0
Remove the dynamicAll switch handling
Add Step migration

v3.0.4

Update Authorization Manager v1.0.5
Add dynamic instance_url

v3.0.3

Update Authorization Manager v1.0.4

v3.0.1

Update the toJSON function and wildcard logic with the new Merge field expression template

Create Task (Salesforce) v3.0.13 Help ​

How can I use the Step? ​

How does the Step work? ​

Prerequisites ​

Authorization ​

Task information ​

Advanced settings ​

Merge field settings ​

Output example ​

Error Handling ​

Reporting ​

Log level ​

Tags ​

Service dependencies ​

Release notes ​