Integrations
HubSpot and WhatsApp
Connect HubSpot to your WhatsApp number in both directions:
- HubSpot → WhatsApp: when a contact is created or a deal moves to a stage, send that person a WhatsApp message from your own number.
- WhatsApp → HubSpot: when someone messages your WhatsApp number, add the message as a note on their HubSpot contact, and create the contact if it doesn't exist yet.
WbizTool has no HubSpot app. These recipes connect the two through Zapier, Make, n8n, Pabbly Connect or a HubSpot workflow, with ready-made templates for Make and n8n.
Who can do it: In WbizTool, an Owner creates the API key on Settings → API keys (see API keys); Owners and Editors set up Inbox numbers for the WhatsApp → HubSpot direction. In HubSpot, you need the rights to connect apps or edit workflows; each route below says what it needs.
Before you start#
- A connected WhatsApp number on WhatsApp numbers. See Connect your WhatsApp number.
- Your API key, and for some tools your Client ID, from Settings → API keys, and the WhatsApp Client ID of the number that sends (its ID on WhatsApp numbers).
- For WhatsApp → HubSpot only: the Unibox add-on. Incoming messages reach HubSpot through the Inbox numbers webhook, which needs the Unibox add-on: $20 a month or $200 a year at US list prices for each inbox number, on a paid or lifetime plan (not the free trial). Sending messages doesn't need it.
Pick a route#
| Route | HubSpot → WhatsApp | WhatsApp → HubSpot | What it needs |
|---|---|---|---|
| Zapier | New Contact or Updated Deal Stage trigger, then a WbizTool send action | The WbizTool Incoming WhatsApp Message trigger, then HubSpot Find Contact and Create Engagement | A Zapier account. No webhook to set up. |
| Make | HubSpot CRM Watch Contacts, then the HTTP module | A Make custom webhook, then HTTP requests to HubSpot's API | A Make account. There's no WbizTool app on Make: the HTTP module calls the WbizTool API. |
| n8n | HubSpot Trigger, then WbizTool Send Message | A Webhook node, then the HubSpot node and HTTP requests to HubSpot | n8n with the WbizTool community node. The HubSpot Trigger needs a HubSpot developer account and app. |
| Pabbly Connect | A HubSpot trigger, then API (Pabbly) | Webhook by Pabbly, then API requests to HubSpot | A Pabbly Connect account. It works through Pabbly's HTTP and webhook steps. |
| HubSpot workflow | The Send a webhook action calls the WbizTool API directly | Use another route | Data Hub Professional or Enterprise. No other tool needed. |
Phone numbers#
The two directions write numbers differently, so check this before you map fields.
HubSpot → WhatsApp. Map the contact's Phone number (or Mobile phone number) to the recipient's phone. WbizTool removes spaces, dashes, dots and brackets for you, so +1 (212) 555-0120 works. A number saved with + or 00 carries its country code. A number saved without it, such as 2125550120, needs the country code: fill Country Code in Zapier and n8n, or country_code in an HTTP request, such as 1 or 91. A number saved with both a country code and no +, such as 12125550120, works as it is. See phone and country_code on Send message.
WhatsApp → HubSpot. The webhook gives the sender as international digits without +, in contact.phone, such as 12125550120. HubSpot searches phone numbers by area code and local number only, without the country code. So before you search, remove your country code from the front: 12125550120 becomes 2125550120. The templates do this for one country code you set. When you create a contact, save the number as + followed by the digits, such as +12125550120, so HubSpot knows its country.
Send a WhatsApp message from HubSpot#
With Zapier#
Use the HubSpot trigger you need, then a WbizTool action. Connect WbizTool with your Client ID and API key (see Zapier integration).
When a contact is created:
Trigger: HubSpot, New Contact
Choose HubSpot and the New Contact trigger, and connect your HubSpot account.
Filter by Zapier
Continue only when the contact's phone number exists. Contacts without a number would fail the next step.
Action: WbizTool, Send Text-Only WhatsApp Message
Pick the sending number under WhatsApp Number. Map Phone Number to the contact's phone number. Fill Country Code only if your HubSpot numbers are saved without it. Write the Message, for example
Hi {first name}, thanks for getting in touch. You can reach us here on WhatsApp.Test and publish
A successful step means the message was queued. WbizTool then sends it from your number.
When a deal moves to a stage:
Trigger: HubSpot, Updated Deal Stage
Choose Updated Deal Stage and pick the pipeline and stage, such as Closed won.
Find the deal's contact
A deal doesn't hold a phone number: its contact does. Add HubSpot Get Contact with the contact ID associated with the deal. If the trigger's data has no contact ID, add HubSpot Find Associations first to get the deal's contacts.
Filter, then send
Add a Filter by Zapier step that continues when the phone number exists, then Send Text-Only WhatsApp Message as above. You can use deal fields in the text, such as the deal name.
With Make#
There's no WbizTool app on Make. Make's HTTP module calls the Send message API. Of the two Make templates, this one uses a Make HubSpot connection (Watch Contacts); the WhatsApp → HubSpot one uses only Make's built-in modules and a HubSpot service key.
Import the template or start a scenario
Import hubspot-new-contact-to-whatsapp.make.json (⋯ → Import Blueprint in a new scenario), or build it with the steps below.
HubSpot CRM, Watch Contacts
Add the HubSpot CRM Watch Contacts module and connect HubSpot. A Super Admin of your HubSpot account has to approve the Make app first. Make asks where to start: choose From now on to message only new contacts.
HTTP, Make a request
Method
POST, URLhttps://wbiztool.com/api/v1/send_msg/. Add a headerAuthorizationwith the valueBearer YOUR_API_KEY. Body type application/x-www-form-urlencoded, with these fields:Field Value whatsapp_clientYour WhatsApp Client ID, such as 678phoneThe contact's Phone number from the HubSpot module country_codeOnly if your numbers are saved without it, such as 1msgYour text, with fields such as the first name mapped in Add a filter and run once
On the link between the two modules, add a filter that passes only when the phone number exists. Run the scenario once: a response with
"status": 1means the message was queued.
Form fields keep working when a mapped value has quotes or line breaks, which can break a raw JSON body. JSON works too; see Body fields. For a deal stage in Make, use a HubSpot workflow that posts to a Make custom webhook, or the Zapier or n8n route.
With n8n#
The template hubspot-to-whatsapp.n8n.json handles both events in one workflow: a new contact, and a deal that moves to a stage.
Install the WbizTool node
Install
n8n-nodes-wbiztooland create a WbizTool API credential. See n8n integration.Create the HubSpot credentials
The HubSpot Trigger needs a HubSpot Developer API credential: a HubSpot developer account, an app with read scopes for contacts and deals, and n8n's redirect URL in that app (see n8n's HubSpot credentials page). The other HubSpot steps use a HubSpot Service Key credential: in HubSpot, go to Development → Keys → Service keys, click Create service key and add the contacts and deals read scopes.
Import the workflow
In n8n, import the file and pick your credentials in each HubSpot, HTTP Request and WbizTool node.
Set your stage and message
In the Deal stage is node, replace
closedwonwith the internal value of your stage. Edit the text in the two WbizTool Send Message nodes, and set Country Code there only if your numbers are saved without it.Activate
The trigger then registers its webhook with HubSpot.
What the workflow does:
- HubSpot Trigger with two events: Contact Created, and Deal Property Changed for the Deal Stage property.
- An IF node sends contact events one way and deal events the other.
- For a deal, it checks the new stage, then reads the deal and its associated contacts with an HTTP Request to HubSpot.
- HubSpot → Search Contacts reads the contact's first name and phone numbers.
- WbizTool Send Message sends the text to the phone number, or the mobile number when the phone is empty.
With a HubSpot workflow#
With Data Hub Professional or Enterprise, a workflow can call the WbizTool API itself with the Send a webhook action. No other tool is involved.
Create a contact-based workflow
In HubSpot, go to Automation → Workflows and create a workflow on contacts, with the trigger you want, such as a contact being created or its lifecycle stage changing.
Add Send a webhook
Click +, and under Data ops choose Send a webhook. Method
POST, webhook URLhttps://wbiztool.com/api/v1/send_msg/.Set the authentication
Choose API key as the authentication type. Add a secret whose value is
Bearer YOUR_API_KEY(with your WbizTool key), set the API key name toAuthorizationand the location to Request header.Customize the request body
Choose Customize request body and add:
Key Value phoneProperty: Phone number whatsapp_clientStatic value: your WhatsApp Client ID, such as 678msgStatic value: your message country_codeStatic value, only if your numbers are saved without it Test it
Test the action with a contact that has your own number. WbizTool answers
{"status": 1, "message": "Created", "msg_id": …}when it queued the message.
- The message can't include the contact's name. In Customize request body, each key takes either one HubSpot property or one static value, so
msgis fixed text, the same for every contact. For a personal greeting, use the Zapier, Make or n8n route. - Retries: HubSpot retries a failed webhook for up to three days. It doesn't retry
4xxanswers except429, so a refused message, such asInvalid phone number, isn't sent again. To stop a retry after a timeout from sending a message twice, add a keyidempotency_keywith the property Record ID, if the workflow messages each contact at most once a day. See Retry safely. - Deals: these steps use a contact-based workflow, because the phone number is on the contact, not the deal. For messages on a deal stage, use the Zapier or n8n route.
With Pabbly Connect#
Pabbly Connect starts a workflow from HubSpot events such as New Contact Added or Deal Updated. Then add API (Pabbly) → Execute API Request with POST to https://wbiztool.com/api/v1/send_msg/, as on Send WhatsApp messages from any automation tool, and map the contact's phone number to phone.
Log incoming WhatsApp messages in HubSpot#
Each message someone sends to your number becomes a note on their HubSpot contact. This direction needs the Unibox add-on ($20 a month or $200 a year at US list prices for each inbox number, on a paid or lifetime plan), because messages leave WbizTool through the Inbox numbers webhook.
The recipe is the same in every tool:
- Skip group chats (
contact.is_groupistrue) and contacts whose number WhatsApp hides (contact.phone_hiddenistrue). - Remove your country code from the front of
contact.phone(see Phone numbers). - Search HubSpot contacts whose Phone number or Mobile phone number equals that number.
- If there's none, create a contact with Phone number
+andcontact.phone, and First namecontact.name. - Create a note on the contact with the message:
message.content, atmessage.timestamp.
With Zapier#
You don't set a webhook URL anywhere: the WbizTool trigger connects to Zapier when you publish the Zap.
Trigger: WbizTool, Incoming WhatsApp Message
Pick the number under WhatsApp Number. The Zap takes one of your inbox numbers (see Trigger requirements). Only messages people send you start it.
Filter by Zapier
Continue only when Contact Phone Hidden is false and Is Group is false.
Formatter by Zapier: remove the country code
Choose Formatter, action event Numbers, transform Format Phone Number. Input:
+followed by Contact Phone. Pick a national format without symbols under To Format, so+12125550120becomes2125550120.HubSpot, Find Contact
Search by Phone Number with the Formatter's output. Tick the option to create the contact if it isn't found, with Phone Number
+and Contact Phone, and First Name from Contact Name.HubSpot, Create Engagement
Type Note, associated with the contact ID from the Find Contact step. Body:
WhatsApp fromContact Name: Message Content.
With Make#
Import the template
Import hubspot-whatsapp-to-note.make.json in a new scenario.
Add your HubSpot service key
In HubSpot, go to Development → Keys → Service keys, click Create service key and add the contacts read and write scopes. In each HTTP module of the scenario, replace
YOUR_HUBSPOT_SERVICE_KEYin theAuthorizationheader with that key.Create the webhook
In the Webhooks → Custom webhook module, click Add, name it and copy its address.
Add the address to your inbox number
In WbizTool, open Inbox numbers, click Webhook settings on the number's card (or Add number to inbox), paste the address under Webhook URL (optional) and click Save. Keep Received messages ticked; tick Sent messages too if you want your replies in HubSpot.
Set your country code
In the Search the contact by phone module, the template removes
1from the front of the number (/^1/, twice). Replace1with your country code, such as91.Turn the scenario on
Send your WhatsApp number a message from another phone. It arrives within a minute or two, and Make learns the webhook's fields from it: check the mappings once.
The scenario: Custom webhook → an HTTP request to HubSpot's contact search → a router. When a contact is found, an HTTP request adds the note to it. When none is, one request creates the contact and another adds the note. JSON → Transform to JSON steps turn the message and the name into JSON text, so quotes and line breaks don't break the requests.
With n8n#
Import the workflow
Import hubspot-whatsapp-to-note.n8n.json and pick a HubSpot Service Key credential in the HubSpot and HTTP Request nodes. The key needs the contacts read and write scopes.
Set your country code
In the National number node, set
countryCodeto yours, such as91.Activate and copy the address
Activate the workflow and copy the Production URL of the WbizTool webhook node.
Add the address to your inbox number
Paste it as the number's webhook on Inbox numbers, as in the Make steps above.
n8n's HubSpot node has no note action, so the workflow creates the contact and the note with HTTP Request nodes that use the same HubSpot credential. The Webhook node answers at once, well within the 8 seconds WbizTool waits.
With Pabbly Connect#
Start with Webhook by Pabbly and paste its URL as the number's webhook on Inbox numbers. Then call HubSpot's API with API (Pabbly) → Execute API Request, with a HubSpot service key as a Bearer token: POST https://api.hubapi.com/crm/objects/2026-09/contacts/search to find the contact, POST …/contacts to create one, and POST …/notes to add the note (see The requests your server makes).
On your own server#
Receive the webhook as described in Incoming message webhooks, verify its signature, answer 200 at once, and then make these HubSpot API calls with a service key.
The requests your server makes
| Step | Request | Body |
|---|---|---|
| Find the contact | POST https://api.hubapi.com/crm/objects/2026-09/contacts/search | filterGroups with phone EQ the number without its country code, and a second group with mobilephone; limit 1 |
| Create it if missing | POST https://api.hubapi.com/crm/objects/2026-09/contacts | properties: phone +12125550120, firstname from contact.name |
| Add the note | POST https://api.hubapi.com/crm/objects/2026-09/notes | properties: hs_timestamp from message.timestamp, hs_note_body with the text; associations to the contact with associationCategory HUBSPOT_DEFINED and associationTypeId 202 (note to contact) |
{
"properties": {
"hs_timestamp": "2026-10-15T10:30:04+00:00",
"hs_note_body": "WhatsApp from Emma Thompson (+12125550120): Can I add a gift note to it?"
},
"associations": [
{
"to": { "id": "CONTACT_ID" },
"types": [{ "associationCategory": "HUBSPOT_DEFINED", "associationTypeId": 202 }]
}
]
}
HubSpot's search endpoints allow five requests a second per account. Skip a message.id you've already logged: WbizTool can, rarely, post a message twice.
Templates#
| File | Tool | What it does |
|---|---|---|
| hubspot-new-contact-to-whatsapp.make.json | Make | New HubSpot contact → WhatsApp message |
| hubspot-whatsapp-to-note.make.json | Make | Incoming WhatsApp → note on the contact (needs the Unibox add-on) |
| hubspot-to-whatsapp.n8n.json | n8n | New contact or deal stage → WhatsApp message |
| hubspot-whatsapp-to-note.n8n.json | n8n | Incoming WhatsApp → note on the contact (needs the Unibox add-on) |
The templates hold no keys. After importing, pick your own connections or credentials in each step, and replace YOUR_API_KEY, YOUR_HUBSPOT_SERVICE_KEY, the WhatsApp Client ID 678 and the country code with yours.
Troubleshooting#
| Problem | What to check |
|---|---|
Invalid phone number | The contact's phone is empty, has letters, or has fewer than 6 or more than 17 digits. Add a filter that skips contacts without a number. |
| The message goes to the wrong number | The number is saved without its country code and none was sent. Fill Country Code or country_code, or save numbers in HubSpot with +. |
Auth Error: invalid api key | The key was deleted or mistyped. In a HubSpot workflow, the secret's value must be Bearer followed by the key, and the API key name Authorization. |
Invalid whatsapp client | Use the number's ID from WhatsApp numbers. |
| Send a webhook isn't in the workflow actions | It needs Data Hub Professional or Enterprise. Use Zapier, Make, n8n or Pabbly Connect instead. |
| Make can't connect to HubSpot | A Super Admin of the HubSpot account has to approve the Make app first. |
| No notes appear in HubSpot | Check that the number shows Syncing on Inbox numbers, that the webhook URL is the one from your tool and Received messages is ticked. Send a message from another phone: replies from the Unibox inbox aren't posted. |
| Webhooks don't arrive, or your host refuses them | Your receiver must answer 2xx within 8 seconds and must not redirect. Some hosting firewalls block unknown clients: WbizTool's webhooks come with the User-Agent WbizTool-Webhooks/1 (+https://wbiztool.com), so allow it. |
| A new contact is created for someone who's already in HubSpot | HubSpot didn't find the number. Check that the country code you remove is right and the contact's number is in Phone number or Mobile phone number. For customers in many countries, see Phone numbers. |
| A message is logged twice | WbizTool can, rarely, post a message twice. Skip a message.id you've already logged. |
| No note for some messages | Group chats and contacts whose number WhatsApp hides are skipped by design. Messages from while the number was stopped aren't posted. |

