Automated emails can backfire when they look like no one took the time to personalize them. If you’ve ever received a message that opened with “Hi [First Name]” because the actual name was missing, you’re not alone. Often, it’s not a content problem; it’s a data connection issue.
Custom tokens in HubSpot solve this problem. When configured correctly, tokens pull live CRM data into automated emails, allowing you to insert fields like company name, deal stage, or ticket ID directly into messages. Your outreach stays relevant and personal, even at scale.
Many RevOps and marketing teams struggle with token setup, particularly when the same property exists across contacts, companies, and deals. If tokens reference the wrong object, fields show up blank or inaccurate.
This guide walks you through finding and using custom tokens, avoiding mistakes, and monitoring performance in workflows or sequences.
What Custom Tokens Do In HubSpot Automated Emails
Custom tokens act as placeholders that pull real-time CRM values into automated emails. When each message is sent, HubSpot replaces the token with the corresponding CRM property.
Key points:
- Tokens can reference almost any object: Contact, Company, Deal, or Ticket.
- You can create custom properties and turn them into tokens for more tailored messaging.
- Example: In a post-demo workflow, the token {{ contact.last_product_demo_date }} dynamically updates with each prospect’s demo date.
Tokens can also be used in snippets, chatbots, and internal notifications, as long as the triggering record contains the referenced property.
How It Works Behind the Scenes
- Input: HubSpot reads the relevant property from your CRM (contact, company, deal, or ticket).
- Placement: Insert the token using the personalization menu in your workflow email.
- Merge: When the workflow triggers, HubSpot pulls the correct CRM value.
- Substitution: Just before sending, the token placeholder is replaced with live content.
- Output: The recipient receives a fully personalized email.
Important:
- If a token references a related record (e.g., a company token in a contact email), HubSpot checks associations. The contact must be linked to the company for the token to resolve.
- Fallback values ensure messages remain readable when data is missing, e.g., “your business” instead of a blank company name.
Main Uses Inside HubSpot
Marketing Personalization in Nurture Workflows
- Reduces manual segmentation while keeping emails tailored.
- Example: For leads who downloaded an ebook, {{ contact.hs_download_last }} inserts the downloaded asset title into the email.
Sales Sequences and Follow-Up Automation
- Automatically references deal info to reduce errors and lag.
- Example: {{ deal.amount }} and {{ deal.stage }} populate the correct values in post-demo follow-up emails.
Service Automation and Ticket Communication
- Provides clear, relevant updates in support workflows.
- Example: {{ ticket.subject }} and {{ ticket.id }} in ticket close emails informs customers which issue was resolved.
Common Setup Errors and Wrong Assumptions
- Using tokens tied to the wrong object
Problem: Contact token missing in a deal workflow.
Fix: Ensure tokens align with workflow object type. - Pulling tokens from unrelated objects
Problem: Using deal tokens in a contact-based workflow.
Fix: Match tokens to the workflow’s enrolled object. - Skipping fallback text
Problem: Missing data leaves placeholders visible.
Fix: Always add fallback text like “there” or “valued customer.” - Using outdated property names
Problem: Tokens don’t resolve after a property rename.
Fix: Reinsert tokens whenever property names change.
Step-by-Step Setup Guide
- Navigate to Automation > Workflows.
- Create or open a workflow (e.g., post-demo follow-up or nurture sequence).
- Add a Send Email action that uses custom tokens.
- Open the email editor for that action.
- Click Personalize, choose the object type (Contact, Company, Deal, Ticket), and select the property.
- Add fallback values for missing data.
- Save and publish the workflow.
- Test using sample contacts or records to ensure that tokens are populated correctly.
Tip: Verify that sample contacts have values in the CRM fields used by tokens; blank fields usually indicate data or association issues.
Measuring Results In HubSpot
- Workflow email reports: Compare open and click rates before and after adding tokens.
- Email analytics panel: Identify performance differences between token-rich and static emails.
- Custom dashboards: Track emails by personalization field, lifecycle stage, or engagement level.
- Data completeness reports: Monitor missing properties affecting personalization quality.
Checklist for ongoing tracking:
- Confirm workflows trigger correctly.
- Compare engagement for personalized vs. non-personalized emails.
- Review CRM completeness for key personalization fields.
- Check workflow logs for token resolution errors.
Real-World Example
A marketing ops manager builds a post-whitepaper download workflow. Tokens {{ contact.firstname }} and {{ company.industry }} populate email content. Missing values are replaced with fallback text “there” and “your industry.”
As leads enter the workflow, emails feel personalized. One week later, performance metrics show higher open rates than previous generic sends, proving that tokens drive engagement and personalization.
How INSIDEA Helps
Custom tokens can be simple but often break when fields are missing or workflows misfire. INSIDEA helps teams implement tokens accurately and scale automation across HubSpot.
Our services include:
- HubSpot onboarding: Align properties, associations, and workflows.
- HubSpot management: Maintain stable automations and clean CRM data.
- Automation refinement: Optimize workflows with token logic for real-world use cases.
- Data-driven reporting: Build dashboards to validate the impact of personalization.
Don’t let missing data or misfired tokens derail your automated emails. By using HubSpot custom tokens thoughtfully, every message becomes more personal, accurate, and effective. Start implementing today.
Get in touch with our HubSpot experts today!
