Skip to main content
POST
/
v1
/
add_ons
Create an AddOn
curl --request POST \
  --url https://api.tread-horizon.com/v1/add_ons \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "add_on_types": [
    "driver_pay"
  ],
  "cost_rate_value": 123,
  "revenue_rate_value": 123,
  "revenue_cost_rate_type": "RateForEach",
  "quantity": 123,
  "external_id": "<string>",
  "percentage": 0,
  "accounting_id": "<string>",
  "rate": 123,
  "add_on_rate_type": "RateForEach",
  "fuel_surcharge_schedule_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "taxable": false
}
'
{
  "data": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "name": "<string>",
    "add_on_types": [
      "driver_pay"
    ],
    "quantity": "<string>",
    "cost_rate_value": "<string>",
    "revenue_rate_value": "<string>",
    "revenue_cost_rate_type": "RateForEach",
    "external_id": "<string>",
    "percentage": "<string>",
    "company": {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "tread_id": "ABC123",
      "legal_name": "<string>",
      "company_type": "hauler"
    },
    "accounting_id": "<string>",
    "rate": "<string>",
    "add_on_rate_type": "RateForEach",
    "taxable": false,
    "created_at": "2023-11-07T05:31:56Z",
    "updated_at": "2023-11-07T05:31:56Z",
    "fuel_surcharge_schedule": {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "name": "<string>"
    }
  }
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

​
Accept-Language
string
default:en

The Accept-Language request HTTP header indicates the natural language and locale that the client prefers.

Example:

"en"

Body

application/json
​
name
string
required
​
add_on_types
enum<string>[]
required
Available options:
driver_pay,
invoicing,
job,
settlement,
driver_day
​
cost_rate_value
number | null

The cost rate or buy price of the add on.

​
revenue_rate_value
number

The revenue rate or sell price of the add on.

​
revenue_cost_rate_type
enum<string>
default:RateForEach
Available options:
RateForEach,
RatePercentOfTotal,
PerLoad,
FuelSurcharge
Example:

"RateForEach"

​
quantity
number
​
external_id
string | null
​
percentage
number

RatePercentTotal specific field

Required range: -100 <= x <= 100
​
accounting_id
string | null
​
rate
number
deprecated

Deprecated in favor of revenue_rate_value.

​
add_on_rate_type
enum<string>
default:RateForEach
deprecated

Deprecated in favor of revenue_cost_rate_type.

Available options:
RateForEach,
RatePercentOfTotal,
PerLoad,
FuelSurcharge
Example:

"RateForEach"

​
fuel_surcharge_schedule_id
string<uuid> | null
​
taxable
boolean
default:false

Whether this add-on is eligible for taxation

Response

Created

​
data
AddOn-Read · object
required