Create Carrier

POST /v2/tms-api/carriers

Create a new carrier in your organization. Carriers can have multiple contacts and an address.

API Reference

Request Body

Required Fields

external_reference_idstringrequired

Your unique identifier for this carrier

namestringrequired

Carrier name

Optional Fields

mc_numberstring

MC number (deprecated — use DOT)

dot_numberstring

DOT number

phone_numberstring

Main phone number

emailstring

Main email address

contactsarray

Array of carrier contacts with `first_name`, `last_name`, `primary_email`, `primary_phone`, `is_primary_contact`

Request Example

curl -X POST "https://api.mentium.io/v2/tms-api/carriers" \
  -H "X-API-Key: your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "external_reference_id": "CARRIER-MIDWEST-001",
    "name": "Midwest Express Trucking",
    "dot_number": "DOT789012",
    "phone_number": "800-555-0101",
    "email": "dispatch@midwestexpress.com",
    "contacts": [
      {
        "first_name": "John",
        "last_name": "Driver",
        "primary_email": "john@midwestexpress.com",
        "primary_phone": "800-555-0102",
        "is_primary_contact": true
      }
    ]
  }'

Response

201 Created

{
  "id": "carrier_abc123def456",
  "external_reference_id": "CARRIER-MIDWEST-001",
  "name": "Midwest Express Trucking",
  "dot_number": "DOT789012",
  "phone_number": "800-555-0101",
  "email": "dispatch@midwestexpress.com",
  "contacts": [
    {
      "id": "contact_001",
      "first_name": "John",
      "last_name": "Driver",
      "primary_email": "john@midwestexpress.com",
      "primary_phone": "800-555-0102",
      "is_primary_contact": true
    }
  ],
  "created_at": "2026-01-29T10:30:00Z",
  "updated_at": "2026-01-29T10:30:00Z"
}