---
title: "Create Carrier"
method: POST
path: "/v2/tms-api/carriers"
tags: ["TMS API", "TMS API - Carriers"]
---

# Create Carrier

`POST /v2/tms-api/carriers`

## Request

- Base URL: `https://api.mentium.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.mentium.io/v2/tms-api/carriers`
- Auth: none declared

Create a new carrier.

## Headers

- `X-API-Key` string, nullable: API key for authentication

## Request body

- CarrierCreate: Schema for creating a carrier.
  - `external_reference_id` string, required: Unique identifier from your system
  - `name` string, required: Carrier name
  - `dot_number` string, nullable: DOT number
  - `mc_number` string, nullable: MC (docket) number
  - `phone_number` string, nullable: Main phone number
  - `email` string, nullable: Main email address
  - `address` AddressCreate: Schema for an address.
    - `address_line1` string, nullable: Street address line 1
    - `address_line2` string, nullable: Street address line 2
    - `city` string, nullable: City
    - `state` string, nullable: State/Province
    - `postal_code` string, nullable: Postal/ZIP code
    - `country` string, nullable: Country
  - `contacts` CarrierContactCreate[], nullable: Carrier contacts
    - `external_reference_id` string, nullable: External reference ID for the contact
    - `first_name` string, required: First name
    - `last_name` string, required: Last name
    - `contact_type` string, nullable: Contact type (e.g., Primary, Dispatch)
    - `job_title` string, nullable: Job title
    - `primary_email` string, nullable: Primary email
    - `primary_phone` string, nullable: Primary phone number
    - `primary_phone_extension` string, nullable: Phone extension
    - `is_primary_contact` boolean, nullable: Is this the primary contact
    - `is_active` boolean, nullable: Is the contact active

## Response `201`

Successful Response

- CarrierResponse: Response schema for a carrier.
  - `id` string, required: Internal Mentium ID
  - `external_reference_id` string, required: External reference ID from your system
  - `name` string, required: Carrier name
  - `dot_number` string, nullable: DOT number
  - `mc_number` string, nullable: MC (docket) number
  - `phone_number` string, nullable: Main phone number
  - `email` string, nullable: Main email address
  - `address` AddressResponse: Response schema for an address.
    - `address_line1` string, nullable: Street address line 1
    - `address_line2` string, nullable: Street address line 2
    - `city` string, nullable: City
    - `state` string, nullable: State/Province
    - `postal_code` string, nullable: Postal/ZIP code
    - `country` string, nullable: Country
  - `contacts` CarrierContactResponse[]: Carrier contacts
    - `id` string, required: Contact ID
    - `external_reference_id` string, nullable: External reference ID
    - `first_name` string, required: First name
    - `last_name` string, required: Last name
    - `contact_type` string, nullable: Contact type
    - `job_title` string, nullable: Job title
    - `primary_email` string, nullable: Primary email
    - `primary_phone` string, nullable: Primary phone number
    - `primary_phone_extension` string, nullable: Phone extension
    - `is_primary_contact` boolean, required: Is this the primary contact
    - `is_active` boolean, required: Is the contact active
  - `created_at` string, date-time, required: Creation timestamp
  - `updated_at` string, date-time, required: Last update timestamp

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/mentium/apis/mentium-api.md) - [All operations](https://skmtc.dev/mentium/apis/mentium-api/llms.txt) - [OpenAPI document](https://skmtc.dev/mentium/apis/mentium-api/revisions/b4ed8e59432e?raw)