Actions18
- Favorites Actions
- Groups Actions
- History Events Actions
- Leads Actions
- Saved Searches Actions
Overview
This node integrates with the Omaha Homes For Sale CRM API to manage real estate leads and related entities. Specifically, the "New Lead" operation under the "Leads" resource allows users to create a new lead record in the system by providing essential contact information and optional additional details.
Common scenarios where this node is beneficial include:
- Automatically adding new prospective buyer or seller leads collected from web forms into the CRM.
- Integrating lead data from other marketing platforms or databases into the Omaha Homes For Sale system.
- Enriching lead records with detailed contact preferences and demographic information for better follow-up.
For example, a real estate agent could use this node to add a new lead with their email, first name, last name, phone number, and preferred contact method immediately after a website inquiry form submission.
Properties
| Name | Meaning |
|---|---|
| The e-mail address of the lead (required). | |
| First Name | The lead's first name (required). |
| Last Name | The lead's last name (required). |
| Additional Fields | Optional extra information about the lead. These fields include: - Alternative email - Agent Id (assigns lead to specific agent; 1 for Super Admin; omit for auto-assign) - Password (for IDX login) - Address, City, State, Zip Code - Phone numbers (primary, secondary, work, fax) - Contact Method (email, phone, text) - Heat (hot, mediumhot, warm, lukewarm, cold) - Comments (e.g., message from form submission) - Origin (referrer domain) - Keywords (search engine keywords) - Marketing Option (in, out) - Searches Option (in, out) - Text Messages Option (in, out) - Groups (comma-separated group IDs) - Auto Rotate (true, false) - Source User Id (external system identifier) - Number of visits (integer) |
Output
The node outputs an array of JSON objects representing the response from the Omaha Homes For Sale API for each input item processed.
For the "New Lead" operation, the output JSON contains the created lead object as returned by the API, including all submitted fields and any additional metadata provided by the service.
No binary data output is produced by this operation.
Dependencies
- Requires an API key credential for authentication with the Omaha Homes For Sale API.
- The base URL used for requests is
http://www.omahahomesforsale.com/api/crm/v1. - The node uses HTTP POST requests to create new leads.
- Proper configuration of the API key credential in n8n is necessary for successful requests.
Troubleshooting
Common issues:
- Missing required fields such as email, first name, or last name will cause the API to reject the request.
- Invalid or expired API key will result in authentication errors.
- Incorrect formatting of additional fields (e.g., groups not properly comma-separated) may cause unexpected behavior.
Error messages:
- HTTP 400 or 401 responses typically indicate bad requests or unauthorized access. The node captures these and returns error details in the output.
- If the node throws an error, ensure that the API key is valid and that all required parameters are correctly set.
- Network connectivity issues can also cause failures; verify that the endpoint is reachable.
Links and References
- Omaha Homes For Sale API documentation (not publicly linked here, but refer to your API provider's docs)
- n8n HTTP Request node documentation for understanding underlying request mechanics: https://docs.n8n.io/nodes/n8n-nodes-base.httpRequest/