Loads
Add carrier to load
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
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
Response
Carrier added successfully
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"
},
"charges": [
{
"chargeCode": {
"id": "550e8400-e29b-41d4-a716-446655440000",
"key": "ERP-USER-12345"
}
}
]
}
}