RouteDesk API

Send leads to RouteDesk

Lead vendors deliver leads straight into an auto transport broker's RouteDesk account with one HTTPS request. No SDK, no login, no polling.

Send your first lead

POST/api/v1/public/leads

All requests go to https://api.routedesk.com over HTTPS, with a JSON body.

Get an Auth Key from the broker. Each lead source in the broker's RouteDesk account has its own key. The broker copies it from their Lead sources settings and sends it to you.
Send the lead. Put the key in the Authorization header and the lead in the body.
Check the response. A 201 with a leadId means the lead is in the broker's account.

curl https://api.routedesk.com/api/v1/public/leads \
  -H "Authorization: Bearer YOUR_AUTH_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "firstName": "Jordan",
    "lastName": "Rivera",
    "email": "jordan.rivera@example.com",
    "phone": "+13055550142",
    "origin": {
      "city": "Miami",
      "state": "FL",
      "postalCode": "33101"
    },
    "destination": {
      "city": "Dallas",
      "state": "TX",
      "postalCode": "75201"
    },
    "shipDate": "2026-12-01",
    "transportType": "OPEN",
    "vehicles": [
      {
        "make": "Toyota",
        "model": "Camry",
        "modelYear": 2022
      }
    ]
  }'

const response = await fetch('https://api.routedesk.com/api/v1/public/leads', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer YOUR_AUTH_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "firstName": "Jordan",
    "lastName": "Rivera",
    "email": "jordan.rivera@example.com",
    "phone": "+13055550142",
    "origin": {
      "city": "Miami",
      "state": "FL",
      "postalCode": "33101"
    },
    "destination": {
      "city": "Dallas",
      "state": "TX",
      "postalCode": "75201"
    },
    "shipDate": "2026-12-01",
    "transportType": "OPEN",
    "vehicles": [
      {
        "make": "Toyota",
        "model": "Camry",
        "modelYear": 2022
      }
    ]
  }),
});

const result = await response.json();
console.log(response.status, result);

<?php

$payload = [
    'firstName' => 'Jordan',
    'lastName' => 'Rivera',
    'email' => 'jordan.rivera@example.com',
    'phone' => '+13055550142',
    'origin' => [
        'city' => 'Miami',
        'state' => 'FL',
        'postalCode' => '33101',
    ],
    'destination' => [
        'city' => 'Dallas',
        'state' => 'TX',
        'postalCode' => '75201',
    ],
    'shipDate' => '2026-12-01',
    'transportType' => 'OPEN',
    'vehicles' => [
        [
            'make' => 'Toyota',
            'model' => 'Camry',
            'modelYear' => 2022,
        ],
    ],
];

$ch = curl_init('https://api.routedesk.com/api/v1/public/leads');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer YOUR_AUTH_KEY',
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => json_encode($payload),
]);

$body = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
curl_close($ch);

echo $status, ' ', $body;

import requests

response = requests.post(
    "https://api.routedesk.com/api/v1/public/leads",
    headers={"Authorization": "Bearer YOUR_AUTH_KEY"},
    json={
        "firstName": "Jordan",
        "lastName": "Rivera",
        "email": "jordan.rivera@example.com",
        "phone": "+13055550142",
        "origin": {
            "city": "Miami",
            "state": "FL",
            "postalCode": "33101",
        },
        "destination": {
            "city": "Dallas",
            "state": "TX",
            "postalCode": "75201",
        },
        "shipDate": "2026-12-01",
        "transportType": "OPEN",
        "vehicles": [
            {
                "make": "Toyota",
                "model": "Camry",
                "modelYear": 2022,
            },
        ],
    },
    timeout=10,
)

print(response.status_code, response.json())

Response · 201

{
  "success": true,
  "message": "Lead created successfully",
  "leadId": "e763f6b3-946b-4980-83d6-859cbd636a98"
}

Two formats, one endpoint

The endpoint accepts a lead in either of two formats and works out which one you sent.

Standard format. Use this for a new integration. Field names are camelCase and dates are YYYY-MM-DD. See Create a lead.
Legacy format. If you already send leads to BATS, keep the payload you send today and change only the URL and the key. See Already on BATS?

Both create exactly the same lead in RouteDesk.

What happens to a lead

The lead appears in the broker's RouteDesk account straight away, tagged with the lead source your key belongs to. The broker's own rules decide which agent gets it.

If the broker received a lead with the same phone number or email in the last 30 days, the new one is still created and is marked as a possible duplicate for the broker to review.

Next: how the Auth Key works, then how to test before going live.