LeadGo provides a JSON API for lead submissions
Using the API: LeadGo Provides a JSON API for use in submitting leads.
Headers:
Be sure that all of your requests include the following HTTP header:
Accept: application/json
Content-Type: application/json
Request:
Type: POST
URL: https://app.leadgo.io/api/feed/{{your-token}}
{your-token}: The 20-character, alphanumeric “token” of your Data Feed.
Body Structure: {"firstname": "Name", etc...}
Body Parameters: (see “Posting Parameters” below)
Response:
All responses will be in JSON format. All leads are assigned a unique “appnumber” in our system, but you are free to include your own.
If you are receiving an HTML formatted response, please be sure that you are including the “Accept” HTTP header mentioned above in the Request specifications.
Status Codes
200 = Success (see JSON below)
422 = Validation Error (see JSON below)
Example Success Response (200) :
{
"data": {
"appnumber": "AAU0036683",
"customleadid": "MYCUSTOMLEADID",(or null)
"listcode": null,
"subid": null,
"firstname": "Joe",
"lastname": "Example",
"address1": null,
"address2": null,
"city": null,
"state": null,
"zip": null,
"phone": "1231231212",
"email": "joe@example.com",
"promoCode": "MYPROMO",
"year": “2018”,
"make":”Ford”,
"model": “Mustang,
"vin": null,
"mileage": 40152,
"lenderName": null,
"squareFootage": null,
"homeValue": null,
"mortgagePayment": null,
"ipAddress": null,
"createdAt": "2020-08-25T11:22:32.000000Z"
}
}
Example Validation Error Response (422):
{
"message": "The given data was invalid.",
"errors": {
"firstname": [
"The firstname field is required."
],
"phone": [
"The phone field is required."
]
}
}
Name | Required | Details |
---|---|---|
customleadid | n | If provided, this ID will be assigned to your lead in our system |
listcode | n | alpha numeric |
subid subid2 |
n n | we have two parameters for any id values you need to pass. This can be used for vendor source id's, publisher id etc. |
firstname | y | alpha numeric |
lastname | y | alpha numeric |
phone | n | 10-digit format, ex: 5551112323 |
address1 | n | Primary street address |
address2 | n | Apt/Suite # |
city | n | alpha numeric |
state | n | Two-letter format |
zip | n | 5-digit format |
n | A valid email address | |
ipAddress | n | IPv4 format |
year | n | Vehicle Year |
make | n | Vehicle Make |
model | n | Vehicle Model |
vin | n | Vehicle VIN |
mileage | n | Auto mileage (no commas) |
cost | n | In dollars & cents. Ex: 1.23 |
lenderName | n | alpha numeric |
SquarFootage | n | Numeric |
homeValue | n | Numeric |
mortgagePayment | n | Numeric |
mortgagePayment | n | Numeric |