createNewLead
Create a new lead
https://app.lifeinsurancedirect.com.au/ExternalAPI/rest/LifeAPI/CreateNewLead/CreateNewLeadParameters
URL Query Parameters
| Name | Additional Information | Life Insurance | TPD Insurance | Trauma Insurance | Income Protection | Accident Insurance | Accidental Death Insurance |
|---|---|---|---|---|---|---|---|
| token* |
Will be provided by LID
|
*Required
|
*Required
|
*Required
|
*Required
|
*Required
|
*Required
|
| first_name* |
*First Name
|
*Required
|
*Required
|
*Required
|
*Required
|
*Required
|
*Required
|
| last_name* |
*Last Name
|
*Required
|
*Required
|
*Required
|
*Required
|
*Required
|
*Required
|
| smoking* |
Accept values: Yes and No
|
*Required
|
*Required
|
*Required
|
*Required
|
*Required
|
*Required
|
| state* |
Accept Format: NSW, ACT, VIC, QLD, NT, TAS, WA, SA
|
*Required
|
*Required
|
*Required
|
*Required
|
*Required
|
*Required
|
| gender* |
Accept values: Male, Female
|
*Required
|
*Required
|
*Required
|
*Required
|
*Required
|
*Required
|
| email* |
Email format required
|
*Required
|
*Required
|
*Required
|
*Required
|
*Required
|
*Required
|
| dob* |
Accept format: dd/mm/yyyy
|
*Required
|
*Required
|
*Required
|
*Required
|
*Required
|
*Required
|
| age* |
Only numbers allowed
|
*Required
|
*Required
|
*Required
|
*Required
|
*Required
|
*Required
|
| mobile* |
Australian phone number format required. i.e. 0489282888, 0291234567
|
*Required
|
*Required
|
*Required
|
*Required
|
*Required
|
*Required
|
| quote_type* |
Accept values: Life Insurance, Income Protection, Trauma Insurance, TPD Insurance, Keyman Insurance
|
*Required
|
*Required
|
*Required
|
*Required
|
*Required
|
*Required
|
| other_number |
Other phone number
|
Not required
|
Not required
|
Not required
|
Not required
|
Not required
|
Not required
|
| contact_date_time |
Date time format i.e. 8/02/2018 1:31 PM
|
Not required
|
Not required
|
Not required
|
Not required
|
Not required
|
Not required
|
| occupation (/GetOccupationList) |
GetOccupationList
If blank, defaults to "adminclerk" |
Not required
|
*Required
|
Not required
|
*Required
|
*Required
|
Not required
|
| life_sum |
Required for Life Insurance
|
*Required
|
Not required
|
Not required
|
Not required
|
Not required
|
*Required
|
| tpd_sum |
Required for TPD Insurance
|
Not required
|
*Required
|
Not required
|
Not required
|
No value allowed
|
No value allowed
|
| tpd_definition |
tpd_definition is required if tpd_sum is not null, if no value specified, it will be set to default "Any". Accept Values: "Any" or "Own" |
Not required
|
*Required
|
Not required
|
Not required
|
Not required
|
Not required
|
| trauma_sum |
Required for Trauma Insurance
|
Not required
|
Not required
|
*Required
|
Not required
|
No value allowed
|
No value allowed
|
| annual_income |
Required for Income Protection
|
Not required
|
Not required
|
Not required
|
*Required
|
*Required
|
Not required
|
| ip* |
*IP Address
|
*Required
|
*Required
|
*Required
|
*Required
|
*Required
|
*Required
|
| website |
Website URL
|
Not required
|
Not required
|
Not required
|
Not required
|
Not required
|
Not required
|
| partner_code |
Your internal tracking field
|
Not required
|
Not required
|
Not required
|
Not required
|
Not required
|
Not required
|
| additional_info |
Character limits: 255
|
Not required
|
Not required
|
Not required
|
Not required
|
Not required
|
Not required
|
| tracking_id* |
To be provided by LID
|
*Required
|
*Required
|
*Required
|
*Required
|
*Required
|
*Required
|
| rating* |
It is used to prevent spam leads, aka honey pot. The value must be null or empty
|
*Required
|
*Required
|
*Required
|
*Required
|
*Required
|
*Required
|
| accident_only |
It is used for Accidental Death Insurance with life_sum and quote_type = Accidental Death Insurance Is used for Accident Insurance with annual_income and quote_type = Accident Insurance Accept values "Yes" and "No" |
Not required
|
Not required
|
Not required
|
Not required
|
*Required
|
*Required
|
| origin |
Accept Values: Email, Phone and Web
|
Not required
|
Not required
|
Not required
|
Not required
|
Not required
|
Not required
|
| allow_anonymous |
It is used to generate quotes_url without the need to parse contact details(ie. First Name, Last Name, Email & Mobile). Accept Values: Yes or No |
Not required
|
Not required
|
Not required
|
Not required
|
Not required
|
Not required
|
| white_label |
By parsing the brand name (no white space), the quote tool will incorperate with the branding. *You will need to submit your logo and colors to LIDA API team. Accept Values: Strings (no space). |
Not required
|
Not required
|
Not required
|
Not required
|
Not required
|
Not required
|
Sample Responses
Status: 200 - Success Response code:
{"quotes_url":"https://app.lifeinsurancedirect.com.au/quotes/edit/b8e32e1e-2e96-44f7-8e6c-91dfa5487183?tracking_id=111&white_label=brandName","Message":"2000 Success!","has_error":"False","duplicate_lead":"True"}
Error Response codes:
1000 Unauthorised - Your API URL or Token is not currently active or its unauthorised. Please check API URL and try again.
3000 Duplicate Lead. Duplicate lead (validation from Salesforce).
3001 Lead insertion failed! Please try again later. Contact info@lifeinsurancedirect.com.au if the problem persists. Possible communication error.
3002 First Name is required.
3003 Last Name is required.
3004 Email is required.
3005 State is required.
3006 Either invalid mobile or invalid phone number input.
3007 Tracking ID required.
3008 Quote Type required.
3009 Invalid Gender.