Skip to main content
You can connect Housecall Pro to Avoca yourself. Launchpad walks you through it. You paste in an API key, choose the job types your assistant can book, and tell Avoca which technicians do which work. Find it at Deploy → Launchpad → Connect HousecallPro.

Before you start

You need:
  • A Housecall Pro login that can open Settings → API Access.
  • An idea of which job types your assistant should book on its own.
  • A list of which technicians handle which job types.
Never paste your Housecall Pro API key into an email, a support ticket, a chat, or a screenshot. Enter it only in the Avoca field below.

Connect Housecall Pro in Launchpad

1

Open Connect HousecallPro

Go to Deploy → Launchpad and open Connect HousecallPro.
2

Get your API key

Select Open HousecallPro API Access. In Housecall Pro, create an API key if you don’t have one, then copy the whole key.
3

Paste and test the key

  1. Paste the key into HousecallPro API key.
  2. Select Test & save key. When it works, you’ll see how many technicians Housecall Pro returned, and a note that a key is saved for your team.
  3. Select Continue.
The saved key stays hidden. To replace it, paste a new one and select Test & save key again.
4

Choose your job types

On Job types, select Refresh from HousecallPro to load them. Turn on only the job types your assistant should book without a person. Leave off anything your team wants to handle, like sales visits.
5

Describe each job type

  1. Under each job type you turn on, write a short definition: what a caller says that means this job type. Or select Generate definitions to draft them for any that are blank.
  2. Read each one before you move on.
  3. Select Continue.
6

Match technicians to job types

  1. On Technicians, select Refresh from HousecallPro.
  2. Turn on the field technicians who take booked work, not office staff.
  3. Under each technician, check every job type they can do.
  4. Select Finish.
Your assistant offers a time only when a technician who can do that job type is free. If Launchpad says no technician takes a job type, your assistant can’t find a time for it. Fix that before you go live.

Test it

  1. In Settings → Integrations → CRM, confirm the HouseCall Pro card shows Connected.
  2. Finish the rest of Launchpad: service areas, booking windows, and fees.
  3. Place a test booking with your Avoca team.
  4. In Housecall Pro, check the customer, address, job type, schedule, technician, and notes.
  5. If you use rescheduling or cancelling, test those too.

Review your Housecall Pro settings

After you’re connected, open Settings → Integrations → CRM → HouseCall Pro to fine-tune things. It has these sections:
  • Basic Configuration has your API Key and the booking options.
  • Job Types lets you add, sync, and describe job types.
    • Select Sync from HCP to pick them from your Housecall Pro account.
    • Select Generate Definitions to draft descriptions.
  • Technicians is where you fetch technicians, choose the active ones, and fill in the Technician / Job Type Matrix.
Select Save at the top of the page when you’re done. Changes aren’t applied until you save.

Decide between estimates and jobs

Leave Always Book Estimate and Always Book Job off if you want your assistant to decide between an estimate and a job from what each caller asks for.
  • Always Book Estimate creates every booking as an estimate, even for a repair or service call.
  • Always Book Job creates every booking as a job, even when the caller only wants an estimate.
Only one can be on at a time. Turning one on asks you to confirm and turns the other off.
These settings change what Housecall Pro creates for every new booking. Check with whoever handles your dispatch first. After a test, put them back the way you want them for live calls.

Arrival windows and availability

Arrival windows are set in the Booking windows part of Launchpad, and later in Business Info → Booking Windows. They aren’t pulled in from Housecall Pro. See Complete your Avoca setup for the full path.

Cancelling and rescheduling

What happens when a caller cancels or reschedules depends on whether the appointment is a job or an estimate.
  • Reschedule a job: Avoca moves the job to the new time.
  • Cancel a job: Housecall Pro doesn’t let Avoca fully cancel a job. Avoca removes the schedule and the assigned technicians. The job stays in Housecall Pro for your dispatcher to finish cancelling.
  • Reschedule an estimate: Avoca updates the estimate’s schedule and adds a note with the old and new times. It can’t reschedule an estimate that’s already in progress or finished.
  • Cancel an estimate: Housecall Pro doesn’t let Avoca cancel an estimate. Avoca adds a note to the estimate when it can and sends an alert. Your dispatcher finishes the cancellation in Housecall Pro.
When a caller cancels an estimate, your assistant may tell them it’s cancelled even though it’s still on your schedule. Check your post-call notification email for the estimate and cancel it in Housecall Pro. If your team doesn’t get those emails, contact Avoca Support.

More options

Launchpad has to be turned on for your team, and your role needs to be able to view Implementation. Ask your Avoca team to check both.
Some accounts get the key from the Housecall Pro App Store. In Housecall Pro, open the app menu and choose Go to App store.Housecall Pro app menu with Go to App store highlightedSearch for API Key Management and open it. Create a key there, then paste it into Launchpad.Housecall Pro App Store with API Key Management highlighted
Copy the whole key again and check for extra spaces. Make sure you’re using the API key, not a login password. If it still fails, contact your Avoca team with the error message. Don’t include the key.
Select Refresh from HousecallPro on that step. Both lists need a saved key first, so go back to the first step if the refresh does nothing.
Keep the list short and clear, like Service, Estimate, and Maintenance. Split job types only when a different group of technicians does the work. Skip job types you no longer use.
The booking options on Basic Configuration include Schedule by Job Type, Booking Window Mode, Skip Tech Assignment, Shared Technicians Across Team, and Use Job Duration For Calendar Block. Hover over the info icon next to each one for what it does. If you’re not sure, talk to your Avoca team before changing them.
Delete Integration removes your Housecall Pro connection for your team. Talk to your Avoca team first.
If you contact Support, include the call ID from Avoca and the job or estimate ID from Housecall Pro.