Webhook tool

Housecall Pro AI receptionist for the calls you can't take

The agent answers, collects the problem and address, and creates the job in Housecall Pro through webhook tools you control.

Home service booking agent

Answers missed calls and creates jobs.

Instructions

Collect the caller's name, address and problem. Look up the customer, ask what day and time they want, and create the job. Do not quote prices. Transfer existing customers who ask for the office.

Handoff
Office line

Connected tools

  • Find customerWebhook
  • Create jobWebhook
  • Transfer to officeTransfer

What a Housecall Pro AI voice agent can do

Open one to watch a call. The grey lines are the tools the agent calls mid-sentence.

The agent answers every ring and writes what it learned into a new job, so the office starts from notes, not a voicemail.

Tool definitions

Webhook tools go to POST /v1/agents/tools. Transfers are a system tool on the agent. Replace the placeholder values in capitals with your own.

Webhook

Find customer

Searches customers by phone number.

Show the JSON definition
find_customer
{
  "type": "webhook",
  "name": "find_customer",
  "description": "Finds a customer by phone number. Saves customer.id from the response as customer_id.",
  "pre_tool_speech": "auto",
  "execution_mode": "immediate",
  "response_timeout_secs": 20,
  "api_schema": {
    "url": "https://api.your-company.com/housecall/customers",
    "method": "GET",
    "query_params_schema": {
      "properties": {
        "phone": {
          "type": "string",
          "description": "Caller phone number, E.164."
        }
      }
    },
    "authentication": {
      "mode": "bearer",
      "token": {
        "type": "secret",
        "secret_value": "YOUR_SERVICE_TOKEN"
      }
    }
  },
  "assignments": [
    {
      "dynamic_variable": "customer_id",
      "value_path": "customer.id"
    }
  ]
}

Webhook

Create job

Creates a job with address, problem and requested time.

Show the JSON definition
create_job
{
  "type": "webhook",
  "name": "create_job",
  "description": "Creates a job for the caller with the time they asked for.",
  "pre_tool_speech": "auto",
  "execution_mode": "immediate",
  "response_timeout_secs": 20,
  "api_schema": {
    "url": "https://api.your-company.com/housecall/jobs",
    "method": "POST",
    "request_body_schema": {
      "type": "object",
      "properties": {
        "customer_id": {
          "type": "string",
          "dynamic_variable": "customer_id"
        },
        "address": {
          "type": "string",
          "description": "Service address."
        },
        "problem": {
          "type": "string",
          "description": "What the caller described."
        },
        "scheduled_start": {
          "type": "string",
          "description": "Chosen start time, ISO 8601."
        }
      },
      "required": [
        "address",
        "problem",
        "scheduled_start"
      ]
    },
    "authentication": {
      "mode": "bearer",
      "token": {
        "type": "secret",
        "secret_value": "YOUR_SERVICE_TOKEN"
      }
    }
  }
}

Transfer

Transfer to office

Cold transfer to the office line.

Show the JSON definition
transfer_to_office
{
  "config": {
    "system_tools": {
      "transfer_to_number": {
        "description": null,
        "pre_tool_speech": "auto",
        "transfers": [
          {
            "destination": {
              "type": "phone",
              "phone_number": "+14155550101"
            },
            "condition": "The caller is an existing customer who asks for the office or a person."
          }
        ]
      }
    }
  }
}

Set it up

There is no Housecall Pro connector. The agent calls webhook tools you configure, pointed at a service of yours that uses Housecall Pro's API. Vendor details read in October 2026.

  1. Get API access

    An admin generates an API key in Housecall Pro. Housecall Pro offers API keys on the MAX plan only.

  2. Expose two endpoints

    Your service looks up customers and creates jobs using Housecall Pro's API. The lookup returns the match as customer.id, which the tool saves as customer_id for the job.

  3. Add the tools

    Add both webhook tools and the transfer rule in the Playground, then assign a phone number.

  4. Test with a real address

    Call the agent, describe a leak, and check that the job appears with notes.

Before you build

Plan and access

Housecall Pro offers API keys on the MAX plan only, and only admins can generate them. Check your plan before you build.

Keep the tools few

Two or three tools is enough for booking. Each extra tool is one more thing the agent can get wrong.

Enterprise-grade security

  • HIPAA compliant badge

    HIPAA compliant

  • SOC 2 Type 2 badge

    SOC 2 Type 2

  • GDPR badge

    GDPR

Housecall Pro AI voice agent FAQs

Does Housecall Pro have an AI receptionist?

Yes, CSR AI, a separate subscription. Housecall Pro's help center says it answers calls, introduces itself as AI, books jobs against technician availability, and can forward calls to a number you provide or an HCP Assist agent. A Cartesia agent is the build-your-own route, creating jobs through Housecall Pro's API from a service of yours.

Can an AI agent create jobs in Housecall Pro?

Yes. One webhook tool finds the customer by phone number, and another creates a job with the address, the problem and the requested time. Both call a service of yours that uses Housecall Pro's API, so the office starts from notes instead of a voicemail.

Does Housecall Pro API access depend on my plan?

Yes. Housecall Pro's help center says API keys are available on the MAX plan only, and only admins can generate them. The agent can't create jobs without one.

Will the AI agent quote prices to callers?

No, if your instructions say so, and this page's do. The agent books the visit and your team prices the work on site. Existing customers who ask for a person are transferred to the office line.

Does the agent need my Housecall Pro password?

No. Your service holds the Housecall Pro API credentials, and the agent only holds a bearer token for your service. Rotate that token without touching Housecall Pro if it ever leaks.

What does a Housecall Pro voice agent cost to run?

Agents run at $0.03/min, plus LLM usage and telephony. You don't need CSR AI for this setup. Transfers need a Twilio or SIP trunk number, per Cartesia's docs, so put the number on Twilio or a SIP trunk if the agent hands callers to staff.

Get started today

Talk to an expert.

Connect with a member of our team and learn how Cartesia can help you build world-class voice experiences.

Contact Sales

Start building.

Access our models via API and bring a voice agent into production in minutes.

Try Cartesia