Quick Start
Learn how to get started with the EngineRoom REST API
Get your API key
Your API requests are authenticated using an API key. Any request that doesn't include an API key will return an error.
You can request an API key by emailing [email protected]
Make your first request
To make your first request, send an authenticated request to the leads endpoint. This will create a lead
in the EngineRoom platform.
Create a new lead entry
Datetime value the lead was created at, leave blank for current timestamp
2023-01-01 10:30:00
Lead Name
John Smith
Lead Phone Number
0411 111 111
Message / Content from Form
I'm looking for a price for a car service
Google Client ID
123456789.98765433
Source of Lead E.g "google" or "direct"
google
Campaign Attribution
Location Based
Medium Attribution E.g "paid" or "organic"
paid
Keyword Attribution
Sydney Car Service
Name of form lead completed
Contact Us
URL of Lead Acquisition
https://www.sydcarservice.xyz/contact-us
Additional Information (JSON String)
{"make": "Nissan", "model": "X-Trail", "year": "2022"}
Request content type
application/json
POST /public/leads HTTP/1.1
Host: api2.engineroom.com.au
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: application/json
{
"message": "Lead created successfully.",
"data": {
"id": "b0a00e1a-7748-4c68-acd1-36bc74ec0b7b",
"type": "form",
"google_client_id": 123456789.98765433,
"lead_date": "2023-01-30T03:21:49.005548Z",
"name": "John Smith",
"email": "[email protected]",
"phone": "0411 111 111",
"message": "I'm looking for a price for a car service",
"web_source": "google",
"web_campaign": "Location Based",
"web_medium": "paid",
"web_keyword": "Sydney Car Service",
"url": "https://www.sydcarservice.xyz/contact-us",
"data": {
"make": "Nissan",
"model": "X-Trail",
"year": "2022"
},
"link": "https://app.engineroom.com.au/leads/b0a00e1a-7748-4c68-acd1-36bc74ec0b7b&business=cb50eb42-22b3-4df4-bbcd-efcd9694f3f8\"",
"business": {
"id": "cb50eb42-22b3-4df4-bbcd-efcd9694f3f8",
"name": "XYZ Car Servicing"
}
}
}
Last updated