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 "Favorites" associated with leads. Specifically, the New Favorite operation allows users to create a new favorite listing for a lead by associating a property (identified by MLS number and other details) with the lead's email address.
Common scenarios where this node is beneficial include:
- Real estate agents or brokers wanting to programmatically add favorite property listings to a lead’s profile in their CRM.
- Automating workflows where leads express interest in specific properties, and those favorites need to be tracked centrally.
- Syncing external lead management systems or forms with the Omaha Homes For Sale CRM to keep favorites updated.
Practical example: When a lead submits a form indicating interest in a particular home, this node can be used to add that home as a favorite to the lead’s record automatically.
Properties
| Name | Meaning |
|---|---|
| The e-mail address of the lead to whom the favorite listing will be associated. | |
| MLS number | The listing's MLS (Multiple Listing Service) number within the IDX feed identifying the property. |
| Type | The property type of the listing within the IDX feed (e.g., residential, commercial). |
| Feed | The IDX feed identifier representing the source feed of the listing. |
| Source | The table name within the IDX database where the listing resides. |
Output
The output JSON contains a single field response which holds the API response from creating the new favorite. This typically includes confirmation details about the newly created favorite record.
Example output structure:
{
"response": {
"id": "string",
"mls_number": "string",
"type": "string",
"feed": "string",
"source": "string",
"created_at": "string",
...
}
}
No binary data output is produced by this operation.
Dependencies
- Requires an API key credential for authenticating requests to the Omaha Homes For Sale CRM API.
- The base URL for API requests is
http://www.omahahomesforsale.com/api/crm/v1. - The node uses HTTP POST requests to the endpoint
/leads/{email}/favoritesto create a new favorite. - Proper configuration of the API key credential in n8n is necessary for successful authentication.
Troubleshooting
Common issues:
- Invalid or missing API key credential will cause authentication failures.
- Incorrect or missing required parameters (
email,mlsNumber,type,feed,source) will result in request errors. - Network connectivity issues may prevent reaching the API endpoint.
Error messages:
- HTTP 400 Bad Request: Usually indicates missing or invalid input parameters. Verify all required fields are correctly set.
- HTTP 401 Unauthorized: Indicates authentication failure due to invalid or missing API key.
- Other errors will include error messages returned by the API; these should be reviewed to adjust inputs accordingly.
Resolution tips:
- Ensure the API key credential is valid and properly configured.
- Double-check all required input fields for correctness and completeness.
- Review API documentation for any constraints on field values.
- Enable "Continue On Fail" in the node settings if you want the workflow to proceed despite individual errors.
Links and References
Omaha Homes For Sale CRM API Documentation (general reference):
http://www.omahahomesforsale.com/api/crm/v1 (base URL)n8n HTTP Request Node Documentation (for understanding underlying HTTP calls):
https://docs.n8n.io/nodes/n8n-nodes-base.httpRequest/IDX (Internet Data Exchange) MLS Listings Overview:
https://en.wikipedia.org/wiki/Internet_Data_Exchange_(real_estate)
If you need further details on other operations or resources, feel free to ask!