> ## Documentation Index
> Fetch the complete documentation index at: https://ampersand-24eb5c1a-rajatspawar-eng-4200-readd-blob-storage.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Housecall Pro

## Checklist before you start

Confirm the following:

* You are a Housecall Pro **Admin** user.
* Your Housecall Pro account has a **MAX subscription**.

## 1. Generate your Housecall Pro API key

Follow these steps to generate your Housecall Pro API key.

1. Click the **My Apps** icon (3x3 grid) in the top-right corner.
   <img src="https://mintcdn.com/ampersand-24eb5c1a-rajatspawar-eng-4200-readd-blob-storage/KYfs0Jr6nPSoJsI_/images/customer-guides/housecallPro/myapps.png?fit=max&auto=format&n=KYfs0Jr6nPSoJsI_&q=85&s=4223b4dbf6a7ed2c1c9e147f27aaa228" width="1907" height="1017" data-path="images/customer-guides/housecallPro/myapps.png" />
2. Click **Go to App Store**.
   <img src="https://mintcdn.com/ampersand-24eb5c1a-rajatspawar-eng-4200-readd-blob-storage/KYfs0Jr6nPSoJsI_/images/customer-guides/housecallPro/appstore.png?fit=max&auto=format&n=KYfs0Jr6nPSoJsI_&q=85&s=be4eac8b7218219b02bdc8cf277b49d2" width="2120" height="1129" data-path="images/customer-guides/housecallPro/appstore.png" />
3. Under **My Apps**, find and open the **API Key Management** app card.
   <img src="https://mintcdn.com/ampersand-24eb5c1a-rajatspawar-eng-4200-readd-blob-storage/KYfs0Jr6nPSoJsI_/images/customer-guides/housecallPro/apikey.png?fit=max&auto=format&n=KYfs0Jr6nPSoJsI_&q=85&s=68ccb4c726d9d57a7230fc300987f2b7" width="1720" height="898" data-path="images/customer-guides/housecallPro/apikey.png" />
4. Click **Generate API Key**.
   <img src="https://mintcdn.com/ampersand-24eb5c1a-rajatspawar-eng-4200-readd-blob-storage/KYfs0Jr6nPSoJsI_/images/customer-guides/housecallPro/generate.png?fit=max&auto=format&n=KYfs0Jr6nPSoJsI_&q=85&s=0877fb835ce7cdd9dfa48a861b882b21" width="1364" height="712" data-path="images/customer-guides/housecallPro/generate.png" />
5. Enter a descriptive name for the key.
   <img src="https://mintcdn.com/ampersand-24eb5c1a-rajatspawar-eng-4200-readd-blob-storage/KYfs0Jr6nPSoJsI_/images/customer-guides/housecallPro/new.png?fit=max&auto=format&n=KYfs0Jr6nPSoJsI_&q=85&s=7999d706bc11b84033eedd62d12fcece" width="841" height="388" data-path="images/customer-guides/housecallPro/new.png" />
6. Copy the API key and store it securely.
   <img src="https://mintcdn.com/ampersand-24eb5c1a-rajatspawar-eng-4200-readd-blob-storage/KYfs0Jr6nPSoJsI_/images/customer-guides/housecallPro/copy.png?fit=max&auto=format&n=KYfs0Jr6nPSoJsI_&q=85&s=a36bfa01ad8e52b996445104c1af4f4b" width="841" height="388" data-path="images/customer-guides/housecallPro/copy.png" />

## 2. Set up webhooks for real-time updates (Subscribe Actions)

Skip this section if your developer did not give you a webhook URL, or if you do not need real-time updates.

Follow these steps to set up webhooks in Housecall Pro.

1. Click the **My Apps** icon (3x3 grid) in the top-right corner.
   <img src="https://mintcdn.com/ampersand-24eb5c1a-rajatspawar-eng-4200-readd-blob-storage/KYfs0Jr6nPSoJsI_/images/customer-guides/housecallPro/myapps.png?fit=max&auto=format&n=KYfs0Jr6nPSoJsI_&q=85&s=4223b4dbf6a7ed2c1c9e147f27aaa228" width="1907" height="1017" data-path="images/customer-guides/housecallPro/myapps.png" />
2. Click **Go to App Store**.
   <img src="https://mintcdn.com/ampersand-24eb5c1a-rajatspawar-eng-4200-readd-blob-storage/KYfs0Jr6nPSoJsI_/images/customer-guides/housecallPro/appstore.png?fit=max&auto=format&n=KYfs0Jr6nPSoJsI_&q=85&s=be4eac8b7218219b02bdc8cf277b49d2" width="2120" height="1129" data-path="images/customer-guides/housecallPro/appstore.png" />
3. Under **All apps**, find and open **Webhooks**.
   <img src="https://mintcdn.com/ampersand-24eb5c1a-rajatspawar-eng-4200-readd-blob-storage/KYfs0Jr6nPSoJsI_/images/customer-guides/housecallPro/webhook.png?fit=max&auto=format&n=KYfs0Jr6nPSoJsI_&q=85&s=3ea7afaf9aa11b0674807769f0f0db7b" width="2133" height="1136" data-path="images/customer-guides/housecallPro/webhook.png" />
4. Set Webhooks to **Active**, paste the link the developer gave you into the **Webhook URL** field, then click **Save**.
   <img src="https://mintcdn.com/ampersand-24eb5c1a-rajatspawar-eng-4200-readd-blob-storage/KYfs0Jr6nPSoJsI_/images/customer-guides/housecallPro/active.png?fit=max&auto=format&n=KYfs0Jr6nPSoJsI_&q=85&s=9df8b96ab655a55bf2c405421e3a15d5" width="2123" height="1133" data-path="images/customer-guides/housecallPro/active.png" />
5. Enable the webhook events that you want to subscribe to, then click **Save**.
   <img src="https://mintcdn.com/ampersand-24eb5c1a-rajatspawar-eng-4200-readd-blob-storage/KYfs0Jr6nPSoJsI_/images/customer-guides/housecallPro/events.png?fit=max&auto=format&n=KYfs0Jr6nPSoJsI_&q=85&s=32b7af95b324581e6337e1bbb251e67e" width="2127" height="1130" data-path="images/customer-guides/housecallPro/events.png" />
   <Note>
     **`pro.created`** in Housecall Pro means a new **employee**; the connected
     product may display it as **`employee.created`**.
   </Note>

## For official setup details, see:

* [Housecall Pro API Overview](https://help.housecallpro.com/en/articles/8505035-api-overview#h_3b0cd3e648)
* [Housecall Pro Webhooks Setup](https://help.housecallpro.com/en/articles/5683520-how-to-enable-webhooks)
