HubSpot
PostGrid's native HubSpot Integration allows you to send letters, postcards and cheques/checks to your customer list one at a time on demand, through workflow automation, or launch a bulk mailing campaign. In this guide, we will walk you through how to perform each step.
Overview
There are two major steps in the process of sending mail with PostGrid through HubSpot.
- Install and setup the account
- Send Mail
- Send a Single Mail to a Contact
- Send Bulk Personalized Mail To Multiple Contacts using Workflows
This section will walk you through finding and installing the PostGrid app, as well as setting up your PostGrid account.
Install PostGrid Application
Install the application by going to the "Marketplace" in your account and searching for PostGrid.
![](https://files.readme.io/df0215c-image.png)
You can install the application by clicking the "Install App" Button. Then, select your company name and click the “Choose Account” button.
![](https://files.readme.io/d3c9dca-image.png)
Then, Authorize by clicking the “Connect App” button.
![](https://files.readme.io/392c911-image.png)
Once you have authorized the PostGrid application, you need to provide your PostGrid API Keys. You can find your API key on your PostGrid dashboard settings page.
For further information on the API key, read here.
![](https://files.readme.io/6437bcf-image.png)
Finish the process by clicking on the "Save" button. You will be redirected to HubSpot.
Send a Single Mail to a Contact
You can send Letters, Postcards, and Checks/Cheques to a Contact. Navigate to the Contact Module in HubSpot.
Send A Letter
Select a contact you want to send a letter to. Scroll to the bottom on the right widget and click the button “Send Letter”
![](https://files.readme.io/a222d9f-image.png)
Filling in the template requirements
If you have a PDF Document, you can Upload it or Select a Template (from your template list in PostGrid).
Please read our design guidlines for letters here
![](https://files.readme.io/71f312e-image.png)
You can choose additional options such as Return Envelope, Extra Service (Certified Mail, Certified Mail with Return Receipt, Registered Mail), and Envelope Type (Standard Double Window, Flat Envelope). For our guide, we will use a simple template with Standard Double Window.
![](https://files.readme.io/3a74846-image.png)
Filling in the Recipient and Sender requirements
Recipient Details: The recipient details will be filled in from the contact details. If they are missing an address then you will have to put in the address fields (Address, City, State, Zip Code, Country)
![](https://files.readme.io/2064950-image.png)
Sender Details: Input the Sender Details. You will have to put Name, Address, City, State, Zip Code, and Country.
![](https://files.readme.io/fe243e3-image.png)
Filling in the mailing requirements
Document Options (Optional): You can add document options such as color, double-sided, insert blank page for address, perforate first page, express delivery, etc. For our demo purpose, we will select Insert blank page, which will insert a blank page where the recipient and sender details will be printed to cover the double-window envelope.
Merge Variables
For custom merge variables in your template follow these mapping criteria:
Use the merge variable {{metadata.variablename}}
. Ensure you have metadata.variablename
for HubSpot to recognize the merge variable. If you do not specify metadata with a period, the merge variable will not be recognized in the template. This is specifically to be used for HubSpot templates.
HubSpot merge variable examples:
{{metadata.coupon_code}}
{{metadata.deal_amount}}
{{metadata.birthday}}
{{metadata.renewal_date}}
If you have a custom merge variable like {{metadata.custom_variable1}}
, {{metadata.custom_variable2}}
, {{metadata.custom_variable3}}
in your HTML template, then our system in HubSpot will automatically recognize these variables.
- Select the
{{metadata.custom_variable1}}
in “Add Option”. - Then map that
{{metadata.custom_variable1}}
to a contact token in HubSpot. - Follow these steps for the other
{{metadata.custom_variable2}}
by clicking on the “Add Option” button again and selecting the{{metadata.custom_variable2}}
from the dropdown and mapping it to the contact token in HubSpot. - Follow these steps for the other
{{metadata.custom_variable3}}
by clicking on the “Add Option” button again and selecting the{{metadata.custom_variable3}}
from the dropdown and mapping it to the contact token in HubSpot.
Sending the letter
Click the “Send Letter” button to send a letter now.
![](https://files.readme.io/3d89cb5-image.png)
You can see the updated Status at the bottom of the right widget, as shown below.
![](https://files.readme.io/c54edc1-image.png)
Send A Postcard
Select a contact you want to send a Postcard to. Scroll to the bottom on the right widget and click the button “Send Postcard"
Filling in the mailing requirements
Select Mailing Class: Select the Mailing Class you want to send your Postcard with. You also have the option for Express Delivery.
Select Postcard Sizes: Select the postcard size you want to send.
![](https://files.readme.io/eec247b-image.png)
Filling in the Recipient and Sender requirements
Recipient Details: The recipient details will be filled in from the contact details. If they are missing an address then you will have to put in the address fields (Address, City, State, Zip Code, Country)
![](https://files.readme.io/6ccdad7-image.png)
Sender Details: Input the Sender Details. You will have to put your Name, Address, City, State, Zip Code, and Country.
![](https://files.readme.io/d90c840-image.png)
Filling in the template requirements
Choose Template or Upload PDF: You can Choose a Front and Back Postcard Template from your template library from PostGrid or upload a PDF Template.
![](https://files.readme.io/40a3ea5-image.png)
Please read our design guidlines for letters [here]
Merge Variables
Same as sending letters, you may use a custom merge variable in your template. You can learn more about them here
Sending the postcard
Click the “Send Postcard” button to send a postcard now.
![](https://files.readme.io/84c3275-image.png)
You can see the updated Status at the bottom of the right widget, as shown below
![](https://files.readme.io/e311908-image.png)
Send A Check/Cheque
Select a contact you want to send a Check/Cheque to. Scroll to the bottom on the right widget and click the button “Send Cheque"
![](https://files.readme.io/e26a8b9-image.png)
Filling in the Cheque requirements
Select the “Bank Account” you want to send cheques from.
![](https://files.readme.io/2fea524-image.png)
Cheque Amount, Memo, Cheque Number: Put the check amount in dollars ($), memo (optional), and cheque number (optional)
![](https://files.readme.io/c2ee1c9-image.png)
Filling in the Recipient and Sender requirements
Recipient Details: The recipient details will be filled in from the contact details. If they are missing address then you will have to put in the address fields (Address, City, State, Zip Code, Country).
![](https://files.readme.io/c9de8db-image.png)
Sender Details: Input the Sender Details. You will have to put Name, Address, City, State, Zip Code, Country.
![](https://files.readme.io/56e484e-image.png)
Filling in the other optional requirements
Custom HTML Message: Input any Custom HTML Message that will go at the top 2/3 of the Cheque.
![](https://files.readme.io/e87ace9-image.png)
Attach a letter: You can attach additional letters to go alongside your cheque.
![](https://files.readme.io/e8570bf-image.png)
Upload A Custom Cheque Logo: You can upload a custom logo of your company if you want (optional). It must be 100 x 100 px in dimensions.
![](https://files.readme.io/732c5f4-image.png)
Same as sending letters, you may use a custom merge variable in your template. You can learn more about them [here](https://postgrid.readme.io/docs/hubspot#merge-variables)
Sending the cheque
Click the “Send cheque” button to send a cheque now.
![](https://files.readme.io/59fb11c-image.png)
You can see the updated Status at the bottom of the right widget, as shown belo
![](https://files.readme.io/4953c35-image.png)
Send Bulk Personalized Mail To Multiple Contacts using Workflows
Setup the automation
Set up a workflow in HubSpot by navigating to the "Workflows" under the "Automation" menu.
![](https://files.readme.io/fcaa759-image.png)
Start creating a workflow from scratch.
![](https://files.readme.io/acc3792-image.png)
Set up triggers
Choose the Trigger type, and the interval of your trigger event and click on "Next". And set up the trigger.
![](https://files.readme.io/700edb6-image.png)
Set up Action
After you have selected your triggers, add an Action Step by clicking the ‘+' button shown in your Automation Diagram. Navigate to the "Integrated Apps" and locate the "PostGrid Print & Mail Direct"
Here, you have multiple choices regarding the type of mail, including letters and postcards you want to send. The list of Apps is as follows.
![](https://files.readme.io/cd15f83-image.png)
Send Bulk Letters
Filling in the Recipient and Sender requirements
Now, you need to define and map the variables one by one. You can manually type the details or select the relevant contact tokens for each field.
![](https://files.readme.io/1b2ced5-image.png)
![](https://files.readme.io/1108303-image.png)
Filling in the template requirements
You need to select the type of template you want to use. You can choose one of the templates in your PostGrid dashboard listed here, or share a publicly accessible URL link for the PDF.
To ensure your PDF file is publicly accessible, it must be hosted on a platform that does not require viewers to have an account or specific permission to view the document.
![](https://files.readme.io/d46266f-image.png)
You can learn more here about how to create a template with html and how to use PostGrid template editor
Filling in the mailing requirements
As you follow through with setting up the workflow, you need to define the value of the following criteria for your mailings.
- Express Delivery
- Mailing Class
- Extra Service
- Color
- Double Sided
You can learn more about sending mails through PostGrid, by reading guides for Letter, Postcard, and Self-Mailers
PostGrid offers a highly personalized template editor that allows you to add customized variables to your templates. So here, you can map the variables you've defined in your template to specific fields. There are twenty fields available for merging variable names and values
![](https://files.readme.io/bfa021a-image.png)
Same as sending single letters, you may use a custom merge variable in your template. You can learn more about them here
Once you have filled in all the requirements, click "Save," test your workflow, and click on the "Review and publish" button.
![](https://files.readme.io/a8fba4b-image.png)
Finally "Turn on" your workflow.
![](https://files.readme.io/60d2547-image.png)
Now, you can access your desired PostGrid Print & Mail service through HubSpot!
Send Bulk Postcards
Filling in the Recipient and Sender requirements
Now, you need to define and map the variables one by one. You can manually type the details or select the relevant contact tokens for each field.
![](https://files.readme.io/fa2f673-image.png)
![](https://files.readme.io/156b8a1-image.png)
Filling in the template requirements
You need to select the type of template you want to use. You can choose the front and back templates from your PostGrid dashboard listed here, or share a publicly accessible URL link for the PDF.
To ensure your PDF file is publicly accessible, it must be hosted on a platform that does not require viewers to have an account or specific permission to view the document.
![](https://files.readme.io/d46266f-image.png)
You can learn more here about how to create a template with html and how to use PostGrid template editor
Filling in the mailing requirements
As you follow through with setting up the workflow, you need to define the value of the following criteria for your mailings.
- Express Delivery
- Mailing Class
- Size in Inches
You can learn more about sending mails through PostGrid, by reading guides for Letter, Postcard, and Self-Mailers
PostGrid offers a highly personalized template editor that allows you to add customized variables to your templates. So here, you can map the variables you've defined in your template to specific fields. There are twenty fields available for merging variable names and values
![](https://files.readme.io/bfa021a-image.png)
Same as sending single letters, you may use a custom merge variable in your template. You can learn more about them here
Once you have filled in all the requirements, click "Save," test your workflow, and click on the "Review and publish" button.
![](https://files.readme.io/a8fba4b-image.png)
Finally "Turn on" your workflow.
Now, you can access your desired PostGrid Print & Mail service through HubSpot!
Updated about 1 month ago