This will post a new load to the load board
Post a Standard Load
## Posting a load to the load board
POST /loadmanagement/v2/load Creates a new load on the load board. Authorization bearer token Content Type application/json URL Params None Body Params Load Object curl --request POST \ --url https://api-int.truckstop.com/loadmanagement/v2/load \ --header 'Content-Type: application/json' \ --header 'accept: application/json' \ --header 'authorization: Bearer <access token>' \ --data ' { "postasuserID": "df7dbc1a-a21d-e911-a9ec-a3b8a698ca96", "equipmentAttributes": { "equipmentTypeId": 17, "equipmentOptions": [ 2 ], "transportationModeId": 1, "otherEquipmentNeeds": "Pallet Return" }, "commodityId": 1, "loadStops": [ { "type": 1, "sequence": 1, "earlyDateTime": "2024-10-28T00:00:00Z", "lateDateTime": "2024-10-28T00:00:00Z", "location": { "locationName": "ABC Shippers", "city": "Chicago", "state": "IL", "streetAddress1": "123 Main St", "streetAddress2": "Null", "countryCode": "USA", "postalCode": "60007", "latitude": 41.8781, "longitude": -87.6298 }, "contactName": "Joseph Smith", "contactPhone": "1234567890", "stopNotes": "Pickup", "referenceNumbers": [ "1" ] }, { "type": 2, "sequence": 2, "earlyDateTime": "2024-10-29T11:34:32", "lateDateTime": "2024-10-29T11:34:32", "location": { "locationName": "CBA Warehouse", "city": "Chicago", "state": "IL", "streetAddress1": "123 Main St", "streetAddress2": "Null", "countryCode": "USA", "postalCode": "60007", "latitude": 41.8781, "longitude": -87.6298 }, "contactName": "Joseph Smith", "contactPhone": "1234567890", "stopNotes": "Deliver Here!", "referenceNumbers": [ "2" ] } ], "note": "This is load LD1234", "freightClassId": 1, "loadNumber": "LD1234", "loadTrackingRequired": false, "rateAttributes": { "postedAllInRate": { "amount": 100.5, "currencyCode": "USD" } }, "Dimensional": { "length": 53, "width": 8, "height": 10, "weight": 40000, "palletCount": 5, "pieceCount": 500, "cube": 4240 }, "LoadActionAttributes": { "loadActionId": "4", "loadActionOption": "PostOnly" }, "LoadLabel": "Boxes of Screws", "tenderNotes": "Tender Notes", "loadReferenceNumbers": [ "1" ] } 'HTTP/1.1 201 Created Content-Type: application/json; charset=utf-8 Location: https://api-int.truckstop.com/loadmanagement/v2/load?loadid=a020197d-511c-4370-aa8d-2b6172fecc4c CorrelationId: 901b6bd9-cd5a-4fca-9955-fc94db7eeacd { "loadId": "a020197d-511c-4370-aa8d-2b6172fecc4c", "postAsUserId": "df7dbc1a-a21d-e911-a9ec-a3b8a698ca96", "postAsUser": { "id": "df7dbc1a-a21d-e911-a9ec-a3b8a698ca96", "firstName": "Tom", "lastName": "Jerry", "email": "[email protected]", "phone": "(123)-456-7890", "userName": "TOMJERRY" }, "createdBy": "df7dbc1a-a21d-e911-a9ec-a3b8a698ca96", "updatedBy": "df7dbc1a-a21d-e911-a9ec-a3b8a698ca96", "createdDateTime": "2019-01-10T22:6:47", "updatedDateTime": "2019-03-14T09:16:55", "loadState": { "loadStateDescription": "Posted", "loadStateId": 1 }, "loadStateReason": null, "tenderId": 0, "carrierName": "", "loadActivity": [ { "id": "493c98cc-a8c5-e911-aa10-c79a7aacaffe", "createdDate": "2019-08-24T13:19:46Z", "loadState": { "loadStateDescription": "Posted", "loadStateId": 1 }, "loadStateReason": { "loadStateReasonDescription": "Not Specified", "loadStateReasonId": 0 }, "comment": "Test data" } ], "source": "Integration", "equipmentAttributes": { "equipmentTypeId": 17, "equipmentOptions": [ 2, 3 ], "transportationModeId": 2, "otherEquipmentNeeds": "Pallet return" }, "commodityId": 1, "loadStops": [ { "id": "5465e391-6ada-e911-aa11-ac4ba6accd3e", "type": 1, "sequence": 1, "earlyDateTime": "2019-09-18T17:09:04Z", "lateDateTime": "2019-09-18T17:10:04Z", "location": { "id": "bc72bac5-da02-4c08-9eda-f42b0f1c2cb3", "locationName": "ABC Warehouse", "city": "New York", "state": "NY", "streetAddress1": "261 madison ave", "streetAddress2": "101", "countryCode": "USA", "postalCode": "10016", "latitude": 40.7505, "longitude": -73.9806 }, "contactName": "Joseph Adams", "contactPhone": "5553125555", "stopNotes": "Be polite", "referenceNumbers": [ "123" ] }, { "id": "5665e391-6ada-e911-aa11-ac4ba6accd3e", "type": 2, "sequence": 2, "earlyDateTime": "2019-09-21T16:23:33", "lateDateTime": "2019-09-21T22:16:55", "location": { "id": "1a7667b0-1699-48ca-b8ef-75e4e5cf0b6a", "locationName": "XYZ Warehouse", "city": "Houston", "state": "TX", "streetAddress1": "1902 Westheimer Rd", "streetAddress2": "Suite 101", "countryCode": "USA", "postalCode": "77098", "latitude": 29.743, "longitude": -95.4075 }, "contactName": "Marty", "contactPhone": "5553325555", "stopNotes": "", "referenceNumbers": [ "6789", "234hhd3" ] } ], "note": "For more details around this load please call 555-432-1026 and reference load number 39363.", "loadNumber": "LN_39363", "loadTrackingRequired": true, "rateAttributes": { "postedAllInRate": { "amount": 1000.53, "currencyCode": "USD" }, "tenderAllInRate": { "amount": 1000.53, "currencyCode": "USD" } }, "customData": [ { "key": "LoadNumber", "value": "1234" }, { "key": "MySpecialKey", "value": "MySpecialValue" } ], "dimensional": { "length": 10.00, "width": 10.00, "weight": 3000.00, "height": 8.00, "palletCount": 0, "pieceCount": 1, "cube": 800.00 }, "loadActionAttributes": { "loadActionId": "1", "loadActionOption": "PostOnlineTender" }, "loadLabel": "Copper Cauldron", "tenderNotes": "Lannister always pays his debts", "loadReferenceNumbers": [ "123", "heth4573" ], "termsAndConditions": { "id": "b64f76d0-5ee1-e911-aa11-ac4ba6accd3e", > "name": "TC 9651" } }
Post as User
### Notes on using the Post As User functionality
- Post As User allows you to post the load on behalf of another user within the same account. The load will post with that user's contact information instead of the authenticated user's contact information.
- The below endpoint provides the ability to retrieve the details of active users on the same account as the authenticated user.
- Please note that the “PostAsUserId” only works for users that are on the same account, Child/Sibling/Parent accounts will not work.
- If you do not use the “PostAsUserId” field, the contact information will default to the authenticated user's contact information.
POST /accountmanagement/v1/accountuser/active Retrieve active user accounts
Authorization bearer token Content Type application/json URL Params None Body Params Pagination Object curl --request POST \ --url https://api-int.truckstop.com/accountmanagement/v1/accountuser/active \ --header 'accept: application/json' \ --header 'authorization: Bearer <access token>' \ --header 'content-type: application/json' \ --data ' { "pagination": { "pageNumber": 1, "pageSize": 100 } } '{ "pagination": { "totalPages": 1, "pageNumber": 1, "pageSize": 100, "totalItemCount": 2, "resultsTruncated": false }, "success": true, "correlationId": "d8d3a649-ed29-4777-9ede-8eed72a2eb1d", "results": [ { "success": true, "data": [ { "userId": "005Pn000003fB93IAE", "accountId": "3d45735a-b155-e911-aa1e-b0e52ccc70f6", "id": "28bcfbd3-c1c5-97ab-5df4-ce2a084138aa", "emailAddress": "[email protected]", "alias": "TestUser1", "firstName": "Test", "lastName": "User1", "mobile": "(123) 000-0000", "phone": "(123) 000-0000", "isDefault": false, "isActive": true, "username": "[email protected]" }, { "userId": "005Pn000003fB2bIAE", "accountId": "3d45735a-b155-e911-aa1e-b0e52ccc70f6", "id": "ef6fd463-653c-bfad-ea92-7d9644c1d83f", "emailAddress": "[email protected]", "alias": "TestUser2", "firstName": "Test", "lastName": "User2", "mobile": "(123) 000-0000", "phone": "(123) 000-0000", "isDefault": false, "isActive": true, "username": "[email protected]" } ], "statusSet": [ { "code": 200, "descriptor": "OK", "message": "Request completed successfully", "field": null } ] } ] }