Lead Disposition API


Use the Lead Disposition API to send activities (email, phone, appointment, quote) performed on a lead or a lead status change (assigned, working, sold). The activities and status changes will be add to the lead history section within Aimbase.


Authentication is not required. Lead Disposition API uses a combination of CRM provider name and IP whitelisting to secure the end point.

Post Information

HTTP Endpoint

https://crmintegrationqa.aimbase.net/api/Disposition?source={CRM provider name}.  QA endpoint.

https://crmintegration.aimbase.net/api/Disposition?source={CRM provider name}.  Production endpoint.

Note, Rollick will provide the CRM provider name. 


Field Name Required Format Description
EntryDate Y datetime Datetime of the status change.
EntryType Y Max Length: 50 Describes the type of activity. StageChanged, StatusChanged, FollowUp, Activity.
EntryDetail Y Max Length: 50 Additional detail. Assigned salesperson, Old Stage: New Stage, Status Value, Type of activity.
Max Length: 50 User that performed the status or activity.
PCHProspectId Y Max Length: 50 CRM provider's unique identifier.
SourceProspectId Y Max Length: 50 Aimbase External Id.

JSON Example Post

   "ProspectActivity": {
      "EntryDate": "2021-09-11T11:45:00Z",
      "SourceProspectId": "aimbase_rollick_qa-42412",
      "PCHProspectId": "ABC123",
      "EntryType": "Contacted",
      "EntryDetail": "Assigned To:Johns Smith",
      "DealershipUser": "JohnD"

XML Example Post

<?xml version="1.0" encoding="UTF-8"?>
    <EntryDetail>Assigned To:Johns Smith</EntryDetail>


HTTP/1.1 200 OK
Cache-Control: no-cache
Pragma: no-cache
Content-Length: 432
Content-Type: application/xml; charset=utf-8
Expires: -1
Server: Microsoft-IIS/10.0
X-AspNet-Version: 4.0.30319
X-Powered-By: ASP.NET
Date: Tue, 21 Sep 2021 18:43:20 GMT
Connection: close

    <ResultMessage>No corresponding Aimbase status mapping for EntryType: Opened, EntryDetail: , Aimbase Status: Viewed</ResultMessage>
    <Status>Data Processing Warning</Status>