OmahaHomesForSale icon

OmahaHomesForSale

Omaha Homes For Sale custom node
Join our community

Actions18

Overview

The "Create or Update a Lead" operation in the OmahaHomesForSale node allows users to either create a new lead record or update an existing one in the Lead Management system. This operation is useful for managing real estate leads by ensuring that lead information is current and accurate without creating duplicate entries.

Common scenarios include:

  • Adding new potential buyers or sellers to the CRM.
  • Updating contact details or preferences of existing leads based on new information.
  • Synchronizing lead data from external sources or forms into the CRM.

Practical example:

  • When a user submits a contact form on a real estate website, this node can be used to create a new lead with their name and email or update their existing record if they have contacted before.

Properties

Name Meaning
Email 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 fields to provide more detailed lead information such as:
- Alternative email
- Agent Id (to assign the lead)
- Password (for IDX login)
- Address, City, State, Zip Code
- Phone numbers (primary, secondary, work, fax)
- Contact Method (email, phone, text)
- Heat level (hot, mediumhot, warm, lukewarm, cold)
- Comments or messages
- Origin (referrer domain)
- Keywords (search engine keywords)
- Marketing options (in, out)
- Groups (comma-separated group IDs)
- Auto Rotate (true/false)
- Source User Id (external system ID)
- Number of visits

Output

The node outputs a JSON array where each element corresponds to the response from the API for each input item processed. The JSON structure typically contains the created or updated lead object returned by the API.

Example output JSON snippet:

[
  {
    "id": 123,
    "first_name": "John",
    "last_name": "Doe",
    "email": "john.doe@example.com",
    "agent_id": 5,
    "phone": "555-1234",
    ...
  }
]

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 node makes HTTP requests to the base URL http://www.omahahomesforsale.com/api/crm/v1.
  • Proper configuration of the API key credential in n8n is necessary.

Troubleshooting

  • Common issues:

    • Invalid or missing API key will cause authentication errors.
    • Providing incomplete required fields (e.g., missing email, first name, or last name) will result in validation errors.
    • Network connectivity issues may prevent successful API calls.

  • Error messages:

    • HTTP 400 or 401 responses usually indicate bad requests or unauthorized access. The error message from the API will be included in the output.
    • If the node encounters an error but "Continue On Fail" is enabled, it will return the error message in the output instead of stopping execution.

  • Resolution tips:

    • Verify the API key is correctly set and has proper permissions.
    • Ensure all required fields are provided and valid.
    • Check network connectivity and endpoint availability.

Links and References

  • Omaha Homes For Sale API documentation (not provided here; consult your API provider for official docs).
  • n8n documentation on HTTP Request node and credential setup for API integrations.

Discussion