API documentation

POST /buyer_fleets

Authorization Required

https://[your-subdomain].trackdrive.com/api/v1/buyer_fleets

Create Buyer Fleet.

Creates a Buyer Fleet with a unique user_fleet_id (lowercase letters, numbers, and underscores only) used to identify fleet membership in system tokens.

Params

Param name	Description
name Required	The name of the buyer fleet. Must be a String
description Optional	A description for this buyer fleet. Must be a String
user_fleet_id Required	A unique identifier for this fleet. Only lowercase letters, numbers, and underscores are allowed. This ID is used in system tokens to identify fleet membership. Must be a String

Param name

Description

name
Required

The name of the buyer fleet.

Must be a String

description
Optional

A description for this buyer fleet.

Must be a String

user_fleet_id
Required

A unique identifier for this fleet. Only lowercase letters, numbers, and underscores are allowed. This ID is used in system tokens to identify fleet membership.

Must be a String

Example Request

curl -X POST 'https://[your-subdomain].trackdrive.com/api/v1/buyer_fleets/' \
  -H 'Authorization: Basic BASE64_ENCODED_PUBLIC_KEY_AND_PRIVATE_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
  "name": "Example Buyer Fleet",
  "user_fleet_id": "example_fleet"
}'

Example Response 201

{
  "status": 201,
  "success": true,
  "errors": {},
  "buyer_fleet": {
    "id": 10001,
    "type": "BuyerFleet",
    "uuid": null,
    "created_at": "2026-01-15T15:30:00.000Z",
    "updated_at": "2026-01-15T15:30:00.000Z",
    "deleted_at": null,
    "user_updated_at": null,
    "routes_show_path": "/buyer_fleets/10001",
    "routes_edit_path": "/buyer_fleets/10001/edit",
    "external_record_id": null,
    "company_id": 10002,
    "name": "Example Buyer Fleet",
    "description": null,
    "user_fleet_id": "example_fleet",
    "buyers_count": 0,
    "buyer_ids": []
  },
  "metadata": {
    "root": "buyer_fleet"
  }
}