Create or update a carrier

Carrier master data and tracking contacts. A carrier whose contacts are managed inside TrackFlo is reported as skipped and left unchanged.

POST /api/v1/carriers/upsert

API key in header X-API-Key

curl 'https://integration-api.trackflo.tech/api/v1/carriers/upsert' \
  --request POST \
  --header 'Trackflo-Ingest-Source: pull' \
  --header 'X-API-Key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
  "native_system_carrier_id": "SINBDEGA",
  "carrier_name": "EXAMPLE TRUCKING LLC",
  "native_system_carrier_permalink": "SINBDEGA-acme",
  "primary_after_hours_tracking_contact_name": "Jane Dispatcher",
  "primary_after_hours_tracking_contact_email": "[email protected]",
  "primary_after_hours_tracking_contact_phone_number": "(555) 010-0100",
  "primary_pod_contact_name": "Jane Dispatcher",
  "primary_pod_contact_email": "[email protected]",
  "primary_pod_contact_phone_number": "(555) 010-0100",
  "company_permalink": "acme"
}'

{
  "status": "processed",
  "message": "example",
  "permalink": "example"
}

Stored, skipped or duplicate — see status.

Headers

· 1

Trackflo-Ingest-Source string · enum

pull for scheduled polling, webhook for event-driven pushes. Lets TrackFlo monitor the health of each ingestion path separately; recommended on every request.

values

pull
webhook

Body

· CarrierUpsert

required application/json

native_system_carrier_id string · max length: 100· nullable

Required. Your TMS's id for the carrier.

carrier_name string · max length: 100· nullable

Required. Carrier name.

mc_number string · max length: 100· nullable

Recommended. Motor carrier (MC) number.

dot_number string · max length: 100· nullable

Recommended. US DOT number.

native_system_carrier_permalink string · max length: 100 required

Required. Unique key: -. Identifies the carrier on every upsert.

primary_tracking_contact_name string · max length: 100· nullable

Recommended. Carrier's primary tracking contact. Used for outreach.

primary_tracking_contact_email string · max length: 100· nullable

Recommended. Email of the primary tracking contact. Used for outreach.

primary_tracking_contact_phone_number string · max length: 100· nullable

Recommended. Phone of the primary tracking contact. Used for outreach.

Headers

Body

Responses