Lead API

Lead API Edges

/list
/upsert
/delete

Authentication

Every call to the Rainmaker API must contain a POST header value of USER and TOKEN. These parameters are available inside your account on the User tab. For example, a call to the /list edge requires the user and token to be part of the header:

POST /api/1v2/list HTTP/1.1
Host: www.erainmaker.com
user: ahJkZXZ-ZXJhaW5tYWtlcjEwMTByEQsSBFVzZXIYgICAgICAgAoM
token: 5629499534213120
Content-Type: application/x-www-form-urlencoded
Cache-Control: no-cache


/api/1v2/list

The /list edge returns a list of leads in your account. The default length is 1000 records. You can check for additional records using an offset parameter. For example:

POST /api/1v2/list HTTP/1.1
Host: www.erainmaker.com
user: ahJkZXZ-ZXJhaW5tYWtlcjEwMTByEQsSBFVzZXIYgICAgICAgAoM
token: 5629499534213120
Content-Type: application/x-www-form-urlencoded
Cache-Control: no-cache

{"length": 200,
"offset":600}


/api/1v2/upsert

The /upsert edge provides the ability to insert or update a lead. To insert a lead, set the 'action' to 'insert'. To udpate an existing lead you must provide the correct 'key' value as well as the action 'update'. Regardless of the 'action' command, if a 'key' is present, we will look for that key and update the correct entity. For example:

POST /api/1v2/list HTTP/1.1
Host: www.erainmaker.com
user: ahJkZXZ-ZXJhaW5tYWtlcjEwMTByEQsSBFVzZXIYgICAgICAgAoM
token: 5629499534213120
Content-Type: application/x-www-form-urlencoded
Cache-Control: no-cache

{"key": "ahJkZXZ-ZXJhaW5tYWtlcjEwMTByKgsSBExlYWQiIDUyM2I2NzY2OTU3ZTQ1ZWI5NDllYjA3MGE2ZjhhZTE0DA",
"action":"insert",
"props": {
"name_first": "Kevin",
"name_last": "Hoffman",
"points":50,
"score":69.6
}
}

Property
Type
Description
name_first
string
First name of the lead
name_last
string
Last name of the lead
name_full
string
Full name of the lead
company_name
string
Company name of the lead
email
string
Email address of the lead
phone
string
Phone number of the lead
city
string
City of the lead
state
string
State of the lead
postal_code
string
Postal or Zip Code of the lead
points
integer
Point Value of the lead, must be whole number integer
score
float
Assinged lead score, can be a floating point number


/api/1v2/delete

The /delete edge allows you to delete a lead. You must provide the entity 'key' value.

POST /api/1v2/delete HTTP/1.1
Host: www.erainmaker.com
user: ahJkZXZ-ZXJhaW5tYWtlcjEwMTByEQsSBFVzZXIYgICAgICAgAoM
token: 5629499534213120
Content-Type: application/x-www-form-urlencoded
Cache-Control: no-cache

{"key": "ahJkZXZ-ZXJhaW5tYWtlcjEwMTByKgsSBExlYWQiIDUyM2I2NzY2OTU3ZTQ1ZWI5NDllYjA3MGE2ZjhhZTE0DA"}


Create Free Account
No credit card required

First Name
required
Last Name
required
Mobile Phone Number. You MUST enter a valid mobile number. It will be used later to activate your account.
required
E-mail Address
required
Password
required

Set-it-and-Forget-it Marketing

Fresh content consistently delivered every month featuring YOU as the market leader.



Free eBook: Social Media 101 for Real Estate Pros

Learn how to make social media work for you in this eBook: Social Media 101 for Real Estate Pros

You will learn:
  • How to overcome fears of creating a social presence.
  • What, when and how often to post.
  • Simple ways to differentiate yourself on social media.
  • What social networks to focus on for the biggest impact.

  • If you aren’t posting content in social media outlets, you will get zero leads and zero closed sales from this interactive community.
    required
    required
    required