Housecall Pro

Interact with the Housecall Pro API

Actions20

Overview

This node operation allows you to create a new address for an existing customer in the Housecall Pro system. It is useful when you need to add or update customer contact locations, such as billing or service addresses. For example, if a customer moves or has multiple service locations, this operation lets you record those addresses linked to their profile.

Properties

Name Meaning
Customer ID The unique identifier of the customer for whom the address will be created.
Address Details A collection of fields describing the address to create:
- Street: Primary street address line.
- Street Line 2: Secondary street address line (optional).
- City: City name.
- State: State or region.
- Zip: Postal or ZIP code.
- Country: Country name (default is "USA").

Output

The output JSON contains the response from the Housecall Pro API after creating the address. This typically includes the newly created address details such as its unique ID and all submitted address fields confirming successful creation. The node does not output binary data.

Dependencies

  • Requires an active connection to the Housecall Pro API.
  • Needs an API authentication token configured in n8n credentials to authorize requests.
  • The base URL for API requests is https://api.housecallpro.com.

Troubleshooting

  • Missing Customer ID: Ensure the Customer ID is provided; otherwise, the API call will fail.
  • Invalid Address Fields: Verify that address fields conform to expected formats (e.g., valid postal codes).
  • Authentication Errors: Check that the API key credential is correctly set up and has sufficient permissions.
  • API Rate Limits: If many requests are made rapidly, the API may throttle calls; implement retries or delays.
  • Error Responses: The node will throw errors if the API returns failure responses; inspect error messages for details like invalid parameters or unauthorized access.

Links and References

Discussion