Getting Started is Easy!

Nothing could be simpler than setting
up your New Home Feed account.

Create a Free Account

Simple, Intuitive, Affordable.
See Our Pricing Now!

New Home Feed API

Methods

Accounts

Batch

Divisions

Test

accounts.register

Register a new builder sub-account. This account will have its own login and password, but you will be able to see it in your account as well.

Authentication

Caller must be registered with New Home Feed as an Agency or CRM Provider.

Arguments

api_key (Required)
Your API application key.
number (Required)
Unique identifier for this builder. This can be the unique ID that you use in your product.
company (Required)
User's company, as shown to consumers.
name_reporting (Optional)
The company name as used in reports (not consumer facing).
email (Required)
User's login email address
password (Required)
User's login password
leads_email (Required)
Default email used for leads. Can be overridden on the community/sales office level.
logo_url (Optional)
Link to the builder's logo image. Must begin with 'http://'.
name_first (Required)
First name of the main user for this account.
name_last (Required)
Last name of the main user for this account.
address (Optional)
Contact address for the new builder.
address_2 (Optional)
Contact address line 2 for the new builder.
city (Optional)
Contact city.
state (Optional)
Contact state.
zip (Optional)
Contact zip/postal code.
phone (Optional)
Contact phone number for this builder. Not consumer facing.
website (Required)
URL for builder's website. Must begin with 'http://'.

Sample Request

http://api.newhomefeed.com/v1/accounts/register?api_key=your_api_key&number=12345&company=Acme%20Builders&name_reporting=ACME%20BUILDERS%20NORTH&email=nhf@acme.com&password=secure_password&leads_email=leads@acme.com&logo_url=http://acme.com/logo.gif&name_first=John&name_last=Doe&address=123%20Main%20St.&address_2=Suite%20101&city=Pleasantville&state=CA&zip=94309&phone=408-555-1212&website=http://acme.com

Sample Response

This method returns the New Home Feed builder ID of the new account, which can be used in subsequent calls to reference this builder.

<builder_id>123</builder_id>

Error Codes

See here for a complete list of error codes.