The Pull data from integration step connects a template to your CRM. When a team member creates a document from that template, they select a CRM record — a deal, contact, company, or opportunity — and PandaDoc automatically fills in the mapped variables. No manual copying of contact details, deal amounts, or custom fields.
You configure this step once at the template level. It applies every time the template is used.
If you used HubSpot integration before
The way you start creating a document hasn't changed — you can still create from within HubSpot or from PandaDoc, whichever your team prefers. What's changed is what happens after you start.
Before: Whether you clicked Create Document from the PandaDoc panel inside a HubSpot deal, or opened a template from within PandaDoc, you'd land in a short pre-flight step to confirm recipients — then go straight into the document editor with the deal already linked.
Now: The same two entry points exist — from HubSpot or from PandaDoc — but instead of landing in the editor after a pre-flight recipients step, a guided flow walks you through selecting the CRM record first. When creating the document from the CRM record, it will be pre-filled.
The HubSpot sidebar panel — is no longer present in the editor in the new experience. Linking a CRM record to a document now happens during the guided flow, not from within the editor. It is not currently possible to link or unlink a CRM record from within an already-created document.
Note: If you used Pipedrive or another CRM in the classic experience, the same principle applies — your CRM panel in the editor is no longer present in the new experience. The CRM connection now happens during the guided flow instead. See your CRM's setup guide for details specific to your integration.
Both entry points still work
From PandaDoc: Open a template and select Use this template. The first step of the guided flow prompts you to search for and select a CRM record.
From HubSpot: Open a deal, contact, or company record, find the PandaDoc panel, and select Create Document. You'll enter the guided flow with that record already pre-selected.
From Pipedrive or other CRMs: Open a deal, organization, or people record, find the PandaDoc module, and select +Document. The guided flow opens with the record pre-selected.
Note: The PandaDoc panel inside your CRM — which shows document count, status badges (Draft, Sent, etc.), creator name, and an Actions dropdown — continues to work as before. Documents you create through either entry point appear in this panel. If your workspace is still on the classic experience, creating from within your CRM will use the classic flow.
Supported integrations
The step works with any CRM connected to your PandaDoc workspace.
Integration | Setup guide |
HubSpot | |
Salesforce | |
Pipedrive | |
ActiveCampaign | |
BambooHR | |
Brevo | |
Close | |
Copper CRM | |
Creatio | |
folk | |
Greenhouse | |
Insightly | |
Jobber | |
Keap | |
Microsoft Dynamics 365 | |
NetSuite | |
Procore |
Note: You can connect your CRM either from Settings > API and integrations or from the Pull data from integration step.
Before you start
Note: Only workspace admins can add and configure workflow steps on templates.
Salesforce users — package version required: The new document creation flow requires PandaDoc for Salesforce managed package version 1.74 or higher. If your workspace is on an older version, team members will see a "Connect Salesforce to get started" error and the integration step will not run. Only a Salesforce admin can perform the upgrade. Share the upgrade instructions with them before enrolling your workspace in the new experience. To upgrade: install the latest package from AppExchange, then complete the one-time re-authorization described in Salesforce troubleshooting: Connection required (one-time setup).
Part 1 — Setting up the template (admin)
Step 1: Add the step to your template
Open your template. The Build your workflow panel appears on the right.
Select + Add step at the bottom of the workflow panel.
Select Pull data from integration.
The step is automatically placed at the top of the workflow — it always runs first, so CRM data is available throughout the rest of the document creation flow.
Step 2: Choose your integration and data source
Select the Pull data from integration step to open its settings.
Under Choose integration, select your CRM. Connect it if you haven't already.
Under Choose where to pull data from, select your data source — for example, Deal, Contact, or Company. The available options depend on your CRM.
Step 3: Add variables to your template (optional)
Select Variables to open the template editor with the variables panel.
This shows the full list of available CRM fields for your selected data source — for example, Deal.Name, Contact.Email, Organization.Address, and any custom fields configured in your CRM.
To use a variable:
Hover over the variable you need and select Copy.
Paste it into a text block in your template with the square brackets included — for example, [Deal.Name].
Alternatively, click inside any text block in the template, type an opening square bracket [, and select the variable from the dropdown.
When a team member creates a document from this template and selects a CRM record, PandaDoc replaces the variable placeholders with the actual values from that record automatically.
Select Refresh variables list if you've recently updated your CRM's field configuration and new variables aren't appearing yet.
Note: Variables only populate if the selected CRM record has data for the corresponding field value. If a field is empty in your CRM, the variable will appear as a placeholder in the document and your team will be prompted to enter those values manually during document creation, or they can be kept as placeholders..
Step 4: Configure sync rules (optional)
Note: Only HubSpot, Pipedrive, and Salesforce have Sync rules functionality.
Select Configure rules to set up data sync between PandaDoc and your CRM. Two rules are available:
Rule | What it does |
Update CRM record properties with PandaDoc field values | Writes values from fillable fields (e.g., a text field a recipient completed) back to the associated CRM record |
Update CRM record properties with PandaDoc variable values | Writes variable values (e.g., deal amount, contact name) back to the associated CRM record |
For each rule you enable, choose when the sync should run:
Sent — syncs when the document is sent to recipients
Completed — syncs when all parties have signed
Enable the toggles, check the appropriate trigger boxes, and select Save.
Note: HubSpot sync rules require the External automations feature, available as a paid add-on on Business plan ($39/month per account) and included on Enterprise. Rules only apply to documents created after they are saved — they do not apply retroactively to existing documents.
Tip: Enable both rules with both triggers (Sent and Completed) if you want your CRM records to reflect the most up-to-date document data at every stage.
Select Back to workflow when done.
About the red dot: A red dot on the step means it's missing required configuration. Once you've selected an integration and a data source, the dot clears automatically.
Part 2 — Creating a document from a CRM-connected template
When you select Use this template from PandaDoc, or Create Document from within HubSpot, the guided flow opens. Because the template has the Pull data from integration step configured, the first screen is the CRM record selector.
Step 1: Select a CRM record
What you see: A search field prompting you to select a record — for example, Select deal for a HubSpot- or Salesforce-connected template.
Type a record name, contact name, or keyword into the search field.
Select the correct record from the results.
PandaDoc pulls in all mapped variables from that record automatically.
Select Add recipients to move to the next step.
Creating from HubSpot: When you use Create Document from a HubSpot deal record, that deal is pre-selected in this step — you don't need to search for it manually.
Tip: Make sure you're logged into the PandaDoc workspace connected to your CRM. If no records appear when you search, confirm the connection under Settings > API and integrations.
Skipping this step in PandaDoc: If you select Add recipients without choosing a record when creating a document in PandaDoc, the flow advances without linking a CRM record. The document will be created, but CRM variables won't be populated and sync rules won't run. This can be useful for drafting quickly, though it is not currently possible to link a CRM record to a document after it has been created.
Step 2: Add recipients
Contacts associated with the selected CRM record are available in the recipient search dropdown under each role. Add any CC recipients if needed.
Select Edit document to continue, or Skip to move ahead.
Note: Automatic assignment of CRM contacts to document roles is a known limitation currently being addressed and will be updated in a future release.
Step 3: Add fillable fields
The document editor opens with the right sidebar showing available field types: Signature, Initials, Text field, Date, and more. Select Show all to see Checkbox, Dropdown, Radio button, and additional types.
Your CRM variables are already populated in the document, or shown as placeholders if the CRM record didn't have data for those fields. Add or adjust fillable fields as needed.
Note: You may briefly see a Connecting... message at the bottom of the document while PandaDoc establishes the CRM link — this is normal and resolves in a few seconds.
If you've updated data in your CRM after the document was created: Select Refresh data under More actions at the bottom of the editor to pull in the latest values from the linked CRM record. This replaces the Refresh data button that was previously visible in the editor sidebar.
Remaining steps
Depending on your template's workflow configuration, additional steps may follow — Set up payment, Send to approvers, and Send document. The step indicator at the top (e.g., Step 3 of 6) always shows your position and total number of steps. Select it to see all steps and jump to any one. Select Open document at the bottom of any screen to jump straight to the editor at any time.
Handling empty variables
If some CRM variables didn't populate because the selected record didn't have data for those fields, you'll be prompted before sending:
Keep as placeholders — the variable name stays visible in the document (e.g., {{Company.Address}}). Useful when you expect the data to be filled in before the recipient sees it.
Remove them and show blanks — the variable is replaced with an empty space.
To find out why a variable isn't populating: Open the deal, contact, or company record in your CRM and confirm the corresponding property has a value. Empty properties in your CRM will always result in placeholder variables in PandaDoc. Update the record in your CRM, then use More actions > Refresh data in the document editor to pull in the updated values.
Tips
Configure the template once, reuse it every time. The integration step only needs to be set up once by an admin. Every document created from that template follows the same guided flow automatically.
Selecting a top-level record pulls related data too. For most CRMs, selecting a Deal or Opportunity at Step 1 brings in associated contact and company fields. You don't need a separate integration step per object type.
Make sure you're in the right workspace. PandaDoc only pulls records from the CRM connected to your current workspace. If records aren't showing, confirm you're logged into the correct workspace.
Troubleshooting
CRM data isn't populating in documents
The template doesn't have the Pull data from integration step configured, or the step is present but no integration is selected. Open the template, go to the Build your workflow panel, and confirm the step is there and shows your CRM as the connected integration.
No records appear when searching
Confirm you're logged into the PandaDoc workspace connected to your CRM. If records still don't appear, go to Settings > API and integrations, disconnect and reconnect your CRM, then try again.
Your CRM doesn't appear in the Connected list
Go to Settings > API and integrations and connect your CRM first. It will then appear under Connected when you open the step settings.
Variables show as placeholders even after selecting a record
The selected CRM record doesn't have data for those fields. Open the record in your CRM, confirm the corresponding properties have values, then use More actions > Refresh data in the document editor to pull in the updated values.
Sync rules aren't updating the CRM after sending
Confirm sync rules are enabled under Configure rules in the template's integration step, and that the correct triggers (Sent, Completed) are checked. Also confirm your plan includes External automations — this feature is required for sync rules. Rules only apply to documents created after they were saved.
Contacts from the CRM aren't assigned to roles automatically
Contacts associated with the selected record appear in the recipient dropdown and can be selected manually for each role. Automatic role assignment is a known limitation currently being addressed.
I can't unlink or change the CRM record from within the document editor
Linking a CRM record now happens during the guided flow, before the document opens — it can't be changed from within the editor. If you need to link a different record, you'll need to create a new document from the template and select the correct record at the start of the flow. Linking and unlinking CRM entities from within the editor is not yet available in the new experience.
Salesforce: "Connect Salesforce to get started" error
Your PandaDoc for Salesforce managed package is below version 1.74, or the one-time workflow authorization hasn't been completed. See Salesforce troubleshooting: Connection required (one-time setup). Only a Salesforce admin can upgrade the package.
Salesforce: 403 Forbidden error after package upgrade
The workflow-specific authorization is separate from the standard Salesforce connection. Go to Settings > API and integrations > Salesforce and select Connect Automations to complete the one-time re-authorization. See Salesforce troubleshooting: Connection required (one-time setup) for the full steps.d yet. An admin needs to add and configure the Pull data from integration step on the template. See Part 1 below.







