Actions20
Overview
This node integrates with the Housecall Pro API to create a new customer record. It is useful in scenarios where you want to automate adding customer information into Housecall Pro from other systems or workflows, such as CRM platforms, lead capture forms, or booking systems. For example, when a new lead fills out a form on your website, this node can automatically create a corresponding customer profile in Housecall Pro, including contact details and preferences.
Properties
| Name | Meaning |
|---|---|
| Customer Details | A collection of fields describing the customer to be created. At least one of first name, last name, email, mobile number, home number, or work number must be provided. The fields include: First Name, Last Name, Email, Company, Notifications Enabled (whether the customer receives notifications), Mobile Number, Home Number, Work Number, Lead Source, and Notes. |
Output
The node outputs JSON data representing the newly created customer object as returned by the Housecall Pro API. This typically includes the customer's unique ID, contact details, company info, notification settings, and any additional metadata provided by the API response.
No binary data output is involved.
Dependencies
- Requires an active connection to the Housecall Pro API.
- Requires an API authentication token credential configured in n8n for accessing Housecall Pro.
- The base URL used for requests is
https://api.housecallpro.com. - The node sends JSON-formatted requests and expects JSON responses.
Troubleshooting
- Missing Required Fields: The API requires at least one of the following fields to create a customer: first name, last name, email, mobile number, home number, or work number. Omitting all these will likely cause an error.
- Authentication Errors: If the API key or token is invalid or missing, the node will fail to authenticate. Ensure the API credentials are correctly set up in n8n.
- API Rate Limits: Frequent calls may hit rate limits imposed by Housecall Pro. Monitor API usage and handle errors accordingly.
- Invalid Field Values: Providing improperly formatted emails or phone numbers might cause validation errors from the API.
- Network Issues: Connectivity problems between n8n and the Housecall Pro API endpoint can cause request failures.
Links and References
- Housecall Pro API Documentation (for detailed API endpoints and data formats)
- n8n Documentation (for general guidance on using and configuring nodes and credentials)