Leads

Use the REST API to interact with Leads

List leads

Retrieve leads

Retrieve a list of leads

get

/leads

Authorizations

Header parameters

Acceptstringrequired

Setting to application/json is recommended

Example: application/json

Responses

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://api2.engineroom.com.au/public/leads' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --header 'Accept: application/json'

200

401

200

[
  {
    "id": "751dd3d0-23ae-4a4a-9049-6982423da87a",
    "type": "form",
    "google_client_id": 123456789.98765433,
    "lead_date": "2023-01-01 10:30:00",
    "name": "John Smith",
    "email": "[e-mail]",
    "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",
    "quality_score": 6.5,
    "engagement_score": 8,
    "form_name": "Contact Us",
    "url": "https://www.sydcarservice.xyz/contact-us",
    "link": "https://app.engineroom.com.au/leads/751dd3d0-23ae-4a4a-9049-6982423da87a&business=46580dbc-da00-4316-9a2d-c04a133741aa",
    "data": {
      "make": "Nissan",
      "year": 2022,
      "model": "X-Trail"
    },
    "business": {
      "id": "46580dbc-da00-4316-9a2d-c04a133741aa",
      "name": "XYZ Car Servicing"
    }
  }
]

Success

Creating a new lead

Create a new lead

Create a new lead entry

post

/leads

Authorizations

body

lead_datastring

Datetime value the lead was created at, leave blank for current timestamp

Example: 2023-01-01 10:30:00

namestring

Lead Name

Example: John Smith

emailstring

Lead Email Address

Example: [e-mail]

phonestring

Lead Phone Number

Example: 0411 111 111

messagestring

Message / Content from Form

Example: I'm looking for a price for a car service

google_client_idstring

Google Client ID

Example: 123456789.98765433

web_sourcestring

Source of Lead E.g "google" or "direct"

Example: google

web_campaignstring

Campaign Attribution

Example: Location Based

web_mediumstring

Medium Attribution E.g "paid" or "organic"

Example: paid

web_keywordstring

Keyword Attribution

Example: Sydney Car Service

form_namestring

Name of form lead completed

Example: Contact Us

urlstring

URL of Lead Acquisition

Example: https://www.sydcarservice.xyz/contact-us

datastring

Additional Information (JSON String)

Example: {"make": "Nissan", "model": "X-Trail", "year": "2022"}

Header parameters

Acceptstringrequired

Request content type

Example: application/json

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://api2.engineroom.com.au/public/leads' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --header 'Accept: application/json'

201

400

201

{
  "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": "[e-mail]",
    "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",
    "link": "https://app.engineroom.com.au/leads/b0a00e1a-7748-4c68-acd1-36bc74ec0b7b&business=cb50eb42-22b3-4df4-bbcd-efcd9694f3f8\"",
    "data": {
      "make": "Nissan",
      "model": "X-Trail",
      "year": "2022"
    },
    "business": {
      "id": "cb50eb42-22b3-4df4-bbcd-efcd9694f3f8",
      "name": "XYZ Car Servicing"
    }
  }
}

Lead created successfully

Get lead

Retrieve lead

Retrieve a single lead

get

/leads/{id}

Authorizations

Path parameters

idstringrequired

Lead ID

Example: 751dd3d0-23ae-4a4a-9049-6982423da87a

Header parameters

Acceptstringrequired

Setting to application/json is recommended

Example: application/json

Responses

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://api2.engineroom.com.au/public/leads/{id}' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --header 'Accept: application/json'

200

401

200

{
  "id": "751dd3d0-23ae-4a4a-9049-6982423da87a",
  "type": "form",
  "google_client_id": 123456789.98765433,
  "lead_date": "2023-01-01 10:30:00",
  "name": "John Smith",
  "email": "[e-mail]",
  "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",
  "quality_score": 6.5,
  "engagement_score": 8,
  "form_name": "Contact Us",
  "url": "https://www.sydcarservice.xyz/contact-us",
  "link": "https://app.engineroom.com.au/leads/751dd3d0-23ae-4a4a-9049-6982423da87a&business=46580dbc-da00-4316-9a2d-c04a133741aa",
  "data": {
    "make": "Nissan",
    "year": 2022,
    "model": "X-Trail"
  },
  "business": {
    "id": "46580dbc-da00-4316-9a2d-c04a133741aa",
    "name": "XYZ Car Servicing"
  }
}

Success