How to Connect Aircall to HubSpot and Log Calls Automatically

Coding Liquids tutorial cover featuring Sagnik Bhattacharya for How to Connect Aircall to HubSpot and Log Calls Automatically.
Coding Liquids tutorial cover featuring Sagnik Bhattacharya for How to Connect Aircall to HubSpot and Log Calls Automatically.

In the Aircall Dashboard, go to Integrations > Apps, install HubSpot, authorise your HubSpot account and add the numbers whose calls should log. Then set the Logging & sync and Call Outcome options. Calls and voicemails log as call activities on the matching contact; follow-up tasks need a HubSpot workflow built on Aircall’s contact properties.

The Complete Excel Course with AI Integration

From formulas and pivot tables to Power Query, DAX, VBA and AI with Copilot, ChatGPT and Claude — hands-on from the first lesson.

By Sagnik Bhattacharya and Virginia Thorn, Primetime Emmy Award winner

Buy now

For a small sales team, the rule that matters most is ownership. A missed call on a line shared by several people is not owned by whoever was rung: Aircall gives it to the contact’s HubSpot owner, or to the fallback owner you choose in the settings. Decide who that is before go-live, and set the fallback to a person rather than Nobody.

What should Aircall log in HubSpot for a sales team?

Aircall should log each call as a call activity on the right contact, with an outcome that separates a conversation from an unanswered call, and a named person on every caller who needs a response.

Define the result in plain words before installing anything. A print shop might want every quotation enquiry on the right contact, a clear difference between a conversation and an unanswered call, and a named person on every caller who needs a response. Each part of that brief can be tested, which “sync everything” cannot.

Keep four things apart. A call activity records the event. An outcome describes its result. A ticket is a case to manage. A task tells someone to do something. A missed call can be logged perfectly while nobody has been told to return it, which is the gap this tutorial closes.

Here is where each piece of Aircall information lands in HubSpot, according to Aircall’s guide to how the integration works. Use it as your mapping sheet. There is no setting that sends call data to contact properties of your own choosing; anything beyond this list needs a HubSpot workflow.

Aircall informationWhere it appears in HubSpot
The call itselfA call activity (engagement) on the matched contact or company
Call resultThe call’s Call Outcome, from your outcome settings
Notes added during or after the callEngagement body: “[agent] added a new comment: …”
TagsEngagement body, and the Last used Aircall tags contact property
Recording or voicemailA link in the engagement body
Latest call time, outcome and numberThree more Aircall contact properties, used for workflows
AI summary and insightsTitled sections in the engagement body, when AI Assist is active

Keep a separate list of business fields you want changed, such as enquiry priority or quote stage. A successful call log proves none of them; each one needs its own workflow and its own test. Allow an illustrative hour for setup and another hour with two testers for acceptance, longer if the database has duplicate numbers.

How do you install the Aircall HubSpot integration?

To install the Aircall HubSpot integration, you need admin rights in both Aircall and HubSpot, and each user must sign in to both with the same email address. That email is how calls find their owner, according to Aircall's HubSpot installation guide. Then:

  1. Go to Aircall Dashboard > Integrations > Apps, search for HubSpot and select Install App.
  2. Approve Aircall’s access request with the button in the bottom-right corner of the prompt.
  3. Under Select numbers, click Add numbers, choose the quotation line only, and click Add numbers again. At least one number must be linked for any call to log.
  4. Sign in to HubSpot if asked, pick the right HubSpot account and click Choose account, then Connect app on the authorisation page.
  5. Click Create a test call log and find it in HubSpot, then place one real controlled call.
  6. Back in the Dashboard, check the integration’s General tab: status Active and the connected numbers you expect.

Installation creates four custom contact properties: Last Aircall call timestamp, Last Aircall call outcome, Last used Aircall phone number and Last used Aircall tags. They update on every call and are what HubSpot workflows trigger on. If your HubSpot account is at its custom-property limit, Aircall shows an error, the integration still activates without them, and you add them by hand under Settings > Properties > Create property, using the exact labels and field types in Aircall’s workflows guide.

Start with one line. The print shop connects its quotation line and leaves its supplier line out, so supplier calls should not appear in HubSpot at all. Put that expected exclusion on the test sheet; otherwise someone will report it as a fault. When you add a line later, repeat the controlled call and ownership checks for that line.

How does Aircall match a call to a HubSpot contact?

Aircall matches a call to a HubSpot contact in a fixed order: first an email match, then a phone number match on a contact, then a phone number match on a company. The email is the one on the saved Aircall contact, and the number can be in the Phone number or Mobile phone number field. If two contacts or two companies share a number, the call goes to the one updated most recently in HubSpot.

Formats matter. Aircall matches numbers in several formats, but its guides recommend E.164 (a plus sign and the full international number), no shared numbers between contacts, and different values in Phone number and Mobile phone number, because Aircall rejects the duplicate. Contact sync, which shows HubSpot names in the Aircall app, needs a valid number in the main Phone number field; a mobile-only contact will not sync. Aircall also says contact sync is not currently supported on iOS devices, and works with contacts only, not companies.

A wedding planner shows the duplicate problem. Two contacts from the same booking household share one number, and a test call lands on whichever was edited last. Agree which record is the main one, merge or clean the other, and retest. Changing outcome labels would not move the call.

Then choose the unknown-caller rule in Settings > Logging & sync. With Create a new HubSpot contact, Aircall creates a contact whose first name is the phone number and whose last name is “Aircall new contact”. With Do nothing, the call still logs but only appears in HubSpot’s Activity Dashboard, attached to no record, and no ticket is created for that number.

A bookkeeping practice turns creation on and adds a weekly clean-up: a saved HubSpot view of contacts whose last name is “Aircall new contact”, reviewed every Friday. In an illustrative week, 14 such contacts appear: 9 are genuine enquiries that get a real name and an owner, 3 are existing clients calling from new numbers and are merged, and 2 are spam and are deleted. Ten minutes a week keeps the database honest.

What call outcomes can Aircall send to HubSpot?

Aircall sends each call type to HubSpot with one of a short list of outcomes, such as Connected, No answer, Busy, Wrong number or Left voicemail, set under the integration's Call Outcome settings. Write your choice for each before testing:

Call typeOutcomes you can choose
Outbound answered callConnected or None
Outbound unanswered callNo answer or None
Outbound call to a contact already in a callBusy, No answer or None
Outbound call to a wrong numberWrong number, No answer or None
Inbound answered callConnected or None
Missed incoming call without voicemailNo answer or None
Missed incoming call with voicemailNo answer, None or Left voicemail

Connected does not mean a prospect spoke. Aircall says outbound calls that reach a voicemail or automated message count as answered, and it cannot tell a person from a machine, so they log as Connected whatever the agent chooses. If your reports need “spoke to decision-maker”, capture it with a tag.

Tags become outcomes through the Custom outcome section: click Add custom outcome, choose a tag and the HubSpot outcome it should set, including custom outcomes you created in HubSpot. A mapped tag overrides the default. If a call carries two mapped tags pointing to different outcomes, or the mapped tag is removed, the default applies. A tag added during the call shows in HubSpot only after the call ends, and deleting a mapping does not change calls already logged.

The print shop uses three tags: Quote requested, Proof query and Supplier call. These are its own labels, not built-in ones. Only Quote requested is mapped, to a custom HubSpot outcome called Quote requested; the others stay as context in the engagement body. Then the team runs a deliberate conflict test, two mapped tags on one call, and confirms the default outcome appears, so everyone knows to pick one primary tag per call.

How do you create a HubSpot task from a missed call or voicemail?

Use a contact-based HubSpot workflow whose trigger is the Last Aircall call outcome property, with a Create task action assigned to the contact owner.

Aircall’s HubSpot settings offer tickets, not tasks. Under Tickets & helpdesk creation you pick a ticket pipeline, then for each communication type, including Missed call without voicemail and Missed call with voicemail, choose Create a new ticket, Update an existing ticket or Do nothing, plus the stage for new tickets. If you choose to update existing tickets and none exists, Aircall creates one. Tickets suit a support queue; a small sales team usually wants a task on the contact owner’s list instead.

Aircall’s guide to HubSpot workflows and custom properties is the route. Check your HubSpot tier first: at the time of writing, HubSpot’s Sales Hub pricing page lists up to 50 workflows with restricted triggers and actions on Starter, and fully customisable workflows from Professional, so on Starter confirm that a contact-property trigger and a create-task action are available before relying on this. The voicemail workflow, step by step:

  1. In HubSpot, go to Automation > Workflows, create a contact-based workflow and choose contact properties as the trigger.
  2. Search for “Aircall” and set the trigger to Last Aircall call outcome is Left voicemail.
  3. Turn on re-enrolment, so the workflow runs again the next time the property is updated.
  4. Add a Create task action: title “Return voicemail from [contact name]”, assigned to the contact owner, due today, with “Play the voicemail link in the latest call activity” in the notes.
  5. Leave out long delays. HubSpot will not re-enrol a contact that is still in the workflow, so a second voicemail during a two-day delay would create no second task.

Missed calls without voicemail need one extra decision. Their outcome, No answer, is shared with unanswered outbound calls, so a workflow on No answer would also fire after every unanswered sales call. Either set Outbound unanswered call to None in the Call Outcome settings (Aircall leaves the outcome property empty when the outcome is None, but you lose that label in HubSpot reports), or route outbound dialling through a separate number and add Last used Aircall phone number as a second condition.

A quick sum for the print shop, with illustrative figures: in a week its quotation line gets 15 missed calls without voicemail and 9 voicemails, so the two workflows create 24 tasks, about five per working day for the duty coordinator. If the same prospect rings twice in ten minutes, the coordinator handles one enquiry and closes the duplicate task with a note, keeping both call records for history.

Aircall’s guide also mentions Task Closing Automation: when it is enabled and a task is closed after the call, the call activity gets “(Task Closed)” and a link to the task. That is the extent of the documented task sync, so do not promise the team that tasks mirror both ways. If your HubSpot plan cannot build these workflows, use tickets, or the separate route in the missed-call task automation tutorial.

Walk six sales calls through a single acceptance sheet

Here is the main worked example. The print shop has three salespeople and one quotation number. It runs six controlled calls, each with a unique reference in the note so it can be followed from Aircall to HubSpot. All results are illustrative.

Controlled eventEvidence to inspectIllustrative result
Existing contact calls, agent answersActivity on the right contact, owned by the answering agentPass
Agent returns the enquiryOutbound activity with the note textPass
Outbound call gets no answerOutcome as configured, no task createdPass
Inbound call is missedActivity owned by the contact owner, plus a taskFail: no task
Caller leaves voicemailLeft voicemail outcome, playable link, taskPass
Unknown number callsNew “Aircall new contact” record, as chosenPass

Five of six pass, 83.3%, and the team still does not go live, because the failure is a customer nobody will call back. The cause is mundane: the No answer workflow was saved but never turned on. After switching it on, they repeat the missed call and also ring twice from the same test number ten minutes apart to prove the second call creates its own task once the first run has finished.

Two more checks. Ring after hours: Aircall logs calls outside a number’s business hours only if the Logging & sync setting includes them, so a voicemail can exist in Aircall and be missing from HubSpot by design. And repeat one call with a second agent, because a test run only by the installing admin hides email mismatches; if the agent’s email differs between the two systems, an answered call is assigned to the contact owner instead.

If you track the acceptance results in a spreadsheet, try The Complete Excel Course with AI Integration on Coding Liquids.

Can you trust Aircall's AI summaries in HubSpot?

Not without a check. A summary can turn a possibility into a fact, so sample the generated summaries against the call before you rely on them in a pipeline.

AI output in HubSpot depends on Aircall’s AI Assist. The pricing page includes call summaries on Professional, and Aircall’s AI Assist article adds that admins must still activate it and assign it to each user; on Essentials it is an add-on with a 14-day free trial. Insights are generated for transcribed calls with more than a minute of conversation and an Aircall user on the call. When active, the HubSpot engagement gets titled sections such as Call Summary (a link if long), Key Topics and Action Items, and Select AI Artifacts to Log chooses whether action items, sentiment, talk ratio and scorecard are included.

Transcripts are a separate switch. In the integration’s Conversation Intelligence section, Enable Aircall Transcription Logging sends Aircall’s transcripts to the HubSpot call record, and Expose Call Recordings to HubSpot decides whether HubSpot users can play the audio. Aircall’s transcripts guide says this needs AI Assist or AI Assist Pro, skips calls under one minute and applies only to future calls.

Check summaries against the call before trusting them in a pipeline. A wedding enquiry says, “We may need 80 invitations, but I will confirm the quantity after discussing it.” A summary reading “Customer ordered 80 invitations” turns a possibility into an order. The agent corrects the note and the next action stays “confirm quantity”; no stage change should rely on the unchecked summary.

Give staff a five-part note they can write even when no summary exists: request, confirmed facts, open question, agreed action, owner. For example: “Ref 418; quote for about 250 prints; quantity not confirmed; ask for artwork; owner: duty coordinator.” Sample a few generated summaries each week for quantities, dates, commitments and negatives such as “not”, and narrow what you rely on if corrections are frequent.

How do you test the handover when the usual salesperson is away?

Test the handover by running one case with the normal contact owner away. The backup must find the latest enquiry, see whether anyone already called back and decide what is outstanding, using only what an ordinary colleague would see. This catches a failure the logs cannot: the data exists, but the process lives in one person's head.

An IT support enquiry shows the difference a good task makes. A weak task says “call customer”. A useful one says “confirm maintenance scope before quoting; ref 62; contract renewal review due; duty sales coordinator owns the reply”. The backup can act without inventing a price or assuming the contract has ended.

After the backup responds, they record the outcome on the call and close the task. A third tester then opens the contact cold; if they cannot tell whether a callback happened, fix the note format before adding more automation.

Why are Aircall calls missing from HubSpot, and what do you check first?

When calls are missing from HubSpot, check the integration status on the General tab first. Aircall's call-logging troubleshooting guide puts that first, then a banner under Settings saying HubSpot authentication is invalid (logging stops until you reauthenticate), the number in Connected numbers, and the business-hours logging setting. Calls made while the integration was inactive are never logged retroactively, so keep a manual list of calls during any pause.

Wrong contact? Look for duplicate numbers, a number saved in an unsupported format, or identical Phone number and Mobile phone number values. Wrong owner? Compare the agent’s email in Aircall and HubSpot. Conference calls that started as an internal call between two Aircall users cannot be logged at all.

No recording link? Check that recording is switched on for the number under Numbers > the number > Settings, look in the engagement body rather than a separate field, and allow a few minutes for processing; very short calls may have no recording. Do not log the call again by hand to “fix” it, which only doubles your activity counts.

Name one integration owner to review number changes, user emails and outcome rules, and note that switching the integration off or deleting it leaves existing Aircall data in HubSpot. Compare phone demand with the callback queue in the Aircall dashboard review, and use the routing setup tutorial when calls reach the wrong destination in the first place.

If you want help fitting this into how your sales team actually runs, I offer one-to-one AI consultations for small businesses.

Further reads

Show 4 more related tutorials

Sources: Aircall Help Centre articles Installing your HubSpot integration; How to configure the HubSpot integration; How the HubSpot integration works; HubSpot workflows and custom properties; Troubleshooting call logging issues with the HubSpot integration; Calls going to voicemail are marked as connected in HubSpot; Using Aircall call transcripts in HubSpot; Discover AI Assist. HubSpot Knowledge Base, Create workflows and Workflows FAQ; HubSpot Sales Hub pricing page. Aircall pricing page.

Want a second pair of eyes on your setup?

Bring the process you're trying to fix. On a 1:1 call we'll work out which AI tools should handle it, which parts stay manual, and how to roll it out without disrupting the team.

Book a 1:1 call with me