Get more information here: PandaDoc for HubSpot
Focus: The focus of this self-help article is to provide the steps and information necessary to integrate HubSpot CRM with PandaDoc.
This FAQ is about the HubSpot Native Integration
What does this Integration do? For this integration, you will be able to do the following:
- This integration will allow you to create, send, and track quotes, proposals, and contracts from within HubSpot CRM. Create PandaDoc documents within HubSpot CRM for Contact, Companies and Deal Objects.
- Use your HubSpot CRM fields and custom fields to send data from HubSpot CRM to PandaDoc via tokens and textfield field.
- Be able to track PandaDoc document status directly inside of the HubSpot CRM object.
- Track Document Status by using the HubSpot CRM “Contact – Event” tracker to track the progress of your PandaDoc Documents.
Before you get started, however, please make sure that you have a PandaDoc account (Don’t have one yet? Start 14-day free trial!)
Document Access: Please note, we do have options that you can enabled so other team members in your PandaDoc account, can see those created documents. Instruction found in Step 1c below.
Hubspot OAuth Changes – on 1/19/2018, Hubspot is changing they way to connect with integrations and is now using OAuth 2.0. If you have setup the PandaDoc integration before then, you might experience some issues and will need to Re-authorize the integration by reconnecting, using the following link.
Step 1: Setup and connection. In order to use this integration, we must go through the installation of the PandaDoc integration into HubSpot CRM.
Step 1a: Enable via PandaDoc Add-ons Store. Login into PandaDoc, go to Add-ons Store, go to Integrations Category and Find Hubspot. Click on Hubspot and then click on the green button “Add to PandaDoc”. For more information about our Add-ons store, click here.
Step 1b: Finding HubSpot integration in PandaDoc. Next, in PandaDoc, go to Settings > Integrations > HubSpot and you will see a list of instructions. Click on the Green button “Connect HubSpot Integration”.
Step 1c: Authorization the connection – Next, we will need to authorize the integration by logging into your HubSpot account.
Once connected, you will be presented with a “Successful Authentication” window. This shows PandaDoc has been connected with Hubspot.
Next, you do have the option to check “Show all member’s documents in Hubspot”.. By checking this, all of your PandaDoc Documents you created for that object in Hubspot will be accessible by all your team members.
Step 2: Access PandaDoc integration in Hubspot. Open any Contact, Companies and Deal Objects. Then Scroll down until you see PandaDoc. Here you will see the options to “Create Document” and “Actions-Show PandaDoc Tokens”.
Step 3: Setup of PandaDoc Templates to be used with HubSpot. Next, we need to setup our templates and how we want to pull in data from HubSpot. In the following sections, we will discuss the setup of “Roles” and “Tokens”.
Step 3-A: Use of PandaDoc Roles and templates to import Contact information. With the use of PandaDoc Roles, we can import from HubSpot Deal object, contact information. The following information: First Name, Last Name, Email Address and Company. Click here for more details about how to use PandaDoc Roles.
Step 3-B: Setup your tokens to pre-populate your documents with potential data.
Tokens are very helpful timesavers that will auto-fill information from a Deal, Contact or Organization records into a document. Learn more about tokens here.
To view all of the available data that you can push from the HubSpot objects, in the PandaDoc section, click on “Actions” then “Show PandaDoc Tokens”.
Please note: if you create a doc from a Deal object: Company and Deal tokens will work;
If from Company object – only Company tokens;
If from Contact object – Company, Contact tokens.
Here you can see a full list of the tokens used for this object in HubSpot.
Let’s say you want to pre-populate your standard proposal template with the following data from a HubSpot potential: client information (company name) and (Company Phone)
To do so, first go to PandaDoc and open your template. Then copy and paste token IDs from the PandaDoc panel within HubSpot into your template. The most important thing is to place them into square brackets. This is what differentiates them from regular text.
From now on every document that you create from a property within HubSpot — using this template — will be prefilled with the contact’s company and company’s address.
Step 3-C: Example list of tokens that can be used from HubSpot:
|HubSpot CRM Fields||PandaDoc Token to Use|
|Company About Us||[Company.AboutUs]|
|Company Address 2||[Company.Address2]|
|Company Founded Year||[Company.FoundedYear]|
|Company About Us||[Company.AboutUs]|
|Company is Public||[Company.IsPublic]|
|Company Notes Last Contacted||[Company.NotesLastContacted]|
|Company Recent Deal Amount||[Company.RecentDealAmount]|
|Company Total Revenue||[Company.TotalRevenue]|
|HubSpot CRM Deal Fields||PandaDoc Token to Use|
|Deal Close Date||[Deal.Closedate]|
|Deal Created Date||[Deal.Createdate]|
|Owner First Name||[Deal.OwnerFirstName]|
|Owner Last Name||[Deal.OwnerLastName]|
|Deal Notes Last Updated||[Deal.NotesLastUpdated]|
|Deal Number Associated Contacts||[Deal.NumAssociatedContacts]|
|HubSpot CRM Contact Fields||PandaDoc Token to Use|
|Contact First Name||[Contact.Firstname]|
|Contact Last Name||[Contact.Lastname]|
|Contact Company Name||[Contact.Company]|
|Contact Phone Number||[Contact.Phone]|
|Contact Mobile Phone||[Contact.Mobilephone]|
|Contact Job Title||[Contact.Jobtitle]|
|Contact IP Address||[Contact.Ipaddress]|
|Contact Owner First Name||[Contact.OwnerFirstName]|
|Contact Owner Last Name||[Contact.OwnerLastName]|
|Contact Owner Email Address||[Contact.OwnerEmail]|
|Contact Notes Last Contacted||[Contact.NotesLastContacted]|
|Contact Number Conversion Events||[Contact.NumUniqueConversionEvents]|
|Contact Recent Deal Amount||[Contact.RecentDealAmount]|
|Contact Total Revenue||[Contact.TotalRevenue]|
Step 3-D: HubSpot CRM Custom Properties and Tokens. You can also use tokens to populate information from custom properties that you create in HubSpot.
To create a custom property, follow this HubSpot article. Please Note: Each object has its own set of properties and associated tokens that work with it. Make sure that you are using the correct tokens for the object, otherwise your information will not be populated.
After your property is created, open the object you are working from, fill out the property within the object (custom property won’t show up in the token list if the field is empty) and find your new property in the token list. Can’t find your new property in your token list? Here are some troubleshooting tips:
- Make sure you are using the correct token for the object.
- Make sure that the corresponding property in HubSpot is filled with a value.
- Add your property to your default list of properties.
- Make sure your property is not located in any Custom Property Groups.
|Examples of Custom Fields in HubSpot CRM||PandaDoc Token to Use|
|Deal Custom Fields:|
|Ex: Number of Employees||[Deal.NumberOfEmployees]|
|Ex: OS Version Used||[Contact.OsVersionUsed]|
|Ex: Number Of Employees||[Company.NumberOfEmployees]|
Step 4: Using Fields. Similar to tokens, you can pass data into PandaDoc fields. Unlike the tokens, you will not need the square brackets.
In the list of tokens found in Step 3-D above, you will need to copy the token without the square brackets into the “Title” of the PandaDoc field.
Step 5: Tracking Documents. Once you have sent out a document using the Integration, the documents will be shown In the PandaDoc section for that HubSpot object.
Step 6: Using HubSpot CRM Contact Event tracker to track status updates for documents created in a HubSpot Deal. Click on “Filter timeline” and check the box for PandaDoc. The document events (status updates: sent, viewed, completed, etc..) will be displayed in the event tracker.
If you create a PandaDoc document from a HubSpot “Deal”, document tracking will appear on the associated HubSpot “Contact” timeline.
If you create a PandaDoc document from a Hubspot “Contact”, document tracking will appear on the associated HubSpot “Contact” timeline.
Step 7: Hubspot Permissions to use Integrations. It possible you have team members in your account and they are unable to use the Hubspot Integration with PandaDoc. You will need to go to Hubspot > Settings > User and setup your team members with the following setup to use the integration.
Step 8: Removing PandaDoc Integration from Hubspot. To remove, please go through the following steps. In Hubspot, go to Settings > Integrations > Find PandaDoc, Click Uninstall and then confirm the installation.
Step 9: Removing documents If you want to remove the documents that are associated to the HubSpot object, you would need to delete those documents from your PandaDoc account.
PandaDoc / Hubspot integration via Google Chrome Store (old integration), how to uninstall. If you have installed the new version (steps above), you can uninstall the Google Chrome extension, as this version is no longer needed. To uninstall, go to Chrome Settings >Settings > Extensions. Find “Documents Automation for HubSpot CRM” and click on the “trashcan” icon to remove it. Please note: If you had created existing PandaDoc documents using the Chrome Extension, those same documents will appear in the new version of the integration.
Tokens used from Chrome Extension, will work in the new version. If you have setup your tokens in your PandaDoc templates using the Chrome Extension, they will continue to work with the new integration. We had to make these lower to UPPER case changes due to how the two applications work together to connect and send/receive data.
Tokens used from Native Version, will not work Chrome Extension. If you have setup tokens to be used with the Native version, please note that they will not work with the Chrome Extension. We apologize for any inconvenience.