Overview
Use the Lead Reassignment API to reassign a single existing Aimbase lead to a specified dealer.
The lead ID is provided in the endpoint URL. The target dealer ID and reassignment options are provided in the JSON request body.
Note: Bulk reassignment is not supported. Each request can reassign only one lead.
Authentication
The Lead Reassignment API requires authentication. The HTTP POST requires a valid Authenticate message header with an API token. See the Aimbase Authentication Web Service Specification for more details on how to retrieve a valid API token.
Authenticate message header example:
Authenticate: Avala-Api {username}:{token}Post Information
HTTP Endpoint
POST https://{baseurl}/odata/V2/Leads({leadId})/AimbaseOData.LeadMethods.ReassignLeadContent Type
application/json
Request Data Schema
| Field Name | Required | Format | Description |
| DealerId | X | Integer | The Aimbase dealer ID to which the lead will be reassigned. |
| SendLeadNotifications | X | Boolean | Indicates whether lead notifications should be sent after reassignment. |
| SendCrm | X | Boolean | Indicates whether the reassigned lead should be sent to the CRM integration. |
| AllowRerouting | Boolean or null | Indicates whether rerouting is allowed. This value applies only when the lead supports rerouting. | |
| QualifiedLead | Boolean or null | Indicates whether the lead should be marked as qualified. This value applies only when the lead supports lead qualification. | |
| Note | String | An optional note to save as a comment on the lead after reassignment. |
JSON Example Post
Example using merge fields:
POST {{baseUrl}}/odata/V2/Leads({{targetLeadId}})/AimbaseOData.LeadMethods.ReassignLead
Content-Type: application/json
Authenticate: Avala-Api {{AuthToken}}
{
"DealerId": {{targetDealerId}},
"SendLeadNotifications": true,
"SendCrm": false,
"AllowRerouting": false,
"QualifiedLead": false,
"Note": "Reassigned via API"
}Example using populated values:
POST {{baseUrl}}/odata/V2/Leads(102071)/AimbaseOData.LeadMethods.ReassignLead
Content-Type: application/json
Authenticate: Avala-Api {{AuthToken}}
{
"DealerId": 1647,
"SendLeadNotifications": true,
"SendCrm": false,
"AllowRerouting": false,
"QualifiedLead": null,
"Note": "Reassigned via API"
}Sample Success Response
A successful lead reassignment returns an HTTP 200 response with the lead and dealer assignment details.
HTTP/1.1 200 OK
Date: Wed, 14 Oct 2026 14:49:48 GMT
Content-Type: application/json; odata.metadata=minimal
Content-Length: 259
Connection: close
Access-Control-Expose-Headers: Request-Context
Cache-Control: no-cache
Expires: -1
Pragma: no-cache
api-supported-versions: 1.0, 2.0
OData-Version: 4.0
X-AspNet-Version: 4.0.30319
Request-Context: appId=cid-v1:16f8d7a5-63fa-4ed2-acb1-7c4d1976984b
X-Powered-By: ASP.NET, ASP.NET
{
"@odata.context": "http://traversebikes.aimbase.com/odata/V2/$metadata#Aimbase.Marketing.Web.Models.OData.V2.LeadReassignmentResultOData",
"LeadId": 102071,
"DealerId": 1647,
"DealerName": "Aaron's Powersports",
"DealerNumber": "AP1234",
"Reassigned": true
}