Step 2. Create a freight partner carrier.

Create a carrier, which will appear in the Carrier List in your Motive Smart Load Board.

Use this call to create a carrier, which will appear in your broker Motive Smart Load Board. A carrier is a company or operator that transports freight. To create a carrier object, make a POST call to the /api/fmp/v1/carriers endpoint.

By default, carriers can see all of your loads, but you can control load visibility and the actions available to specific carriers by calling this endpoint. For example, you can allow or block carriers from seeing posted loads; or you can allow carriers to book or bid.

In your call, provide either the USDOT or the MC/MX/FF number. In our workflow, a USDOT is provided. (When applicants register online via the Unified Registration System; they are issued a USDOT number and one or more MC/MX/FF numbers.) To create a carrier, you must provide one of these IDs as a String:

  • mc_mx_ff: The operating authority (MC/FF/MX number) is assigned to interstate for-hire motor carriers and brokers that apply for operating authority. This number is also referred to as a docket number or as an "MC," "FF," or "MX" number. Operating Authority dictates the type of operation a company may run and the cargo it may carry. Unlike the USDOT Number application process, a company may have multiple operating authorities to support its business operations.
  • usdot: A Department of Transportation (DOT) number is a number the Federal Motor Carrier Safety Administration (FMCSA) assigns to registered commercial vehicles weighing more than a certain amount, carrying specific amounts of paying passengers, or operating between state lines.

To update the identifier in the future, you will have to delete the carrier object and recreate it with the new identifier by making a POST call to this endpoint.

You can allowlist or blocklist carriers by using the status field. Status can have the following values:

  • STATUS_ALLOWED: The carrier can see open loads and take allowlist actions on them, such as booking or bidding on a load.
  • STATUS_BLOCKED: The carrier cannot see any of your loads, and thus cannot take any actions on them.

The default value for status is 'STATUS_ALLOWED', meaning that carriers who have not been created in your Smart Load Board (meaning, carriers you have not created, but who use the tokens of companies you have created), or carriers whose status is neither Allowed nor Blocked, can see open loads and take the general actions defined in your preferences.

Optionally provide load qualifications for the carrier; these consist of one or more requirements that the carrier must meet, such as maximum and minimum temperatures, tarp size, oversized length and width, alcohol permit, etc. load_qualifications is therefore an array of requirement objects. Each requirement is one requirement object in the form of a key-value pair, such as:

"value": "32"

Finally, provide an optional carrier_reference ID as a String. This is the reference number you have for the same carrier in your internal system of record. This is not to be confused with the Motive carrier_id discussed below.

Once a carrier is created, a carrier_id is returned in the response payload. This is the Motive-assigned ID for this carrier and how the carrier is identified in Motive's system. Store and use this ID to perform any future actions related to the carrier.


Learn more

Read our reference documentation for the Freight Marketplace API's Create a carrier article for details.

Click Try It! to start a request and see the response here!