Sections
Install the Procore app from the Docusign App Center.
During installation, you will be prompted to create a connection.
After the app is installed and a connection is created, the setup is complete.
All workflows are created in Docusign Workflows.
The Procore app provides two main workflow actions:
Workflows can:
The workflow will run in the context of the opened Procore record.
object_id and Why It MattersWhen a workflow is launched from Procore, the Side Panel passes object_id into the workflow.
object_id is the Procore entity ID (Id):
contact_ID for Project UsersTo work correctly for project vendors:
Id = object_idId = object_idTo work correctly for project users:
contact_id = object_idcontact_id = object_idMore details: see Read From Procore and Writeback to Procore sections.
💡 Recommended reading order if you’re new:
The Procore integration supports working with the following objects:
project_users)Users are individual people added to a Procore project and listed in the Project Directory.
A user may be:
Users represent people who can participate in project activities and workflows.
project_vendors)Companies are organizations added to a Procore project and listed in the Companies section of the Project Directory.

In Procore, companies added to a project are often referred to as vendors.
In Procore, there is a main company account and companies added inside projects. In this documentation, vendor refers to a company within a project.
Docusign Workflows can be launched for both Users and Companies (Vendors), depending on the context from which the workflow is started.
We also recommend to check Data for Workflow Setup before moving to Installation & Configuration.
When a Docusign Workflow is launched from Procore using the Side Panel (Workflow Builder Launcher), a set of context data is automatically passed to the workflow.

This data can be used during workflow configuration to identify the target object.
The following parameters are provided:
Object ID (object_id)
The unique ID of the selected Procore object:
User ID when the workflow is launched from a user page
called contact_ID in variables in Procore Read\Writeback project_users

Vendor ID when the workflow is launched from a company (vendor) page
called ID in variables in Procore Read\Writeback project_vendors
💡This is the actual Procore entity ID stored in the system (not any other ID type).
Project ID (project_id)
The ID of the Procore project from which the workflow is launched.
This parameter is available for reference but is not required for most workflow scenarios.
Company ID (company_id)
The ID of the main Procore company account.
💡This is not the same as a vendor (company within a project).
View (view)
This parameter is provided for context and is not typically required for workflow configuration.
To receive object_id from Procore, when you launch workflow from side panel (example) the workflow must be configured to start From an API Call.
During workflow setup:
Select From an API Call as the workflow start method.

Create a variable named object_id (Text type).

Choose Automated process as the trigger type.

This allows external systems, such as the Procore Side Panel, to pass the required identifier into the workflow.
Once configured, the Read From Procore step retrieves the selected Procore data and makes it available as workflow variables.
These variables can then be used in subsequent Workflow Builder steps.
When a workflow is launched from Procore using the Procore Side Panel (Workflow Builder Launcher), Procore passes a single identifier to the Workflow.
object_id is the actual Procore ID of the currently opened record.This behavior is consistent for both supported objects:
object_id equals the Project User contact_idobject_id equals the Project Vendor (Company) idTo ensure the workflow works correctly when launched from the Procore Side Panel, the Read From Procore step must be configured to use this identifier for project vendors

In the Which records are you reading from? section:
Id (the primary ID field) for project vendors,object_id.This explicit mapping tells Workflow Builder to read the exact Procore record that was opened in Procore when the workflow was launched.

In the Which records are you reading from? section:
contact_id for project users ,
object_id.This explicit mapping tells Workflow Builder to read the exact Procore record that was opened in Procore when the workflow was launched.
If this mapping is not configured, the workflow will not be able to correctly identify the target User or Vendor.
⚠️ Current limitation: At this time, file upload is supported only for Prime Contracts. Other targets visible in the UI are still in development and are not functional.
Although the File Upload UI uses “Folder / Subfolder” terminology, these fields do not represent a file system.

They define a Procore entity hierarchy that determines where the file will be attached.
To attach a file to a Prime Contract, the location must be configured as:
This hierarchy means:
📌 Important:
If Project ID and Object ID are swapped or incorrectly mapped, the file will not be attached to the expected record.
The first step is to install the Procore application in Docusign.
Open Docusign App Center.
Make sure you have Admin rights to install the Procore app from the Docusign App Center.
Locate the Procore application.

Click Install App to begin the installation.
During installation, connect your Procore account and grant the required permissions.
You will be asked to select Company and Project during this process.
💡 See Manage Connection for more details about configuring and updating connections.
Once the app is installed, a connection becomes available and can be selected in Workflow steps such as Read and Write.
After the Procore app is installed and a connection is configured:
No additional setup is required at this stage.
During installation, you will be prompted to create a connection.
A connection represents your direct authorization to work with a specific Procore company and project.
This connection is later used inside Workflows to read or write data in Procore.
If you selected the wrong project during installation, or if you want to add a new connection to a new project:
Open the Procore application settings in Docusign.
Click Manage Connection.

There is no need to reinstall the application.
The Manage Connection flow is the same as during the initial installation.

When adding a new connection, you will be asked:
How would you like to connect this Procore account?

You will then be asked to provide a name for the connection.

💡 We recommend using a name that clearly identifies the project (for example:
project1-main) to avoid confusion when selecting connections in workflows.
Next:


Once completed, the connection is created and can be used in Workflows.
WIP - this page is in work in progress stage, and will be updated soon.
In general the process will look like this:
Go to Procore Marketplace at the top right corner

Find Docusign Workflow Builder Launcher
Install
The Procore app enables you to work with Procore data directly within Docusign Workflows.
Using this app, you can create workflows in Docusign that read data from Procore, update Procore records, and send, track, or attach signed documents as part of an automated process.
Workflows can be:

Once a workflow is created and published, it can be run in different ways:
The same workflow can be reused in both scenarios.
Within the Workflow Builder, the Procore app provides actions that allow you to interact with Procore data as part of an automated workflow.
These actions enable workflows to both read data from Procore and write processed data back, allowing Procore to participate as a source and destination within the same workflow.

The following Procore actions are available:
The Read From Procore step allows a workflow to retrieve data for a specific Procore User or Company. To read data correctly, the workflow must be able to identify which Procore entity it should work with.
How this identification is performed depends on how the workflow is started.
There are two common scenarios for identifying the target Procore object.
When a workflow is started directly in Docusign (for example, from a link, or manual start), the workflow author is responsible for defining how the Procore object is identified.
In this case:
This approach is typically used when workflows are not tied to a specific Procore UI context.
See Workflow Start Methods - how workflow starts
When a workflow is launched from Procore using the Procore Side Panel (Workflow Builder Launcher), Procore automatically provides contextual data to the workflow.
💡Check Installing Procore Side Panel - Workflow Builder Launcher
In this case:
object_id parameter,object_id represents the Procore entity ID of the currently opened Company (vendor) or contact_id of the currently opened User.To use this value:
object_id as an input variable,object_id to the corresponding Procore User ID or Company ID.This allows the workflow to automatically operate on the Procore object selected in the Procore interface, without additional user input.
Important: When using the Procore Side Panel, the workflow must be configured to accept and use the
object_idprovided by Procore. Without this mapping, the Read From Procore step will not be able to identify the correct entity.
For detailed configuration options and examples, see Configuration Read From Procore Step below.
The Read From Procore step allows a Workflow to retrieve data for a specific Procore entity, such as a Project User or Project Vendor (Company).
This step is commonly used to load Procore data into a workflow so it can be used in later steps, such as document generation, signing, or data updates.
Configuring the Read From Procore step consists of the following stages:
object_id with Procore Side PanelThe example below demonstrates reading data for a Project User.
The same configuration logic applies when working with Project Vendors (Companies).
💡 How to add block "Read from Procore" check in Workflow Example
In the first step, you define the Procore source for the data.

Connection
This connection determines which Procore company and project the workflow will access.
Procore Object
Choose the type of Procore object you want to read from:

⚠️ It is important to select the correct object here.
This choice determines which fields are available and how records are identified later in the step.
Next, choose which Procore fields should be available as workflow variables.
Click Add or Remove Fields.
Select only the fields you need for your workflow.
Selected fields will become available for use in later Workflow Builder steps.


💡 Tip: Selecting only the required fields helps keep workflows easier to understand and maintain.
In this step, you define how the workflow identifies which Procore record (for example to identify client) should be read.
You create a rule that matches a Procore field to a workflow field.
Example configuration:
Id - please check how to use object_id to know wich ID to selectEqual toobject_id
Tis rule tells the workflow to read the Procore record whose ID matches the value of object_id (configured in the workflow start\input)
Once configured, the Read From Procore step retrieves the selected Procore data and makes it available as workflow variables.
These variables can then be used in subsequent Workflow Builder steps.
The Writeback to Procore action allows a workflow to update Procore records using data generated or processed during workflow execution.
This step is commonly used after actions such as document signing, approvals, or data transformation, when results need to be written back to Procore.

Configuring the Writeback to Procore step consists of the following stages:

In the first step, define the Procore destination for the data.
Connection
Procore Object
Choose the Procore object you want to write to:
💡 Recommendation:
In most cases, this should match the object used in the corresponding Read From Procore step.

Next, select how Procore records should be written.
Available options:
Update
Create
Update or Create
A combined option:
💡 Recommendation:
Use Update or Create for most workflows, as it provides the most flexible and fault-tolerant behavior.

Choose which Procore fields should be updated or populated.
For each selected Procore field, choose the workflow value that should be written into it.

Workflow data can come from different steps, such as:
⚠️ Important:
If you want Procore to receive updated values, make sure to map fields from the step where those values are finalized (for example, Send Documents for Signature).
Mapping fields from Read From Procore will simply write the original values back without changes.
Finally, define how the workflow identifies the target Procore record.

When using the Procore Side Panel, configure the rule as follows:
Id or contact_idEqual toobject_idThis ensures that data is written back to the exact Procore User or Vendor from which the workflow was launched.
This rule works identically for:
In workflows that are not launched from the Procore Side Panel, alternative identification rules can be used.
For example:
The identification strategy depends on how the workflow is designed and started.
Once configured, the Writeback to Procore step writes the selected workflow data back to Procore during workflow execution.
Add the File Upload action to your Workflow and open its configuration.

You are starting with a file

💡 Note: If no file is available for selection, it usually means that the file was not generated in previous workflow steps. Verify that your workflow includes steps such as document preparation and signing before File Upload.
⚠️ Important: The UI uses “Folder/Subfolder” terminology, but the structure represents a Procore entity hierarchy. To attach a file to a Prime Contract, you must configure the location as: Drive: Prime Contracts Folder: Project_ID Subfolder: Object_ID (Prime Contract ID)

In Select Drive, choose Prime Contracts.
This sets the target entity type for the upload.


Under Select Folder, click New Subfolder.
In the dialog (New Folder), click Add Variable.
Select the variable source:
Variable from workflow start(recommended when using Procore Side Panel / API start)
Choose: Project ID
Click Add.
✅ Result: the Folder entry will appear in the File Upload location UI and will contain the Project ID variable.

Under Select Subfolder, click New Subfolder.


In the dialog, click Add Variable. Select: Variable from workflow start Choose: Object_ID

Click Add.
✅ Result: the Subfolder entry will appear and will contain the Object ID variable.
After completing the steps above, your File Upload location should look like:
This configuration attaches the uploaded file to the specified Prime Contract.
Project ID and Object ID can be provided in different ways, depending on your workflow design:
This guide describes the workflow start approach because it is the most common setup for workflows launched from the Procore Side Panel.
For details on defining variables for workflows launched from Procore, see Defining Object ID in Workflow Start.
When the workflow is launched from the Procore Side Panel:
project_id can be passed automatically,object_id (Prime Contract ID) can be passed automatically.To support this:
define object_id (and optionally project_id) as workflow variables in the Workflow Start (From API Call),
map these variables in the File Upload step:
project_idobject_idThis allows the file to be attached without manual input.

When configured correctly:
The Procore Side Panel (Docusign Workflow Builder Launcher) allows you to launch published Workflows in the context of a specific Procore record.
⚠️ Important:
The Side Panel becomes available only when a specific record is opened in Edit mode.
The type of the opened record determines which Procore object must be used inside the workflow.
Before you can use the Procore Side Panel, you must authorize your Docusign account.
When you open the Docusign Workflow Builder Launcher for the first time, the panel will display an Authorize with Docusign button.

To authorize:
This is a one-time step.
After successful authorization, the Side Panel will refresh and display the available workflows.
In Procore, open a record in Edit mode:
project_users in read\write Procore step in Workflow)
project_vendors in read\write Procore step in Workflow)Then open the Docusign Workflow Builder Launcher from the right-hand side panel.

At this moment, Procore knows which exact entity (User or Vendor) is currently open and will pass its ID into the workflow.
The record type opened in Procore must match the Procore object selected in the workflow steps.
If a User (client) is opened in Procore:

If a Project Vendor is opened in Procore:

💡 Using a mismatched object (for example, opening a Vendor (company) in Procore but configuring the workflow for Project Users) will result in incorrect behavior or no records being found.
When a workflow is launched from the Procore Side Panel, Procore passes the following values into the Workflow:
object_id — the ID of the currently opened Procore record
The object_id is always the Id of the opened record.
To work correctly for project vendors:
Id = object_idId = object_idTo work correctly for project users:
contact_id = object_idcontact_id = object_id
After authorization:
If the workflow is configured correctly, it will:

This example demonstrates a complete Workflow that:
This workflow is designed to be launched from the Procore Side Panel, but it can also be triggered directly from Docusign.
To allow this workflow to be launched from Procore, the workflow must start with an API-triggered start.

Create the following variable:
object_id
This variable represents the Procore entity ID (User ID or Vendor ID) that will be passed into the workflow when it is launched from the Procore Side Panel.
Click Next
Select Automated process

Apply changes
At this point, the workflow is ready to accept input from Procore.
Add the Read from Procore step. This step retrieves data from Procore and makes it available as workflow variables.

Configuration

Where will you read from?
Select the Procore Connection (what is Connection and how it works here)
Select Procore object
Project Users (for this example as we work with exact client)
Select the fields required for the document and later updates:
Id (required)First NameLast NameEmail AddressAddressCityStateZipThese fields will be available for mapping in later workflow steps.

To ensure the correct Procore record is retrieved, configure the matching rule:
Procore field: Id
Operator: Equal to
Workflow field: object_id

Important:
When the workflow is launched from the Procore Side Panel, Procore always passes theId of the currently opened Vendor or contact_id of the currently opened User.
To ensure correct behavior, object_id must always be matched to the right Id field
contact_id - for project users, id - for project vendors.

Apply the configuration.
Add Prepare eSignature Template.

Select the template (e.g. W-9 Demo Form)
*Template created in other Docusign options, called "Templates"

Map Procore fields to document fields, for example:
First Name → First NameLast Name → Last NameAddress → AddressCity → CityState → StateZip → Postal Code
Important:
Make sure that you selected field from "READ FROM PROCORE" step. This is the data that Docusign retrieves from Procore.

This step pre-fills the document using data retrieved from Procore.
Apply changes.
Add Set Up Invite. (in this example it is required Docusign step)

Add a participant (e.g. Client)
Map participant details from the Read from Procore step:
Name → First Name
Email → Email Address

Apply changes.
After the document is prepared, the workflow must send it to the correct recipient for signing.
Add the Send Document for eSignature step and open its configuration.

Select the document generated in the Prepare eSignature Template step.
This ensures the workflow sends the exact document that was prepared and prefilled in the previous step.

In this step, you define who will sign the document.

Click Add participant
Define the participant role
For example: Client

Assign participant details using data from Read from Procore

Recommended mapping:
Participant Name → First Name (from Read from Procore)
Participant Email → Email Address (from Read from Procore)

This ensures:
Once the participant is configured, click Next.

In the Choose signing method step:
Select Direct Signing

Click Next to save the step configuration.
After the document is signed, updated values can be written back to Procore.
Add Writeback to Procore.

Where will you write to?
Select the same Connection as in Read step
Select the same Procore object (Project Users in this example, as we work with users\clients)
Write settings: Update or Create

Write Settings Explanation:

Select fields that may be updated by the signer, for example:
AddressCityStateZipMap Procore fields to values from Send Documents for Signature, not from the Read step.



Why this matters:
Configure record identification:
Procore field: Id
Operator: Equal to
Workflow field: object_id

This ensures the update is applied to the correct Procore entity.
Apply changes.
Important:
Make sure that you choose the correct ID!
When the workflow is launched from the Procore Side Panel, Procore always passes theId of the currently opened Vendor or contact_id of the currently opened User.
To ensure correct behavior, object_id must always be matched to the right Id field —
contact_id - for project users, id - for project vendors.
Optionally add Show Confirmation Screen to display a success message after workflow completion.
Once all steps are configured, publish the workflow.
It is now available for use both in Docusign and via the Procore Side Panel.
To launch workflow from Procore Workflow Builder Launcher please check Using the Procore Side Panel (Workflow Builder Launcher)
