Create or update carrier relationships and statuses from your TMS to Cargado.
If a carrier is not found, the relationship will be null.
Returns the relationships in the same order and length as the input.
A carrier relationship represents the relationship between a carrier and
an organization, including their onboarding status and whether they can be
assigned to freight.
If a carrier relationship is not found, the carrier will be offered an onboarding link
but will not be assigned to freight until a relationship is created.
A NEEDS_REVIEW but onboarded carrier still requires manual review prior to being assigned
to freight. An ACTIVE but not onboarded carrier can be assigned to freight but the
carrier is still offered an onboarding link.
DO_NOT_DISPATCH should be used to block a carrier from being assigned to freight at an
organization level. Use freight level rules to block a carrier from being assigned to
specific freight.
Show child attributes
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Cargado API Docs","colors":{"primary":"#345ED1","light":"#0EA5E9","dark":"#1F3A89"},"logo":{"light":"https://mintcdn.com/cargado/CLB1kJumWhQp7b97/cargado-logo-azul.png?fit=max\u0026auto=format\u0026n=CLB1kJumWhQp7b97\u0026q=85\u0026s=ce0b66ea21b97607c9feb1078d9e51ba","dark":"https://mintcdn.com/cargado/CLB1kJumWhQp7b97/cargado-logo-white.png?fit=max\u0026auto=format\u0026n=CLB1kJumWhQp7b97\u0026q=85\u0026s=e064cb372e3ce7708ef953d2d8c5a7e0"},"favicon":"https://mintcdn.com/cargado/Wapfgg7ZWTmU6W_z/cargado-favicon-azul.svg?fit=max\u0026auto=format\u0026n=Wapfgg7ZWTmU6W_z\u0026q=85\u0026s=6d3f2144bb002b78fea4fae5ce3ecdc7","api":{"openapi":{"source":"openapi.yml"},"mdx":{"auth":{"method":"bearer"},"server":"https://api.cargado.com"}},"navbar":{"links":[{"href":"mailto:dev-support@cargado.com","label":"Contact Us"}],"primary":{"type":"button","label":"Go to App","href":"https://app.cargado.com"}},"footer":{"socials":{"github":"https://github.com/cargadoinc","linkedin":"https://www.linkedin.com/company/cargado"}},"banner":{"content":"Cargado API is in beta. The API may change in breaking ways."},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"cargado","hasAudioNarration":false,"actualSubdomain":"cargado","customDomains":["docs.cargado.com"],"gitSource":{"type":"github","owner":"cargadoinc","repo":"enchilada","deployBranch":"main","contentDirectory":"mintlify","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6ae25099322060d1d219d232","collectionId":"1795b56e-b12d-4102-87ae-c878c7f2c3c7","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ae25099322060d1d219d232"},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6aee039dd121ed565e112f58","clientVersion":"0.0.4076","searchFilterCounts":[{"language":"default","tag":"API Reference","count":29},{"language":"default","tag":"Concepts","count":9},{"language":"default","tag":"Guides","count":8},{"language":"default","tag":"Webhooks","count":8},{"language":"default","tag":"Webhook Events","count":3},{"language":"default","tag":"Carrier Relationships","count":3},{"language":"default","tag":"Load Sync","count":3},{"language":"default","tag":"Loads","count":2},{"language":"default","tag":"Rates","count":2},{"language":"default","tag":"Getting Started","count":2}]},"assistantConfig":{},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"comment-mode","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/carrierrelationship/upsert-carrier-relationships","slug":"/api-reference/carrierrelationship/upsert-carrier-relationships","pageMetadata":{"title":"Upsert carrier relationships","description":"Create or update carrier relationships and statuses from your TMS to Cargado.\nIf a carrier is not found, the relationship will be null.\nReturns the relationships in the same order and length as the input.","deprecated":null,"version":null,"openapi":"/openapi.yml post /carrier-relationships/upsert","href":"/api-reference/carrierrelationship/upsert-carrier-relationships","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Create or update carrier relationships and statuses from your TMS to Cargado.\\nIf a carrier is not found, the relationship will be null.\\nReturns the relationships in the same order and length as the input.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Upsert carrier relationships","description":"Create or update carrier relationships and statuses from your TMS to Cargado.\nIf a carrier is not found, the relationship will be null.\nReturns the relationships in the same order and length as the input.","deprecated":null,"version":null,"openapi":"/openapi.yml post /carrier-relationships/upsert","href":"/api-reference/carrierrelationship/upsert-carrier-relationships","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"operationId":"UpsertACarrierRelationship","responses":{"200":"87e03852-0f5e-4d83-8aac-bed985acc7a5","401":"5237c7aa-ed1a-425e-9454-40d7fa48bbec"},"description":"Create or update carrier relationships and statuses from your TMS to Cargado.\nIf a carrier is not found, the relationship will be null.\nReturns the relationships in the same order and length as the input.","summary":"Upsert carrier relationships","tags":["CarrierRelationship"],"security":["03812046-f8dc-4b66-85f8-ee472d21546d"],"parameters":[],"requestBody":"0f98c0bb-7f87-4114-853a-8c09fcca09b9","method":"post","type":"path","servers":["680435da-8bd8-44c0-bc61-09cd96d9e52e"],"path":"/carrier-relationships/upsert","baseUrlOptions":["https://api.cargado.com"],"title":"Upsert carrier relationships","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"carrierRelationships":{"items":{"properties":{"carrier":{"description":"A specific carrier as defined by a set of unique government identifiers.\nAt least one of the identifiers must be provided.","properties":{"dotNumber":{"type":"string","description":"The carrier's DOT number","examples":["123456"],"uniqueKey":"carrierRelationships.items.[INDEX].carrier.dotNumber","typeLabel":"string"},"mcNumber":{"type":"string","description":"The carrier's MC number","examples":["248243"],"uniqueKey":"carrierRelationships.items.[INDEX].carrier.mcNumber","typeLabel":"string"},"mxNumber":{"type":"string","description":"The carrier's MX number","examples":["2343"],"uniqueKey":"carrierRelationships.items.[INDEX].carrier.mxNumber","typeLabel":"string"},"rfcNumber":{"type":"string","description":"The carrier's RFC number","examples":["RUSM2344227MY4"],"uniqueKey":"carrierRelationships.items.[INDEX].carrier.rfcNumber","typeLabel":"string"},"cvorNumber":{"type":"string","description":"The carrier's Commercial Vehicle Operator Registration number (CVOR)","examples":["2344227MY4"],"uniqueKey":"carrierRelationships.items.[INDEX].carrier.cvorNumber","typeLabel":"string"},"nirNumber":{"type":"string","description":"The carrier's Registration identification number (NIR)","examples":["R-23424"],"uniqueKey":"carrierRelationships.items.[INDEX].carrier.nirNumber","typeLabel":"string"},"nscNumber":{"type":"string","description":"The carrier's National Safety Code (NSC) number","examples":["2344227MY4"],"uniqueKey":"carrierRelationships.items.[INDEX].carrier.nscNumber","typeLabel":"string"},"externalId":{"type":"string","description":"An external identifier for the carrier in your TMS. This is used to\nmatch carriers across systems when government identifiers (DOT, MC)\nare not available on the source record.\n\nExamples: McLeod's vendor/payee ID (\"GJNTMIIN\"), Tai's carrierMasterId.","minLength":1,"maxLength":255,"examples":["GJNTMIIN"],"uniqueKey":"carrierRelationships.items.[INDEX].carrier.externalId","typeLabel":"string"}},"type":"object","additionalProperties":true,"isRequired":true,"uniqueKey":"carrierRelationships.items.[INDEX].carrier","typeLabel":"object"},"status":{"type":"string","enum":["ACTIVE","NEEDS_REVIEW","DO_NOT_DISPATCH"],"description":"- ACTIVE: The carrier is active with the organization and ready to be assigned to freight.\n- NEEDS_REVIEW: The carrier needs review prior to being assigned to freight.\n- DO_NOT_DISPATCH: The carrier is not allowed to be assigned to freight, and will not see\n any freight in the marketplace.","isRequired":true,"uniqueKey":"carrierRelationships.items.[INDEX].status","typeLabel":"enum\u003cstring>"},"onboardingStatus":{"type":"string","enum":["ONBOARDED","NEEDS_TO_ONBOARD"],"description":"There are 2 possible values for a carrier relationship status:\n- ONBOARDED: The carrier is onboarded.\n- NEEDS_TO_ONBOARD: The carrier needs to be onboarded, even if they have been onboarded before.","isRequired":true,"uniqueKey":"carrierRelationships.items.[INDEX].onboardingStatus","typeLabel":"enum\u003cstring>"},"carrierExternalId":{"type":"string","description":"An external identifier for the carrier in your TMS. When provided,\nthis ID is stored on the carrier relationship and can be used to\nconsistently match carriers during load sync.","minLength":1,"maxLength":255,"examples":["GJNTMIIN"],"uniqueKey":"carrierRelationships.items.[INDEX].carrierExternalId","typeLabel":"string"}},"required":["carrier","status","onboardingStatus"],"type":"object","additionalProperties":true,"uniqueKey":"carrierRelationships.items.[INDEX]","typeLabel":"object"},"type":"array","isRequired":true,"uniqueKey":"carrierRelationships","typeLabel":"object[]"}},"required":["carrierRelationships"],"type":"object","additionalProperties":true,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"carrierRelationships":[{"carrier":{"dotNumber":"123456","mcNumber":"248243","mxNumber":"2343","rfcNumber":"RUSM2344227MY4","cvorNumber":"2344227MY4","nirNumber":"R-23424","nscNumber":"2344227MY4","externalId":"GJNTMIIN"},"carrierExternalId":"GJNTMIIN"}]}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"87e03852-0f5e-4d83-8aac-bed985acc7a5":{"description":"Ok","content":{"application/json":{"schema":{"properties":{"carrierRelationships":{"items":{"oneOf":[{"type":"object","description":"A carrier relationship represents the relationship between a carrier and\nan organization, including their onboarding status and whether they can be\nassigned to freight.\n\nIf a carrier relationship is not found, the carrier will be offered an onboarding link\nbut will not be assigned to freight until a relationship is created.\n\nA NEEDS_REVIEW but onboarded carrier still requires manual review prior to being assigned\nto freight. An ACTIVE but not onboarded carrier can be assigned to freight but the\ncarrier is still offered an onboarding link.\n\nDO_NOT_DISPATCH should be used to block a carrier from being assigned to freight at an\norganization level. Use freight level rules to block a carrier from being assigned to\nspecific freight.","required":["id","organizationId","carrierOrganizationId","status","onboardingStatus"],"properties":{"id":{"type":"string","isRequired":true,"uniqueKey":"carrierRelationships.items.[INDEX].oneOf.0.id","typeLabel":"string"},"organizationId":{"type":"string","isRequired":true,"uniqueKey":"carrierRelationships.items.[INDEX].oneOf.0.organizationId","typeLabel":"string"},"carrierOrganizationId":{"type":"string","isRequired":true,"uniqueKey":"carrierRelationships.items.[INDEX].oneOf.0.carrierOrganizationId","typeLabel":"string"},"status":{"type":"string","enum":["ACTIVE","NEEDS_REVIEW","DO_NOT_DISPATCH"],"description":"- ACTIVE: The carrier is active with the organization and ready to be assigned to freight.\n- NEEDS_REVIEW: The carrier needs review prior to being assigned to freight.\n- DO_NOT_DISPATCH: The carrier is not allowed to be assigned to freight, and will not see\n any freight in the marketplace.","isRequired":true,"uniqueKey":"carrierRelationships.items.[INDEX].oneOf.0.status","typeLabel":"enum\u003cstring>"},"onboardingStatus":{"type":"string","enum":["ONBOARDED","NEEDS_TO_ONBOARD"],"description":"There are 2 possible values for a carrier relationship status:\n- ONBOARDED: The carrier is onboarded.\n- NEEDS_TO_ONBOARD: The carrier needs to be onboarded, even if they have been onboarded before.","isRequired":true,"uniqueKey":"carrierRelationships.items.[INDEX].oneOf.0.onboardingStatus","typeLabel":"enum\u003cstring>"},"source":{"type":"string","enum":["API","USER"],"uniqueKey":"carrierRelationships.items.[INDEX].oneOf.0.source","typeLabel":"enum\u003cstring>"},"carrierExternalId":{"type":"string","description":"An external identifier for the carrier in your TMS. When provided,\nthis ID is stored on the carrier relationship and can be used to\nconsistently match carriers during load sync.","minLength":1,"maxLength":255,"examples":["GJNTMIIN"],"uniqueKey":"carrierRelationships.items.[INDEX].oneOf.0.carrierExternalId","typeLabel":"string"}},"additionalProperties":true,"uniqueKey":"carrierRelationships.items.[INDEX].oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"carrierRelationships.items.[INDEX].oneOf.1","typeLabel":"null"}],"uniqueKey":"carrierRelationships.items.[INDEX]","typeLabel":"object | null"},"type":"array","isRequired":true,"uniqueKey":"carrierRelationships","typeLabel":"(object | null)[]"}},"required":["carrierRelationships"],"type":"object","additionalProperties":true,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"carrierRelationships":[{"id":"\u003cstring>","organizationId":"\u003cstring>","carrierOrganizationId":"\u003cstring>","status":"ACTIVE","onboardingStatus":"ONBOARDED","source":"API","carrierExternalId":"GJNTMIIN"}]}}},"exampleType":"generated"}},"exampleType":"generated"},"5237c7aa-ed1a-425e-9454-40d7fa48bbec":{"description":"Unauthorized","content":{"application/json":{"schema":{"properties":{"message":{"type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"}},"required":["message"],"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example 1":{"title":"Example 1","value":{"message":"Unauthorized"}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{"03812046-f8dc-4b66-85f8-ee472d21546d":{"apiKey":{"type":"apiKey","in":"header","name":"api-key","scopes":[],"schemeName":"apiKey"}}},"servers":{"680435da-8bd8-44c0-bc61-09cd96d9e52e":{"url":"https://api.cargado.com","description":"The production Cargado API server"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"api-key","scopes":[],"schemeName":"apiKey"},"schema":{"title":"api-key","type":"string","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"apiKey","name":"api-key"}],"title":"apiKey"}]},"originalFileLocation":"openapi.yml"},"subdomain":"cargado","siteName":"Cargado API Docs","title":"Upsert carrier relationships - Cargado API Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-06T16:43:43.372Z","originalFileLocation":"api-reference/carrierrelationship/upsert-carrier-relationships.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Create or update carrier relationships and statuses from your TMS to Cargado. If a carrier is not found, the relationship will be null. Returns the relationships in the same order and length as the input.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Cargado API Docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/cargado/cOUhh33AueWkmX39/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/cargado/cOUhh33AueWkmX39/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/cargado/cOUhh33AueWkmX39/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/cargado/cOUhh33AueWkmX39/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/cargado/cOUhh33AueWkmX39/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/cargado/cOUhh33AueWkmX39/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/cargado/cOUhh33AueWkmX39/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/cargado/cOUhh33AueWkmX39/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/cargado/cOUhh33AueWkmX39/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Upsert carrier relationships - Cargado API Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"Create or update carrier relationships and statuses from your TMS to Cargado. If a carrier is not found, the relationship will be null. Returns the relationships in the same order and length as the input.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Cargado API Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.cargado.com/api-reference/carrierrelationship/upsert-carrier-relationships\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://cargado.mintlify.site/_mintlify/api/og/v2?division=Carrier+Relationships\u0026amp;title=Upsert+carrier+relationships\u0026amp;description=Create+or+update+carrier+relationships+and+statuses+from+your+TMS+to+Cargado.%0AIf+a+carrier+is+not+found%2C+the+relationship+will+be+null.%0AReturns+the+relationship\u0026amp;theme=0bb6f61263cf8b669742e88e\u0026amp;signature=dba4b928a52472652bb8930c4a93c6890d7d4d12ac4dc314236b73b164eadb30\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Upsert carrier relationships - Cargado API Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Create or update carrier relationships and statuses from your TMS to Cargado. If a carrier is not found, the relationship will be null. Returns the relationships in the same order and length as the input.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://cargado.mintlify.site/_mintlify/api/og/v2?division=Carrier+Relationships\u0026amp;title=Upsert+carrier+relationships\u0026amp;description=Create+or+update+carrier+relationships+and+statuses+from+your+TMS+to+Cargado.%0AIf+a+carrier+is+not+found%2C+the+relationship+will+be+null.%0AReturns+the+relationship\u0026amp;theme=0bb6f61263cf8b669742e88e\u0026amp;signature=dba4b928a52472652bb8930c4a93c6890d7d4d12ac4dc314236b73b164eadb30\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/cargado/cOUhh33AueWkmX39/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Cargado API Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#345ED1\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.cargado.com/api-reference/carrierrelationship/upsert-carrier-relationships\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/carrierrelationship/upsert-carrier-relationships.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.cargado.com/#organization\",\"name\":\"Cargado API Docs\",\"url\":\"https://docs.cargado.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/cargado/CLB1kJumWhQp7b97/cargado-logo-azul.png?fit=max\u0026auto=format\u0026n=CLB1kJumWhQp7b97\u0026q=85\u0026s=ce0b66ea21b97607c9feb1078d9e51ba\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.cargado.com#website\",\"name\":\"Cargado API Docs\",\"url\":\"https://docs.cargado.com\",\"publisher\":{\"@id\":\"https://docs.cargado.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.cargado.com/api-reference/carrierrelationship/upsert-carrier-relationships#webpage\",\"url\":\"https://docs.cargado.com/api-reference/carrierrelationship/upsert-carrier-relationships\",\"name\":\"Upsert carrier relationships\",\"description\":\"Create or update carrier relationships and statuses from your TMS to Cargado. If a carrier is not found, the relationship will be null. Returns the relationships in the same order and length as the input.\",\"dateModified\":\"2026-11-06T16:43:43.372Z\",\"isPartOf\":{\"@id\":\"https://docs.cargado.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.cargado.com/api-reference/carrierrelationship/upsert-carrier-relationships#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.cargado.com/api-reference/carrierrelationship/upsert-carrier-relationships#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Carrier Relationships\",\"item\":\"https://docs.cargado.com/api-reference/models/CarrierRelationship\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Upsert carrier relationships\",\"item\":\"https://docs.cargado.com/api-reference/carrierrelationship/upsert-carrier-relationships\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.cargado.com/api-reference/carrierrelationship/upsert-carrier-relationships#apireference\",\"headline\":\"Upsert carrier relationships\",\"name\":\"Upsert carrier relationships\",\"description\":\"Create or update carrier relationships and statuses from your TMS to Cargado. If a carrier is not found, the relationship will be null. Returns the relationships in the same order and length as the input.\",\"url\":\"https://docs.cargado.com/api-reference/carrierrelationship/upsert-carrier-relationships\",\"mainEntityOfPage\":{\"@id\":\"https://docs.cargado.com/api-reference/carrierrelationship/upsert-carrier-relationships#webpage\"},\"dateModified\":\"2026-11-06T16:43:43.372Z\",\"publisher\":{\"@id\":\"https://docs.cargado.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.cargado.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Cargado API Docs\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Cargado API Docs","nav":{"global":null,"tabs":[{"tab":"Guides","icon":"book-open","pages":[{"title":"Guides","href":"/guides/overview"}]},{"tab":"API Reference","icon":"square-terminal","groups":[{"group":"Concepts","pages":[{"title":"Overview","href":"/api-reference/concepts/overview"},{"title":"Authorization and Testing","href":"/api-reference/concepts/auth-and-testing"},{"title":"Versioning","href":"/api-reference/concepts/versioning"},{"title":"OpenAPI","href":"/api-reference/concepts/openapi"},{"title":"Requests and Responses","href":"/api-reference/concepts/requests-and-responses"},{"title":"Identifiers","href":"/api-reference/concepts/identifiers"},{"title":"Pagination","href":"/api-reference/concepts/pagination"},{"title":"Errors","href":"/api-reference/concepts/errors"},{"title":"Metadata","href":"/api-reference/concepts/metadata"}]},{"group":"Loads","pages":[{"title":"Load object","href":"/api-reference/models/load"},{"title":"Sync a load","deprecated":null,"version":null,"openapi":"/openapi.yml post /loads/sync","href":"/api-reference/loads/sync-a-load"}]},{"group":"Rates","pages":[{"title":"RateHistoryLookup object","href":"/api-reference/models/rateHistoryLookup"},{"title":"Lookup rate history","deprecated":null,"version":null,"openapi":"/openapi.yml post /rates/history","href":"/api-reference/rates/lookup-rate-history"}]},{"group":"Market Rate Export","hidden":true,"pages":[{"title":"MarketRateExportRow","href":"/api-reference/models/MarketRateExportRow"},{"title":"Export market rate history","deprecated":null,"version":null,"openapi":"/openapi.yml get /rates/history-exports","href":"/api-reference/rates/export-market-rate-history"}]},{"group":"Border Crossings","pages":[{"title":"Get border crossing recommendations","deprecated":null,"version":null,"openapi":"/openapi.yml post /border-crossings/recommendations","href":"/api-reference/border-crossings/get-border-crossing-recommendations"}]},{"group":"Carrier Relationships","pages":[{"title":"CarrierRelationship object","description":null,"href":"/api-reference/models/CarrierRelationship"},{"title":"Upsert carrier relationships","deprecated":null,"version":null,"openapi":"/openapi.yml post /carrier-relationships/upsert","href":"/api-reference/carrierrelationship/upsert-carrier-relationships"}]},{"group":"Bids","pages":[{"title":"Update a bid","description":"Patch a Bid. Omitted fields are left unchanged; sending null\nexplicitly clears the field. Currently only `externalId` is\npatchable. Returns the updated bid.","deprecated":null,"version":null,"openapi":"/openapi.yml post /bids/update","href":"/api-reference/bids/update-a-bid"}]},{"group":"Users","pages":[{"title":"Update users by email","deprecated":null,"version":null,"openapi":"/openapi.yml post /users/updateByEmail","href":"/api-reference/user/update-users-by-email"}]},{"group":"Teams","pages":[{"title":"Update teams by email","deprecated":null,"version":null,"openapi":"/openapi.yml post /teams/updateByEmail","href":"/api-reference/team/update-teams-by-email"}]},{"group":"Webhooks","pages":[{"title":"Register webhook endpoint","deprecated":null,"version":null,"openapi":"/openapi.yml post /webhooks/endpoint/register","href":"/api-reference/webhooks/register-webhook-endpoint"},{"title":"List webhook endpoints","deprecated":null,"version":null,"openapi":"/openapi.yml get /webhooks/endpoints","href":"/api-reference/webhooks/list-webhook-endpoints"},{"title":"Get webhook endpoint","deprecated":null,"version":null,"openapi":"/openapi.yml get /webhooks/endpoints/{endpointId}","href":"/api-reference/webhooks/get-webhook-endpoint"},{"title":"Update webhook endpoint","deprecated":null,"version":null,"openapi":"/openapi.yml post /webhooks/endpoint/update","href":"/api-reference/webhooks/update-webhook-endpoint"},{"title":"Delete webhook endpoint","deprecated":null,"version":null,"openapi":"/openapi.yml post /webhooks/endpoint/delete","href":"/api-reference/webhooks/delete-webhook-endpoint"},{"title":"Rotate endpoint secret","deprecated":null,"version":null,"openapi":"/openapi.yml post /webhooks/endpoint/rotateSecret","href":"/api-reference/webhooks/rotate-endpoint-secret"},{"title":"Test webhook endpoint","deprecated":null,"version":null,"openapi":"/openapi.yml post /webhooks/endpoint/test","href":"/api-reference/webhooks/test-webhook-endpoint"}]},{"group":"Webhook Events","pages":[{"title":"Event Types","href":"/api-reference/events/index"},{"title":"WebhookEvent object","href":"/api-reference/models/WebhookEvent"},{"title":"Bid events","version":null,"deprecated":null,"openapi":"/openapi.yml webhook bid","href":"/api-reference/bid-events"}]}]}]},"basePath":"","title":"Upsert carrier relationships - Cargado API Docs","buildId":"dpl_8LJbrAiZvr1K98WQNZXCyY5AvT34","deploymentId":"dpl_8LJbrAiZvr1K98WQNZXCyY5AvT34","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-i2a3QZ8E.js","utils-ChLwp8m0.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-DRktVTDc.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-CA2pEs4T.js","snippetPresets-ClQ6XrKD.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-Ct_Lv36y.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-Cn2PYw9e.js","shallow-rkyymjXQ.js","getApiPlaygroundDisplay-BB9vkXtE.js","CodeSnippet-Bm5RU7m1.js","CodeSnippets-BgU9Deuz.js","Page-BUDYNlhG.js","getPastedJson-BD-6NNum.js","icon-8Z6tud2e.js","MethodPill-Tuzr4g3V.js","DuplicateIcon-0ceWFYhN.js","createIcon-FBXow_ST.js","DynamicMarkdown-CD8713Yy.js","SectionHeading-7zgzQbH-.js","axios-vUo_bRtp.js","Markdown-D7Ofw1oz.js","clsx-eKJ4rcii.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-CwjSCXIK.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-9EK5IAXV.js"]}