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 customer 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 details of the newly created address associated with the specified customer. This typically includes all the address fields sent in the request along with any additional metadata returned by the API, such as the address ID and timestamps.
If the node supports binary data output, it would represent any file or media related to the address, but in this case, the operation deals only with JSON data representing address information.
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: The operation requires a valid customer ID. Ensure that the customer exists and the ID is correctly provided.
- Invalid Address Fields: If required address fields are missing or malformed, the API may reject the request. Verify that at least the street, city, state, zip, and country fields are properly filled.
- Authentication Errors: If the API key or token is invalid or expired, the node will fail to authenticate. Check your credential configuration.
- API Rate Limits: Frequent requests might hit rate limits imposed by Housecall Pro. Implement retries or backoff strategies if needed.
- Network Issues: Connectivity problems can cause timeouts or failures. Confirm network access to the API endpoint.
Links and References
- Housecall Pro API Documentation (for detailed API endpoints and data formats)
- n8n Documentation (for general usage of custom nodes and credentials)