Elead Product Reference Data (Preview)

This API provides data to be used in conjunction with other eLeads APIs as needed. API searches, retrieves and provides the following details - Opportunity sources and sub sources for a specified company and up types, opportunity statuses for a specified company, sales steps for a specified company, employee positions for a specified company, employees by company and position, sender email addresses for a specified company, available vehicle class, year, make, model, trim.

This connector is available in the following products and regions:

Service	Class	Regions
Logic Apps	Standard	All Logic Apps regions except the following:      -   Azure Government regions      -   Azure China regions      -   US Department of Defense (DoD)
Power Automate	Premium	All Power Automate regions except the following:      -   US Government (GCC)      -   US Government (GCC High)      -   China Cloud operated by 21Vianet      -   US Department of Defense (DoD)
Power Apps	Premium	All Power Apps regions except the following:      -   US Government (GCC)      -   US Government (GCC High)      -   China Cloud operated by 21Vianet      -   US Department of Defense (DoD)

Contact
Name	CDK Global
URL	https://serviceconnect.support.cdk.com
Email	mbd_support@cdk.com

Connector Metadata
Publisher	CDK Global
Website	https://fortellis.io
Privacy policy	https://fortellis.io/privacy
Categories	Data

What does this API do?

This helper API provides data to be used in conjunction with other APIs as needed.

Intended Audience

This API is for dealers and vendor partners who need to retrieve Elead product reference data to support other APIs.

Capabilities and Features

This API searches, retrieves and provides the following details to support interaction with other APIs.

• Opportunity sources for a specified company and up types
• Opportunity subsources for a specified source and up types
• Opportunity statuses for a specified company
• Sales steps for a specified company
• Employee positions for a specified company
• Employees by company and position
• Sender email addresses for a specified company
• Available vehicle class types
• Available vehicle year
• Available vehicle makes by year and vehicle class (optional)
• Available vehicle models by year and make
• Available vehicle trims by year, make and model

Pre-requisites

You will need the following to proceed

• To use the connector, you need to be a Fortellis user
• You need to create a solution in Fortellis to generate client id and secret to be used while calling the APIs

Detailed Documentation can be found at

https://apidocs.fortellis.io/specs/8bbbe60f-b382-4315-8d19-ba48a64b2ab3

Throttling Limits

Name	Calls	Renewal Period
API calls per connection	100	60 seconds

Actions

Gets the "from" email addresses for the specified company	Gets the "from" email addresses for the specified company
Gets the available vehicle class types	Gets the available vehicle class types
Gets the available vehicle makes by year and vehicle class (optional)	Gets the available vehicle makes by year and vehicle class (optional)
Gets the available vehicle models by year and make	Gets the available vehicle models by year and make
Gets the available vehicle trims by year, make, and model	Gets the available vehicle trims by year, make, and model
Gets the available vehicle years	Gets the available vehicle years
Gets the employees for the specified company and position	Gets the employees for the specified company and position
Gets the opportunity sources for the specified company and up types	Gets the opportunity sources for the specified company and up types
Gets the opportunity statuses for the specified company	Gets the opportunity statuses for the specified company
Gets the positions for the specified company	Gets the positions for the specified company
Gets the sales steps for the specified company	Gets the sales steps for the specified company
Retrieves the opportunity subsources for the specified source and up types	Retrieves the opportunity subsources for the specified source and up types

Gets the "from" email addresses for the specified company

Operation ID:

GetCompanyEmails

Gets the "from" email addresses for the specified company

Parameters

Name	Key	Required	Type	Description
Client Id	client_id	True	string	A client ID that should be unique to developer/solution provider building the solution.
Client Secret	client_secret	True	string	A client secret that should be unique to developer/solution provider building the solution.
Subscription Id	subscription_id	True	string	A correlation ID that should be returned back to the caller to indicate the return of the given request.
Accept	Accept		string	Accept Header
Accept-Charset	Accept-Charset		string	Accept-Charset Header
Accept-Encoding	Accept-Encoding		string	Accept-Encoding Header
Accept-Language	Accept-Language		string	Accept-Language Header
If-Match	If-Match		string	If-Match Header
If-None-Match	If-None-Match		string	If-None-Match Header
Prefer	Prefer		string	Preference of the customer
Request Id	Request-Id	True	string	Format - uuid.

Returns

Body

CompanyEmailCollection

Gets the available vehicle class types

Operation ID:

GetVehicleClasses

Gets the available vehicle class types

Parameters

Name	Key	Required	Type	Description
Client Id	client_id	True	string	A client ID that should be unique to developer/solution provider building the solution.
Client Secret	client_secret	True	string	A client secret that should be unique to developer/solution provider building the solution.
Subscription Id	subscription_id	True	string	A correlation ID that should be returned back to the caller to indicate the return of the given request.
Accept	Accept		string	Accept Header
Accept-Charset	Accept-Charset		string	Accept-Charset Header
Accept-Encoding	Accept-Encoding		string	Accept-Encoding Header
Accept-Language	Accept-Language		string	Accept-Language Header
If-Match	If-Match		string	If-Match Header
If-None-Match	If-None-Match		string	If-None-Match Header
Prefer	Prefer		string	Preference of the customer
Request Id	Request-Id	True	string	Format - uuid.

Returns

Body

VehicleClassCollection

Gets the available vehicle makes by year and vehicle class (optional)

Operation ID:

GetVehicleMakes

Gets the available vehicle makes by year and vehicle class (optional)

Parameters

Name	Key	Required	Type	Description
Year	year	True	integer	Year of Manufacturing
Class	class		string	Class of the vehicle
Client Id	client_id	True	string	A client ID that should be unique to developer/solution provider building the solution.
Client Secret	client_secret	True	string	A client secret that should be unique to developer/solution provider building the solution.
Subscription Id	subscription_id	True	string	A correlation ID that should be returned back to the caller to indicate the return of the given request.
Accept	Accept		string	Accept Header
Accept-Charset	Accept-Charset		string	Accept-Charset Header
Accept-Encoding	Accept-Encoding		string	Accept-Encoding Header
Accept-Language	Accept-Language		string	Accept-Language Header
If-Match	If-Match		string	If-Match Header
If-None-Match	If-None-Match		string	If-None-Match Header
Prefer	Prefer		string	Preference of the customer
Request Id	Request-Id	True	string	Format - uuid.

Returns

Body

VehicleMakeCollection

Gets the available vehicle models by year and make

Operation ID:

GetVehicleModels

Gets the available vehicle models by year and make

Parameters

Name	Key	Required	Type	Description
Year	year	True	integer	Year of Manufacturing
Make	make	True	string	Make of the Car
Client Id	client_id	True	string	A client ID that should be unique to developer/solution provider building the solution.
Client Secret	client_secret	True	string	A client secret that should be unique to developer/solution provider building the solution.
Subscription Id	subscription_id	True	string	A correlation ID that should be returned back to the caller to indicate the return of the given request.
Accept	Accept		string	Accept Header
Accept-Charset	Accept-Charset		string	Accept-Charset Header
Accept-Encoding	Accept-Encoding		string	Accept-Encoding Header
Accept-Language	Accept-Language		string	Accept-Language Header
If-Match	If-Match		string	If-Match Header
If-None-Match	If-None-Match		string	If-None-Match Header
Prefer	Prefer		string	Preference of the customer
Request Id	Request-Id	True	string	Format - uuid.

Returns

Body

VehicleModelCollection

Gets the available vehicle trims by year, make, and model

Operation ID:

GetVehicleTrims

Gets the available vehicle trims by year, make, and model

Parameters

Name	Key	Required	Type	Description
Year	year	True	integer	Year of Manufacturing
Make	make	True	string	Make of the Car
Model	model	True	string	Model of the Car
Client Id	client_id	True	string	A client ID that should be unique to developer/solution provider building the solution.
Client Secret	client_secret	True	string	A client secret that should be unique to developer/solution provider building the solution.
Subscription Id	subscription_id	True	string	A correlation ID that should be returned back to the caller to indicate the return of the given request.
Accept	Accept		string	Accept Header
Accept-Charset	Accept-Charset		string	Accept-Charset Header
Accept-Encoding	Accept-Encoding		string	Accept-Encoding Header
Accept-Language	Accept-Language		string	Accept-Language Header
If-Match	If-Match		string	If-Match Header
If-None-Match	If-None-Match		string	If-None-Match Header
Prefer	Prefer		string	Preference of the customer
Request Id	Request-Id	True	string	Format - uuid.

Returns

Body

VehicleTrimCollection

Gets the available vehicle years

Operation ID:

GetVehicleYears

Gets the available vehicle years

Parameters

Name	Key	Required	Type	Description
Client Id	client_id	True	string	A client ID that should be unique to developer/solution provider building the solution.
Client Secret	client_secret	True	string	A client secret that should be unique to developer/solution provider building the solution.
Subscription Id	subscription_id	True	string	A correlation ID that should be returned back to the caller to indicate the return of the given request.
Accept	Accept		string	Accept Header
Accept-Charset	Accept-Charset		string	Accept-Charset Header
Accept-Encoding	Accept-Encoding		string	Accept-Encoding Header
Accept-Language	Accept-Language		string	Accept-Language Header
If-Match	If-Match		string	If-Match Header
If-None-Match	If-None-Match		string	If-None-Match Header
Prefer	Prefer		string	Preference of the customer
Request Id	Request-Id	True	string	Format - uuid.

Returns

Body

VehicleYearCollection

Gets the employees for the specified company and position

Operation ID:

GetCompanyEmployees

Gets the employees for the specified company and position

Parameters

Name	Key	Required	Type	Description
Position Name	positionName	True	string	The position name
Client Id	client_id	True	string	A client ID that should be unique to developer/solution provider building the solution.
Client Secret	client_secret	True	string	A client secret that should be unique to developer/solution provider building the solution.
Subscription Id	subscription_id	True	string	A correlation ID that should be returned back to the caller to indicate the return of the given request.
Accept	Accept		string	Accept Header
Accept-Charset	Accept-Charset		string	Accept-Charset Header
Accept-Encoding	Accept-Encoding		string	Accept-Encoding Header
Accept-Language	Accept-Language		string	Accept-Language Header
If-Match	If-Match		string	If-Match Header
If-None-Match	If-None-Match		string	If-None-Match Header
Prefer	Prefer		string	Preference of the customer
Request Id	Request-Id	True	string	Format - uuid.

Returns

Body

CompanyEmployeeCollection

Gets the opportunity sources for the specified company and up types

Operation ID:

GetCompanyOpportunitySources

Gets the opportunity sources for the specified company and up types

Parameters

Name	Key	Required	Type	Description
Up Type	upType		string	The opportunity source up type
Client Id	client_id	True	string	A client ID that should be unique to developer/solution provider building the solution.
Client Secret	client_secret	True	string	A client secret that should be unique to developer/solution provider building the solution.
Subscription Id	subscription_id	True	string	A correlation ID that should be returned back to the caller to indicate the return of the given request.
Accept	Accept		string	Accept Header
Accept-Charset	Accept-Charset		string	Accept-Charset Header
Accept-Encoding	Accept-Encoding		string	Accept-Encoding Header
Accept-Language	Accept-Language		string	Accept-Language Header
If-Match	If-Match		string	If-Match Header
If-None-Match	If-None-Match		string	If-None-Match Header
Prefer	Prefer		string	Preference of the customer
Request Id	Request-Id	True	string	Format - uuid.

Returns

Body

CompanyOpportunitySourceCollection

Gets the opportunity statuses for the specified company

Operation ID:

GetCompanyOpportunityStatuses

Gets the opportunity statuses for the specified company

Parameters

Name	Key	Required	Type	Description
Client Id	client_id	True	string	A client ID that should be unique to developer/solution provider building the solution.
Client Secret	client_secret	True	string	A client secret that should be unique to developer/solution provider building the solution.
Subscription Id	subscription_id	True	string	A correlation ID that should be returned back to the caller to indicate the return of the given request.
Accept	Accept		string	Accept Header
Accept-Charset	Accept-Charset		string	Accept-Charset Header
Accept-Encoding	Accept-Encoding		string	Accept-Encoding Header
Accept-Language	Accept-Language		string	Accept-Language Header
If-Match	If-Match		string	If-Match Header
If-None-Match	If-None-Match		string	If-None-Match Header
Prefer	Prefer		string	Preference of the customer
Request Id	Request-Id	True	string	Format - guid. A correlation ID that should be returned back to the caller to indicate the return of the given request

Returns

Body

CompanyOpportunityStatusCollection

Gets the positions for the specified company

Operation ID:

GetCompanyPositions

Gets the positions for the specified company

Parameters

Name	Key	Required	Type	Description
Client Id	client_id	True	string	A client ID that should be unique to developer/solution provider building the solution.
Client Secret	client_secret	True	string	A client secret that should be unique to developer/solution provider building the solution.
Subscription Id	subscription_id	True	string	A correlation ID that should be returned back to the caller to indicate the return of the given request.
Accept	Accept		string	Accept Header
Accept-Charset	Accept-Charset		string	Accept-Charset Header
Accept-Encoding	Accept-Encoding		string	Accept-Encoding Header
Accept-Language	Accept-Language		string	Accept-Language Header
If-Match	If-Match		string	If-Match Header
If-None-Match	If-None-Match		string	If-None-Match Header
Prefer	Prefer		string	Preference of the customer
Request Id	Request-Id	True	string	Format - uuid.

Returns

Body

CompanyPositionCollection

Gets the sales steps for the specified company

Operation ID:

GetCompanySalesSteps

Gets the sales steps for the specified company

Parameters

Name	Key	Required	Type	Description
Client Id	client_id	True	string	A client ID that should be unique to developer/solution provider building the solution.
Client Secret	client_secret	True	string	A client secret that should be unique to developer/solution provider building the solution.
Subscription Id	subscription_id	True	string	A correlation ID that should be returned back to the caller to indicate the return of the given request.
Accept	Accept		string	Accept Header
Accept-Charset	Accept-Charset		string	Accept-Charset Header
Accept-Encoding	Accept-Encoding		string	Accept-Encoding Header
Accept-Language	Accept-Language		string	Accept-Language Header
If-Match	If-Match		string	If-Match Header
If-None-Match	If-None-Match		string	If-None-Match Header
Prefer	Prefer		string	Preference of the customer
Request Id	Request-Id	True	string	Format - uuid.

Returns

Body

CompanySalesStepCollection

Retrieves the opportunity subsources for the specified source and up types

Operation ID:

GetOpportunitySubSources

Retrieves the opportunity subsources for the specified source and up types

Parameters

Name	Key	Required	Type	Description
Source Name	sourceName	True	string	The source name
Up Type	upType	True	string	The opportunity source up type
Client Id	client_id	True	string	A client ID that should be unique to developer/solution provider building the solution.
Client Secret	client_secret	True	string	A client secret that should be unique to developer/solution provider building the solution.
Subscription Id	subscription_id	True	string	A correlation ID that should be returned back to the caller to indicate the return of the given request.
Accept	Accept		string	Accept Header
Accept-Charset	Accept-Charset		string	Accept-Charset Header
Accept-Encoding	Accept-Encoding		string	Accept-Encoding Header
Accept-Language	Accept-Language		string	Accept-Language Header
If-Match	If-Match		string	If-Match Header
If-None-Match	If-None-Match		string	If-None-Match Header
Prefer	Prefer		string	Preference of the customer
Request Id	Request-Id	True	string	Format - uuid.

Returns

Body

OpportunitySubSourceCollection

Definitions

UpType

Opportunity Source UpType

Opportunity Source UpType

string

LinkDescriptionObject

Name	Path	Type	Description
href	href	string	The target URI
rel	rel	string	The link relation type
method	method	string	The HTTP verb that MUST be used to make a request to the target of the link
title	title	string	The title that describes the object

CompanyOpportunityStatusCollection

Name	Path	Type	Description
items	items	array of CompanyOpportunityStatus	A collection of company opportunity statuses

CompanyOpportunitySourceCollection

Name	Path	Type	Description
items	items	array of CompanyOpportunitySource	A collection of company opportunity sources
links	links	array of LinkDescriptionObject	A collection of HATEOAS links

CompanyOpportunityStatus

Name	Path	Type	Description
status	status	string	Company Opportunity Status Name
subStatuses	subStatuses	array of CompanyOpportunitySubStatus

CompanyOpportunitySubStatus

Name	Path	Type	Description
subStatus	subStatus	string	Description of the sub status

CompanyOpportunitySource

Name	Path	Type	Description
name	name	string	Company Opportunity Source Name
upType	upType	UpType	Opportunity Source UpType
isActive	isActive	boolean	true/false whether this company opportunity source is active
requestPhrase	requestPhrase	string	(Future Use) Request phrase for the specified company opportunity source
requiresSubSource	requiresSubSource	boolean	true/false whether this company opportunity source requires a Subsource
hasSubSources	hasSubSources	boolean	true/false whether this company opportunity source has subsources (path to retrieve these subsources is in the HATEOAS links collection)
links	links	array of LinkDescriptionObject	A collection of HATEOAS links

OpportunitySubSourceCollection

Name	Path	Type	Description
items	items	array of OpportunitySubSource	A collection of opportunity subsources
links	links	array of LinkDescriptionObject	A collection of HATEOAS links

OpportunitySubSource

Name	Path	Type	Description
name	name	string	Opportunity subsource name
isActive	isActive	boolean	true/false whether this opportunity subsource is active

CompanySalesStepCollection

Name	Path	Type	Description
items	items	array of CompanySalesStep	A collection of company sales steps
links	links	array of LinkDescriptionObject	A collection of HATEOAS links

CompanySalesStep

Name	Path	Type	Description
name	name	string	Sales step name
abbreviation	abbreviation	string	Abbreviation for the sales step name
isActive	isActive	boolean	true/false whether this sales step is active
sortOrder	sortOrder	integer	Intended order of the sales step if building a drop down in UI

CompanyPositionCollection

Name	Path	Type	Description
items	items	array of CompanyPosition	A collection of company positions
links	links	array of LinkDescriptionObject	A collection of HATEOAS links

CompanyPosition

Name	Path	Type	Description
name	name	string	Position name
code	code	string	Position code
hasEmployees	hasEmployees	boolean	true/false whether this company position has employees (path to retrieve these employees is in the HATEOAS links collection)
links	links	array of LinkDescriptionObject	A collection of HATEOAS links

CompanyEmployeeCollection

Name	Path	Type	Description
items	items	array of Employee	A collection of company employees
links	links	array of LinkDescriptionObject	A collection of HATEOAS links

Employee

Name	Path	Type	Description
id	id	uuid	Employee identifier
firstName	firstName	string	Employee first name
lastName	lastName	string	Employee last name
isActive	isActive	boolean	true/false whether this employee is active within the company
isOff	isOff	boolean	true/false whether this employee is currently working and can accept new internet opportunities being processed into the system
links	links	array of LinkDescriptionObject	A collection of HATEOAS links

CompanyEmailCollection

Name	Path	Type	Description
items	items	array of CompanyEmail	A collection of company "from" email addresses
links	links	array of LinkDescriptionObject	A collection of HATEOAS links

CompanyEmail

Name	Path	Type	Description
address	address	string	Email address

VehicleClassCollection

Name	Path	Type	Description
items	items	array of VehicleClass	A collection of vehicle classes
links	links	array of LinkDescriptionObject	A collection of HATEOAS links

VehicleClass

Name	Path	Type	Description
name	name	string	Vehicle class name
links	links	array of LinkDescriptionObject	A collection of HATEOAS links

VehicleYearCollection

Name	Path	Type	Description
items	items	array of VehicleYear	A collection of vehicle years
links	links	array of LinkDescriptionObject	A collection of HATEOAS links

VehicleYear

Name	Path	Type	Description
year	year	integer	Vehicle year
links	links	array of LinkDescriptionObject	A collection of HATEOAS links

VehicleMakeCollection

Name	Path	Type	Description
year	year	integer	Vehicle year for this collection of vehicle makes
items	items	array of VehicleMake	A collection of vehicle makes
links	links	array of LinkDescriptionObject	A collection of HATEOAS links

VehicleMake

Name	Path	Type	Description
name	name	string	Vehicle make name
links	links	array of LinkDescriptionObject	A collection of HATEOAS links

VehicleModelCollection

Name	Path	Type	Description
year	year	integer	Vehicle year for this collection of vehicle models
make	make	string	Vehicle make for this collection of vehicle models
items	items	array of VehicleModel	A collection of vehicle models
links	links	array of LinkDescriptionObject	A collection of HATEOAS links

VehicleModel

Name	Path	Type	Description
name	name	string	Vehicle Model Name
links	links	array of LinkDescriptionObject	A collection of HATEOAS links

VehicleTrimCollection

Name	Path	Type	Description
year	year	integer	Vehicle year for this collection of vehicle trims
make	make	string	Vehicle make for this collection of vehicle trims
model	model	string	Vehicle model for this collection of vehicle trims
items	items	array of VehicleTrim	A collection of vehicle trims
links	links	array of LinkDescriptionObject	A collection of HATEOAS links

VehicleTrim

Name	Path	Type	Description
name	name	string	Vehicle trim name
links	links	array of LinkDescriptionObject	A collection of HATEOAS links