PROFESSIONAL SERVICES · FOLDER AUTOMATION
How to auto-create Box client folders from HubSpot deals
Short answer: Build a deal-based HubSpot workflow that triggers when a deal reaches a stage (for example “Closed Won”). Add Box Connector’s Create Box Folder action (or Copy Folder to copy a template), then Pin Box Folder to Record so the new folder shows on the deal’s Box Files card. After that, it runs on every deal that reaches the stage.
What it does
When an engagement is won, Box Connector creates a client or matter folder in Box named from the deal, adds your team as collaborators, creates standard subfolders, and pins the folder to the deal as a typed pinned folder. Your team sees it on the record, and later workflows can find it.
Before you start
Plan: Growth plan and up. Custom object support is also Growth and up.
Box Connector is installed and connected. Installation needs a HubSpot super admin and a Box admin account with root read and write privileges.
The Box Files card is on your deal record layout.
You know the Box ID of the parent folder where client folders should live (for example a “Clients” folder). Open the folder in Box and copy the number at the end of the URL. The ID of your Box root folder is 0.
Optional: a template folder in Box with your standard subfolders and files.
Step 1: Create a pinned folder type
In Box Connector, go to Settings > Pinned Folder Types.
Click Add Folder Type, pick an icon, and name it (for example “Client” or “Matter”).
Save. The type is now available on contacts, companies, deals, tickets and custom objects.
Step 2: Create a deal-based workflow in HubSpot
In HubSpot, create a workflow from scratch and choose Deals as the object.
Set the enrollment trigger: Deal stage is any of Closed Won (pick the right pipeline).
Decide whether deals can re-enroll. For client folders, most teams leave re-enrollment off.
Step 3: Add the Create Box Folder action
Add Create Box Folder from Box Connector and fill in the inputs:
Folder Name: deal tokens, for example client name plus matter or close year. Folder names can’t contain “/“, “\” or non-printable characters.
Parent Folder ID: the ID of your “Clients” folder.
Upload Email Access: choose Open or Collaborators Only.
Collaborators and Role (optional): select Box users such as the account team and a role such as editor. You can also add External Collaborators by email.
Fail on Conflict: leave unchecked to return the existing folder’s ID when a folder with the same name exists.
Its folder_id output holds the new folder’s Box ID. Using a template instead? Add Copy Folder with Folder ID to Copy, Destination Folder ID and Optional New Name, and use its ID of New Folder output.
Step 4: Add subfolders
For each subfolder, add another Create Box Folder with a Folder Name such as “Correspondence” or “Deliverables” and the folder_id output from Step 3 as Parent Folder ID.
Step 5: Pin the folder to the deal
Add Pin Box Folder to Record:
HubSpot Object Record ID: the deal’s Record ID.
HubSpot Object Record Type: Deal.
Box Folder ID: the folder_id output from Step 3.
Pinned Mode: add (keeps folders already pinned) or replace.
Pinned Folder Type: Client or Matter.
Type Conflict Handling: choose what happens if a folder of that type is already pinned.
Step 6: Test and turn it on
Move a test deal to “Closed Won”.
Check Box for the folder and subfolders, then confirm the folder is pinned on the deal’s Box Files card.
Turn the workflow on.
Real results
ToolKit Services builds Box job folders from HubSpot deal stages and saves about 5 hours a week. Root Financial creates household folders and upload links from HubSpot stages and eliminated 40 hours a week of repetitive work, a full role (1 FTE).
Frequently asked questions
Can I create a folder from a template?
What happens if the folder already exists?
Can I use this with HubSpot custom objects?
Related guides and resources
Try this workflow in your HubSpot
Box Connector gives you 42 no-code HubSpot workflow actions for Box. Start a free trial or book a demo and we’ll walk through this workflow with you.
