Launch Workflows from Salesforce – Ironclad

This topic will walk you through how to set up your workflows to launch from Salesforce.

Note: This article is intended for users setting up the Ironclad Salesforce Integration for the first time or for those doing a fresh install of the Ironclad Managed Package.

If you are looking for documentation on package versions 2.1 and below, refer to Salesforce Integration Overview (Legacy).
If you want to upgrade from a version below 2.2 to a version above 2.16, refer to Upgrade the Ironclad Salesforce Integration.
If you installed an early-access package (between version 2.4 and 2.12) and are now switching to the official release package (2.16+), refer to Upgrade Early Access Package to Official Release.

Which Launch Configuration Should I Use?

There are three ways to launch an Ironclad workflow that syncs with Salesforce data:

Pull from Salesforce Button on Ironclad: When you click the Pull from Salesforce button, you can search objects in Salesforce and automatically fill in the workflow form with values from the Salesforce object you select based on the configuration you created.
Custom Salesforce Button: Add a custom button to Salesforce pages to automatically launch an Ironclad workflow from a Salesforce page.
Ironclad Workflows Component in Salesforce: Launch a new workflow from within your Salesforce window. You can also see all available workflows from one component.

Benefits and Considerations

Method	Benefits	Considerations
Pull from Salesforce Button on Ironclad	Grab data directly from Salesforce while in Ironclad without switching windows. Reduce manual data entry, especially if all launch form fields are mapped to Salesforce fields, by auto-populating data from mapped Salesforce fields.	This method is only available in Ironclad.
Custom Salesforce Button	Launch a new workflow from Salesforce. Auto-populate data from mapped Salesforce fields. Restrict which workflow launch buttons each Salesforce user can see. Restrict access to a workflow launch button until after certain CPQ approvals have been collected.	The workflow launches in a new browser tab to complete and submit the launch form. You must configure a separate button for each workflow, which can potentially take up a lot of space on your Salesforce object.
Ironclad Workflows Component in Salesforce	Launch a new workflow in the Salesforce window without needing to switch browser tabs. View all workflow launch forms in one convenient place within Salesforce. Auto-populate data from mapped Salesforce fields.	Only available in Salesforce Lightning. Cannot restrict access to a specific workflow launch button until after certain CPQ approvals have been collected. All Salesforce users who can see the Ironclad Workflows component on a certain Salesforce Source object can see the names of all the workflows configured to launch from that object type. For example, everyone who can see the Ironclad Workflows component for Opportunities can see every workflow configured to work with Opportunities. You can still restrict who can launch/submit a workflow through workflow permissions in Ironclad and by restricting which Salesforce users can see the launcher component altogether.

Configure Your Workflow to Launch from Salesforce

Required Ironclad Permissions: Admin

If you have any questions about matching the Ironclad Workflow Attributes to your Salesforce fields, reach out to Support.

Click on your name located in the top right corner of Ironclad. Navigate to Company Settings > Integrations > Configure Salesforce > Workflow Sync.
Click Add Workflow Configuration and select a workflow.
Verify that Workflow Sync is selected.
Select the Salesforce object you want to pull data into your workflow from. For example, a NDA is most likely an Account object.
Click Add Launch Configuration.

On the left, add Ironclad Record Properties and map them to Salesforce fields on the right. Make sure the workflow attributes identically match. For example, a string field in Ironclad must match to a string field in Salesforce. The table below shows a list of field types in Ironclad and they can be mapped to in Salesforce.

Ironclad	Salesforce
boolean*	boolean**
date	date, datetime
email	email
number	double, int, percent
string	id, string, textarea, URL, phone, email, picklist
address	address
monetary_amount	currency
array	picklist (multi)

*boolean in Ironclad is a yes/no question.
**boolean in Salesforce is a checkbox field.

Select additional linked Salesforce objects. Additional objects must have a lookup relationship to the main object. In the image below, the linked Account object is selected to pre-populate Ironclad's Counterparty Name with an Account Name. In the screenshot below, we select the linked Account object to pre-populate Ironclad's Counterparty Name with an Account Name.
Click Save. Ironclad generates a unique link and a Pull from Salesforce button on the workflow launch form in Ironclad. Users are prompted to link their Salesforce account before they use this feature for the first time.
When you click the Pull from Salesforce button, you can search objects in Salesforce and automatically fill in the workflow form with values from the Salesforce object you select based on the configuration you created.
Repeat these steps for each workflow you want to connect.

Configure Custom Buttons/Links in Salesforce

Required Salesforce Permissions: Admin
You can add a custom button to Salesforce pages to automatically launch an Ironclad workflow from Salesforce.

Copy Launch URL

Click on your name located in the top right corner of Ironclad. Navigate to Company Settings > Integrations > Configure Salesforce > Workflow Launch.
Each configured workflow provides you with two options to use as part of your workflow launch button in Salesforce. Use the one that best suits your situation:
- Salesforce Custom Button or Link URL. This option redirects the user to an Ironclad launch form, allowing them to manually enter any additional data and then launch the workflow. This is the better option if data might need to be changed by the end-user before submitting or if not all the data needed in the launch form is passed from Ironclad.
- Autosubmitting Button or Link URL. If all required launch form fields are being imported from Salesforce, you can use this option to launch Ironclad workflows. Custom buttons using this URL attempt to auto-submit the launch form as soon as the data is pulled in from Salesforce. The user is then taken straight to the workflow in Ironclad without having to press submit. In order for the auto-submit to complete, all of the required fields must be correctly mapped from Salesforce.
Create a custom button. Follow the instructions below for your Salesforce experience, Classic or Lightning.

Append SSO Launch URL

Sometimes, users in Salesforce aren’t logged into Ironclad while they work due to their account being recently provisioned or being automatically logged out. If they attempt to launch workflows from the launch component or button, they are sent to the standard Ironclad login page. In order to be redirected to the SSO login page, you must append a modifier to the end of the launch URL. Do this for both traditional and auto-submit URLs.
If you have any issues, refer to Salesforce Integration FAQ and Troubleshooting Guide.

Click on your name located in the top right corner of Ironclad. Navigate to Company Settings > Integrations > Users & Groups > Users > SSO Sign-In Methods.
Append "&saml={{your_SSO_identifier}}" to the end of your chosen launch URL, as shown in the example below. Use the modified URL when setting up your custom buttons or Ironclad workflow configurations.
Repeat this process for each workflow that is launched from Salesforce. The modifier and location is the same for all URLs.

Create a Custom Button (Classic)

In Salesforce, click Setup, and then navigate to Buttons, Links, and Actions under the appropriate Salesforce Object Type. For example, if you are configuring a button on the Account page, you would go to Build > Customize > Accounts > Buttons, Links, and Actions.
Click New Button or Link.
Enter/Select the following values:
1. In the Label field, enter a name similar to Start NDA in Ironclad.
2. In the Display Type section, select Detail Page Button.
3. From the Behavior dropdown, select Display in new window.
4. From the Content Source dropdown, select URL.
5. From the Select Field Type dropdown, select the Salesforce Object Type for the configuration.
6. In the large text area, copy and paste the Salesforce Custom Button or Link URL from the Ironclad Workflow Launch page.
Save your custom button or link.
Click Setup, and then navigate to Page Layout under the appropriate Salesforce Object Type. For example, if you are configuring a button on the Account page, you would go to Build > Customize > Accounts > Page Layouts.
Click Edit next to the layout you want to add the button to.
Locate the custom button or link that you created. In this example, we created a custom button. To find it, we look in the Buttons section.
Drag it into the Account Sample panel where you want it to show in the interface. Click Save.
Now, when users view a Salesforce Account Type Object (or whichever object type you created your custom button/link for), they see a custom button linked to creating a workflow in Ironclad that auto-fills the form with data from a Salesforce object.

Create a Custom Button (Lightning)

In Salesforce, click Setup > Object Manager > Buttons, Links, and Actions and then select which Salesforce object you’d like to add the custom button/link to.
Click New Button or Link. The Salesforce object you add the custom button to must be the same Salesforce object type as the one you use to create the workflow launch configuration in Ironclad.
Enter/Select the following values:
1. In the Label field, enter a name similar to Start NDA in Ironclad.
2. In the Display Type section, select Detail Page Button.
3. From the Behavior dropdown, select Display in new window.
4. From the Content Source dropdown, select URL.
5. From the Select Field Type dropdown, select the Salesforce Object Type for the configuration.
6. In the large text area, copy and paste the Salesforce Custom Button or Link URL from the Ironclad Workflow Launch page.
In Salesforce, click Setup > Object Manager > Page Layouts and then select which Salesforce object you’d like to add the custom button/link to.
Locate the custom button or link that you created. If you created a custom link, it is located under the Custom Links tab. If you create a custom button, it is located under the Mobile and Lightning Actions tab.
Drag it into the Account Sample panel where you want it to show in the interface. We recommend adding it to the front of the interface so it’s easier to find. Click Save.
If you created a custom button, when users view a Salesforce Account type object (or whichever object type you created your custom button/link for), they see a custom button linked to creating a workflow in Ironclad that auto-fills the form with data from a Salesforce object. If they click the button, a new window redirects them to an Ironclad workflow launch form, populated with values from the Salesforce object.
If you created a custom link, your users can find it under the Details tab at the bottom of the page.

Configure Embedded Workflow Launch in Salesforce

After you map the fields for your workflow and click Save, copy the launch URL that best suits your situation:
- Salesforce Custom Button or Link URL. This option redirects the user to an Ironclad launch form, allowing them to manually enter any additional data and then launch the workflow. This is the better option if data might need to be changed by the end-user before submitting or if not all the data needed in the launch form is passed from Ironclad.
- Autosubmitting Button or Link URL. If all required launch form fields are being imported from Salesforce, you can use this option to launch Ironclad workflows. Custom buttons using this URL attempt to auto-submit the launch form as soon as the data is pulled in from Salesforce. The user is then taken straight to the workflow in Ironclad without having to press submit. In order for the auto-submit to complete, all of the required fields must be correctly mapped from Salesforce.
In Salesforce, click the App Launcher icon indicated by a grid of stacked dots.
Search for and click Ironclad Workflow Configurations. Click New.
Enter the following information:
1. In the Ironclad Configuration Name field, enter a name for the workflow configuration.
2. In the Source Object field, enter the API name for the source object. To find this, go to Settings > Object Manager and select your source object. Enter the name exactly as it appears here. For example, if the Object Manager says Contact, make sure you enter Contact, not Contacts.
3. In the URL field, enter the launch URL you copied in the first step.
Verify the URL and Source Object fields are correct.
In the Salesforce Sales app, click the object tab you want to launch from. In this example, we click Contacts. Click New.
Fill in the required fields, and then click Save.
Click Setup indicated by a gear icon in the top right corner. Click Edit Page.
Drag the Ironclad Workflows component to the right panel of the page. Click Save.
If the activation modal does not immediately appear after you click Save, click Activation to activate the page based on your organization’s needs.
Activate the page as Org Default or App Default depending on your organization’s needs. We recommend that you activate this Lightning page for both Sales and Sales Console apps. Click Close.
Repeat these steps for each workflow you want to launch using Salesforce data.

Documents from Notes & Attachments vs Files

If you manually upload documents to Notes & Attachments through Salesforce Lightning, use the Files configuration for Workflow Sync. This is because of a Salesforce feature that classifies uploaded documents in Salesforce Lightning as Files, rather than as Notes & Attachments. For questions about matching the Ironclad Workflow Attributes schema to your Salesforce fields, reach out to Support.

Documents from Notes & Attachments and Files use different mappings. Refer to the screenshots below:

Notes & Attachments
Files

Why Won’t My Workflow Launch from Salesforce?

If your data is not populating on the workflow launch page from Salesforce:

Review the workflow launch configuration located under Company Settings > Integrations > Configure Salesforce. If there were any changes made to the workflow attributes, you may need to reconfigure the mappings between workflow attributes and Salesforce fields.
Check if the custom button/link in Salesforce navigates to a workflow launch page. If no data is populated, verify the URL attached to the workflow is the correct URL listed in the workflow launch configuration with the same Salesforce object type.

If the problem persists, contact Support at support@ironcladhq.com.