Skip to content
WbizTool

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#

RouteHubSpot → WhatsAppWhatsApp → HubSpotWhat it needs
ZapierNew Contact or Updated Deal Stage trigger, then a WbizTool send actionThe WbizTool Incoming WhatsApp Message trigger, then HubSpot Find Contact and Create EngagementA Zapier account. No webhook to set up.
MakeHubSpot CRM Watch Contacts, then the HTTP moduleA Make custom webhook, then HTTP requests to HubSpot's APIA Make account. There's no WbizTool app on Make: the HTTP module calls the WbizTool API.
n8nHubSpot Trigger, then WbizTool Send MessageA Webhook node, then the HubSpot node and HTTP requests to HubSpotn8n with the WbizTool community node. The HubSpot Trigger needs a HubSpot developer account and app.
Pabbly ConnectA HubSpot trigger, then API (Pabbly)Webhook by Pabbly, then API requests to HubSpotA Pabbly Connect account. It works through Pabbly's HTTP and webhook steps.
HubSpot workflowThe Send a webhook action calls the WbizTool API directlyUse another routeData 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:

  1. Trigger: HubSpot, New Contact

    Choose HubSpot and the New Contact trigger, and connect your HubSpot account.

  2. Filter by Zapier

    Continue only when the contact's phone number exists. Contacts without a number would fail the next step.

  3. 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.

  4. 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:

  1. Trigger: HubSpot, Updated Deal Stage

    Choose Updated Deal Stage and pick the pipeline and stage, such as Closed won.

  2. 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.

  3. 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.

  1. 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.

  2. 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.

  3. HTTP, Make a request

    Method POST, URL https://wbiztool.com/api/v1/send_msg/. Add a header Authorization with the value Bearer YOUR_API_KEY. Body type application/x-www-form-urlencoded, with these fields:

    FieldValue
    whatsapp_clientYour WhatsApp Client ID, such as 678
    phoneThe contact's Phone number from the HubSpot module
    country_codeOnly if your numbers are saved without it, such as 1
    msgYour text, with fields such as the first name mapped in
  4. 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": 1 means 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.

  1. Install the WbizTool node

    Install n8n-nodes-wbiztool and create a WbizTool API credential. See n8n integration.

  2. 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.

  3. Import the workflow

    In n8n, import the file and pick your credentials in each HubSpot, HTTP Request and WbizTool node.

  4. Set your stage and message

    In the Deal stage is node, replace closedwon with 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.

  5. Activate

    The trigger then registers its webhook with HubSpot.

What the workflow does:

  1. HubSpot Trigger with two events: Contact Created, and Deal Property Changed for the Deal Stage property.
  2. An IF node sends contact events one way and deal events the other.
  3. For a deal, it checks the new stage, then reads the deal and its associated contacts with an HTTP Request to HubSpot.
  4. HubSpot → Search Contacts reads the contact's first name and phone numbers.
  5. 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.

  1. 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.

  2. Add Send a webhook

    Click +, and under Data ops choose Send a webhook. Method POST, webhook URL https://wbiztool.com/api/v1/send_msg/.

  3. 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 to Authorization and the location to Request header.

  4. Customize the request body

    Choose Customize request body and add:

    KeyValue
    phoneProperty: Phone number
    whatsapp_clientStatic value: your WhatsApp Client ID, such as 678
    msgStatic value: your message
    country_codeStatic value, only if your numbers are saved without it
  5. 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 msg is 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 4xx answers except 429, so a refused message, such as Invalid phone number, isn't sent again. To stop a retry after a timeout from sending a message twice, add a key idempotency_key with 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:

  1. Skip group chats (contact.is_group is true) and contacts whose number WhatsApp hides (contact.phone_hidden is true).
  2. Remove your country code from the front of contact.phone (see Phone numbers).
  3. Search HubSpot contacts whose Phone number or Mobile phone number equals that number.
  4. If there's none, create a contact with Phone number + and contact.phone, and First name contact.name.
  5. Create a note on the contact with the message: message.content, at message.timestamp.

With Zapier#

You don't set a webhook URL anywhere: the WbizTool trigger connects to Zapier when you publish the Zap.

  1. 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.

  2. Filter by Zapier

    Continue only when Contact Phone Hidden is false and Is Group is false.

  3. 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 +12125550120 becomes 2125550120.

  4. 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.

  5. HubSpot, Create Engagement

    Type Note, associated with the contact ID from the Find Contact step. Body: WhatsApp from Contact Name: Message Content.

With Make#

  1. Import the template

    Import hubspot-whatsapp-to-note.make.json in a new scenario.

  2. 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_KEY in the Authorization header with that key.

  3. Create the webhook

    In the Webhooks → Custom webhook module, click Add, name it and copy its address.

  4. 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.

  5. Set your country code

    In the Search the contact by phone module, the template removes 1 from the front of the number (/^1/, twice). Replace 1 with your country code, such as 91.

  6. 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#

  1. 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.

  2. Set your country code

    In the National number node, set countryCode to yours, such as 91.

  3. Activate and copy the address

    Activate the workflow and copy the Production URL of the WbizTool webhook node.

  4. 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

StepRequestBody
Find the contactPOST https://api.hubapi.com/crm/objects/2026-09/contacts/searchfilterGroups with phone EQ the number without its country code, and a second group with mobilephone; limit 1
Create it if missingPOST https://api.hubapi.com/crm/objects/2026-09/contactsproperties: phone +12125550120, firstname from contact.name
Add the notePOST https://api.hubapi.com/crm/objects/2026-09/notesproperties: 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#

FileToolWhat it does
hubspot-new-contact-to-whatsapp.make.jsonMakeNew HubSpot contact → WhatsApp message
hubspot-whatsapp-to-note.make.jsonMakeIncoming WhatsApp → note on the contact (needs the Unibox add-on)
hubspot-to-whatsapp.n8n.jsonn8nNew contact or deal stage → WhatsApp message
hubspot-whatsapp-to-note.n8n.jsonn8nIncoming 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#

ProblemWhat to check
Invalid phone numberThe 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 numberThe 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 keyThe 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 clientUse the number's ID from WhatsApp numbers.
Send a webhook isn't in the workflow actionsIt needs Data Hub Professional or Enterprise. Use Zapier, Make, n8n or Pabbly Connect instead.
Make can't connect to HubSpotA Super Admin of the HubSpot account has to approve the Make app first.
No notes appear in HubSpotCheck 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 themYour 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 HubSpotHubSpot 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 twiceWbizTool can, rarely, post a message twice. Skip a message.id you've already logged.
No note for some messagesGroup chats and contacts whose number WhatsApp hides are skipped by design. Messages from while the number was stopped aren't posted.