Queues up the creation or updates of existing loads.

Inputs are validated against the API schema immediately and errors are returned in the response, but specific load data is validated asynchronously (such as whether addresses can be geocoded). Subsequent calls to this API using the same externalId are used to update the already created load.

This API should be used to ensure that loads are kept in sync with any other source of truth your brokerage maintains such as your TMS. Load updates should be pushed to this API as soon as changes are made in other systems to avoid duplicate actions across systems, such as loads matched with multiple carriers. All loads should be synced to ensure loads are not orphaned if not updated in subsequent syncs. Load should be synced for up to three days after completion or cancellation. This API does not currently support other modes of transportation than full truckload freight. Ocean, Intermodal, Air, LTL, Tanker, etc. should be not be synced with this API.

Use Cases:

• Make a load available in the Convoy marketplace by creating a load marked with a postingStatus: AVAILABLE
• Update a load available in the Convoy marketplace by sending the updated information along with the externalId of the load
• Cancel a load in the Convoy marketplace, such as when they are canceled in your TMS, by sending the load along with a postingStatus: CANCELED
• Mark a load as already covered by a carrier outside not matched by Convoy by sending postingStatus: COVERED along with the externalId of the load.

{
  "loads": [
    {
      "postingRates": {
        "maxBuyRateCents": 95000,
        "autoAcceptRateCents": 75000
      }
    }
  ]
}