POST api/Leads

Request Information

URI Parameters

None.

Body Parameters

Name	Type	Additional information
DealerID	integer	Required
ExternalLeadID	string	Required
FirstName	string	Required
LastName	string	Required
ContactNumber	string	Required
EmailAddress	string	None.
Comments	string	None.
LeadOrigin	string	None.
Vehicle	string	None.
StockNo	string	None.
NewUsed	string	Required
SalesPerson	string	None.
Title	string	None.
ModelFamily	string	None.
ModelYear	string	None.
VehicleBrand	string	None.
CurrentVehicle	string	None.
LeadStatus	string	None.
LeadSubStatus	string	None.
LeadStatusReason	string	None.
AppointmentDate1	date	None.
AppointmentDate2	date	None.
AppointmentDate3	date	None.
PreferredDealerAllocatedDateTime	date	None.
Colour	string	None.
Price	string	None.
Mileage	string	None.
InternalUpdateID	string	None.
InternalLeadID	string	Required

Request Formats

application/json, text/json

Sample:

{
  "DealerID": 1,
  "ExternalLeadID": "sample string 2",
  "FirstName": "sample string 3",
  "LastName": "sample string 4",
  "ContactNumber": "sample string 5",
  "EmailAddress": "sample string 6",
  "Comments": "sample string 7",
  "LeadOrigin": "sample string 8",
  "Vehicle": "sample string 9",
  "StockNo": "sample string 10",
  "NewUsed": "sample string 11",
  "SalesPerson": "sample string 12",
  "Title": "sample string 13",
  "ModelFamily": "sample string 14",
  "ModelYear": "sample string 15",
  "VehicleBrand": "sample string 16",
  "CurrentVehicle": "sample string 17",
  "LeadStatus": "sample string 18",
  "LeadSubStatus": "sample string 19",
  "LeadStatusReason": "sample string 20",
  "AppointmentDate1": "2025-11-21T08:53:00.8079239+02:00",
  "AppointmentDate2": "2025-11-21T08:53:00.8079239+02:00",
  "AppointmentDate3": "2025-11-21T08:53:00.8079239+02:00",
  "PreferredDealerAllocatedDateTime": "2025-11-21T08:53:00.8079239+02:00",
  "Colour": "sample string 21",
  "Price": "sample string 22",
  "Mileage": "sample string 23",
  "InternalUpdateID": "sample string 24",
  "InternalLeadID": "sample string 25"
}

application/xml, text/xml

Sample:

<LeadItem xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/ESLeadsAPI.LeadsModel">
  <AppointmentDate1>2025-11-21T08:53:00.8079239+02:00</AppointmentDate1>
  <AppointmentDate2>2025-11-21T08:53:00.8079239+02:00</AppointmentDate2>
  <AppointmentDate3>2025-11-21T08:53:00.8079239+02:00</AppointmentDate3>
  <Colour>sample string 21</Colour>
  <Comments>sample string 7</Comments>
  <ContactNumber>sample string 5</ContactNumber>
  <CurrentVehicle>sample string 17</CurrentVehicle>
  <DealerID>1</DealerID>
  <EmailAddress>sample string 6</EmailAddress>
  <ExternalLeadID>sample string 2</ExternalLeadID>
  <FirstName>sample string 3</FirstName>
  <InternalLeadID>sample string 25</InternalLeadID>
  <InternalUpdateID>sample string 24</InternalUpdateID>
  <LastName>sample string 4</LastName>
  <LeadOrigin>sample string 8</LeadOrigin>
  <LeadStatus>sample string 18</LeadStatus>
  <LeadStatusReason>sample string 20</LeadStatusReason>
  <LeadSubStatus>sample string 19</LeadSubStatus>
  <Mileage>sample string 23</Mileage>
  <ModelFamily>sample string 14</ModelFamily>
  <ModelYear>sample string 15</ModelYear>
  <NewUsed>sample string 11</NewUsed>
  <PreferredDealerAllocatedDateTime>2025-11-21T08:53:00.8079239+02:00</PreferredDealerAllocatedDateTime>
  <Price>sample string 22</Price>
  <SalesPerson>sample string 12</SalesPerson>
  <StockNo>sample string 10</StockNo>
  <Title>sample string 13</Title>
  <Vehicle>sample string 9</Vehicle>
  <VehicleBrand>sample string 16</VehicleBrand>
</LeadItem>

application/x-www-form-urlencoded

Sample:

Failed to generate the sample for media type 'application/x-www-form-urlencoded'. Cannot use formatter 'JQueryMvcFormUrlEncodedFormatter' to write type 'LeadItem'.

Response Information

Resource Description

HttpResponseMessage

Name	Type	Additional information
Version	Version	None.
Content	HttpContent	None.
StatusCode	HttpStatusCode	None.
ReasonPhrase	string	None.
Headers	Collection of Object	None.
RequestMessage	HttpRequestMessage	None.
IsSuccessStatusCode	boolean	None.