Bill Payments8

Bills11

Carrier Contacts5

Carrier Factors6

Carrier Payment Methods5

Carriers8

Companies5

Credit Memos8

Customer Contacts5

Customers8

Documents20

Invoices11

Loads13

Location Contacts5

Locations6

Payment Terms5

Payments6

Quotes6

Reference Data3

Saved Searches5

Search1

Services5

Shipments16

Stops5

Teams5

Users6

Vendor Contacts5

Vendor Payment Methods5

Vendors8

Webhooks

Event Notifications1

Loads

Add carrier to load

Changed on Oct 16, 2026

Add an additional carrier to a load.

Use cases

Split loads (multiple carriers for same load)
Adding backup carrier
Re-assigning after TONU/bounce

What happens

New LoadCarrier record is created
Carrier is notified (if configured)

post/loads/{id}/add-carrier

Request

Base URL: https://api.mvmnt.io/v1
URL: https://api.mvmnt.io/v1/loads/{id}/add-carrier
Auth: HTTP bearer

Path parameters

idstring required

Resource ID (UUID) or client key

Query parameters

by'id' | 'key'

Specify lookup type for faster retrieval. If omitted, defaults to looking up by ID first, then falls back to client key if not found. Use by=key when you know you're providing a client key for best performance.

Request body

driverPhonestring

truckNumberstring

trailerNumberstring

Response

Carrier added successfully

loadIdstring uuid required

loadCarrierIdstring uuid required

The new load carrier ID

Example response

{
  "loadCarrier": {
    "carrier": {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "key": "ERP-CARRIER-SWIFT",
      "name": "Swift Transportation",
      "phoneNumber": "+1-555-987-6543",
      "email": "dispatch@swifttrans.com",
      "createdAt": "2025-01-15T10:00:00Z",
      "updatedAt": "2025-01-15T14:30:00Z"
    }
  }
}

Changes

Oct 16, 2026a67a66657930 Revision changes
- breaking
  added the new required request property //
- breaking
  added the new required request property //
- warning
  the // request property's maxLength was set to 500
- warning
  the // request property's min was set to 0.00
- warning
  removed the request property //
- warning
  removed the request property //
- info
  added the new optional request property //
Oct 7, 20262cd6ecfbeb82 Revision changes
- breaking
  the response's body type changed from object to no type for status
- breaking
  removed the required property from the response with the status
- breaking
  removed the required property from the response with the status
- breaking
  removed the required property from the response with the status
- breaking
  removed the required property from the response with the status
- breaking
  removed the required property from the response with the status
- breaking
  removed the required property from the response with the status
- breaking
  removed the required property from the response with the status
- breaking
  removed the required property from the response with the status
- breaking
  removed the required property from the response with the status
- info
  added subschema #2 to the response body allOf list for the response status
- info
  media type application/json was changed to a more specific media type application/problem+json for the response status
- info
  media type application/json was changed to a more specific media type application/problem+json for the response status
- info
  media type application/json was changed to a more specific media type application/problem+json for the response status
- info
  media type application/json was changed to a more specific media type application/problem+json for the response status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status

Operation history (4 revisions)