On write, reference a category by { path } or { uuid }; it must sit under transport/freight/modes/*. Required on create. Reads return the full reference.
Custom modes only: the freight emission-factor dataset the mode draws from (declared per tonne-kilometre or tonne-mile). On write, reference it by { uuid } — required on create, and it must be a freight-unit dataset (a per-km or per-kg dataset is rejected). Reads return the full reference. Built-ins have none.
Stable handle for the mode, equal to the backing product's sku for a custom mode. 1–128 characters of letters, digits, hyphens, dots, or underscores; unique within your company; cannot reuse a built-in code.
Deprecated — use dataset. Backwards-compatible alias for the backing emission-factor dataset; dataset takes precedence when both are sent. Reference it by uuid.
Show child attributes
Response
The created transport mode
How cargo moves on a transport leg. Built-in modes (truck, container-ship, train, air-*, …) are system-curated and work out of the box; create a custom mode only when no built-in fits. A custom mode is backed by a Product[DATASET_CONTAINER], so its code is that product's sku and it also appears under /v1/product — intentional, not a leak.
Stable handle for the mode, equal to the backing product's sku for a custom mode. 1–128 characters of letters, digits, hyphens, dots, or underscores; unique within your company; cannot reuse a built-in code.
On write, reference a category by { path } or { uuid }; it must sit under transport/freight/modes/*. Required on create. Reads return the full reference.
Custom modes only: the freight emission-factor dataset the mode draws from (declared per tonne-kilometre or tonne-mile). On write, reference it by { uuid } — required on create, and it must be a freight-unit dataset (a per-km or per-kg dataset is rejected). Reads return the full reference. Built-ins have none.
Show child attributes
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Variable API","colors":{"primary":"#282624","light":"#E6E3DD","dark":"#282624"},"logo":{"light":"https://app.variable.global/logo/logo-horizontal-onlight.svg","dark":"https://app.variable.global/logo/logo-horizontal-ondark.svg"},"favicon":"https://mintcdn.com/variable/-esaLwUuP4fnFDIg/logo/symbol-white.svg?fit=max\u0026auto=format\u0026n=-esaLwUuP4fnFDIg\u0026q=85\u0026s=d0fcf1de9144c23f8a7d44e3c52638a0","api":{"playground":{"display":"simple"}},"appearance":{"default":"system"},"navbar":{"links":[{"href":"mailto:support@variable.co","label":"Support"}],"primary":{"type":"button","label":"App","href":"https://app.variable.global"}},"footer":{"socials":{"discord":"https://discord.gg/TrGYZW7zPG","linkedin":"https://www.linkedin.com/company/variable-co","x":"https://x.com/variableHQ"}},"styling":{"codeblocks":"system","latex":false},"contextual":{"options":["copy","view","chatgpt","claude"],"display":"header"},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"variable","hasAudioNarration":false,"actualSubdomain":"variable","customDomains":["docs.variable.global"],"gitSource":{"type":"github","owner":"variable-co","repo":"cascade","deployBranch":"main","contentDirectory":"api-documentation","isPrivate":true,"mountPath":"","label":""},"entitlements":{},"buildId":"6af4139bd94bcafc12c0ec33","clientVersion":"0.0.4111","searchFilterCounts":[{"language":"default","tag":"API Reference","count":87},{"language":"default","tag":"Documentation","count":31},{"language":"default","tag":"Elements","count":28},{"language":"default","tag":"Getting started","count":14},{"language":"default","tag":"Changelog","count":10},{"language":"default","tag":"Switch","count":8},{"language":"default","tag":"Concepts","count":8},{"language":"default","tag":"Help articles","count":8},{"language":"default","tag":"PACT API","count":8},{"language":"default","tag":"Activity","count":7}]},"assistantConfig":{},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","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":"editor-metadata","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}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/v1/transport/mode/post","slug":"/api-reference/v1/transport/mode/post","pageMetadata":{"title":"Create Transport Mode","openapi":"POST /v1/transport/mode","description":"Create a custom transport mode","href":"/api-reference/v1/transport/mode/post"},"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 a custom transport mode\"\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{jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];const permission_0=`element:create`;function _createMdxContent(props){const _components={strong:`strong`,..._provideComponents(),...props.components},{Info}=_components;if(!Info)_missingMdxReference(`Info`,true);return _jsxs(Info,{children:[`Requires permission: `,_jsx(_components.strong,{children:permission_0})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{permission_0,default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"codeStyling":"system","config":{},"pageMetadata":{"title":"Create Transport Mode","openapi":"POST /v1/transport/mode","description":"Create a custom transport mode","href":"/api-reference/v1/transport/mode/post"}}},"mdxSourceWithNoJs":null,"noJsSplices":[[408,424,"`element:create`})]}"]]},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"summary":"Create a custom transport mode","security":["dbc64f9d-c7b0-427c-9fff-9ebd51b1a4fe"],"requestBody":"cd1abd07-63d3-4f3a-94e0-01c8e3260f7f","responses":{"201":"31538706-d46f-4672-b456-dd872d88f71e","401":"f5ec1410-235d-4efc-bcf4-63a756fd11c0"},"method":"post","type":"path","servers":["474f6128-2410-41da-aeba-18a544df26e0"],"path":"/v1/transport/mode","baseUrlOptions":["https://app.variable.global/api"],"title":"Create a custom transport mode","description":"Create a custom transport mode","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"required":true,"content":{"application/json":{"schema":{"oneOf":[{"type":"object","description":"Provide the backing freight dataset via `dataset` (preferred). The deprecated `footprint` alias is still accepted; when both are sent, `dataset` wins.","required":["dataset","name","taxonomy"],"properties":{"name":{"type":"string","description":"Required on create.","example":"Electric truck","isRequired":true,"uniqueKey":"oneOf.0.name","typeLabel":"string"},"taxonomy":{"type":"object","description":"On write, reference a category by `{ path }` or `{ uuid }`; it must sit under `transport/freight/modes/*`. Required on create. Reads return the full reference.","properties":{"uuid":{"type":"string","format":"uuid","uniqueKey":"oneOf.0.taxonomy.uuid","typeLabel":"string\u003cuuid>"},"name":{"type":"string","example":"Material","uniqueKey":"oneOf.0.taxonomy.name","typeLabel":"string"},"path":{"type":"string","example":"material","uniqueKey":"oneOf.0.taxonomy.path","typeLabel":"string"}},"isRequired":true,"uniqueKey":"oneOf.0.taxonomy","typeLabel":"object"},"dataset":{"type":"object","description":"Custom modes only: the freight emission-factor dataset the mode draws from (declared per tonne-kilometre or tonne-mile). On write, reference it by `{ uuid }` — required on create, and it must be a freight-unit dataset (a per-km or per-kg dataset is rejected). Reads return the full reference. Built-ins have none.","required":["uuid"],"properties":{"uuid":{"type":"string","format":"uuid","isRequired":true,"uniqueKey":"oneOf.0.dataset.uuid","typeLabel":"string\u003cuuid>"},"name":{"type":"string","example":"Name","uniqueKey":"oneOf.0.dataset.name","typeLabel":"string"},"source":{"description":"The dataset's originating database.","type":"string","example":"ecoinvent 3.8","uniqueKey":"oneOf.0.dataset.source","typeLabel":"string"},"declaredUnit":{"description":"The unit the dataset's per-unit impact is declared in.","type":"string","example":"kg","uniqueKey":"oneOf.0.dataset.declaredUnit","typeLabel":"string"}},"isRequired":true,"uniqueKey":"oneOf.0.dataset","typeLabel":"object"},"code":{"type":"string","description":"Stable handle for the mode, equal to the backing product's `sku` for a custom mode. 1–128 characters of letters, digits, hyphens, dots, or underscores; unique within your company; cannot reuse a built-in code.","example":"electric-truck","uniqueKey":"oneOf.0.code","typeLabel":"string"},"footprint":{"type":"object","writeOnly":true,"deprecated":true,"required":["uuid"],"description":"Deprecated — use `dataset`. Backwards-compatible alias for the backing emission-factor dataset; `dataset` takes precedence when both are sent. Reference it by `uuid`.","properties":{"uuid":{"type":"string","format":"uuid","isRequired":true,"uniqueKey":"oneOf.0.footprint.uuid","typeLabel":"string\u003cuuid>"}},"uniqueKey":"oneOf.0.footprint","typeLabel":"object"}},"uniqueKey":"oneOf.0","typeLabel":"object"},{"type":"object","description":"Provide the backing freight dataset via `dataset` (preferred). The deprecated `footprint` alias is still accepted; when both are sent, `dataset` wins.","required":["footprint","name","taxonomy"],"properties":{"name":{"type":"string","description":"Required on create.","example":"Electric truck","isRequired":true,"uniqueKey":"oneOf.1.name","typeLabel":"string"},"taxonomy":{"type":"object","description":"On write, reference a category by `{ path }` or `{ uuid }`; it must sit under `transport/freight/modes/*`. Required on create. Reads return the full reference.","properties":{"uuid":{"type":"string","format":"uuid","uniqueKey":"oneOf.1.taxonomy.uuid","typeLabel":"string\u003cuuid>"},"name":{"type":"string","example":"Material","uniqueKey":"oneOf.1.taxonomy.name","typeLabel":"string"},"path":{"type":"string","example":"material","uniqueKey":"oneOf.1.taxonomy.path","typeLabel":"string"}},"isRequired":true,"uniqueKey":"oneOf.1.taxonomy","typeLabel":"object"},"footprint":{"type":"object","writeOnly":true,"deprecated":true,"required":["uuid"],"description":"Deprecated — use `dataset`. Backwards-compatible alias for the backing emission-factor dataset; `dataset` takes precedence when both are sent. Reference it by `uuid`.","properties":{"uuid":{"type":"string","format":"uuid","isRequired":true,"uniqueKey":"oneOf.1.footprint.uuid","typeLabel":"string\u003cuuid>"}},"isRequired":true,"uniqueKey":"oneOf.1.footprint","typeLabel":"object"},"code":{"type":"string","description":"Stable handle for the mode, equal to the backing product's `sku` for a custom mode. 1–128 characters of letters, digits, hyphens, dots, or underscores; unique within your company; cannot reuse a built-in code.","example":"electric-truck","uniqueKey":"oneOf.1.code","typeLabel":"string"},"dataset":{"type":"object","description":"Custom modes only: the freight emission-factor dataset the mode draws from (declared per tonne-kilometre or tonne-mile). On write, reference it by `{ uuid }` — required on create, and it must be a freight-unit dataset (a per-km or per-kg dataset is rejected). Reads return the full reference. Built-ins have none.","required":["uuid"],"properties":{"uuid":{"type":"string","format":"uuid","isRequired":true,"uniqueKey":"oneOf.1.dataset.uuid","typeLabel":"string\u003cuuid>"},"name":{"type":"string","example":"Name","uniqueKey":"oneOf.1.dataset.name","typeLabel":"string"},"source":{"description":"The dataset's originating database.","type":"string","example":"ecoinvent 3.8","uniqueKey":"oneOf.1.dataset.source","typeLabel":"string"},"declaredUnit":{"description":"The unit the dataset's per-unit impact is declared in.","type":"string","example":"kg","uniqueKey":"oneOf.1.dataset.declaredUnit","typeLabel":"string"}},"uniqueKey":"oneOf.1.dataset","typeLabel":"object"}},"uniqueKey":"oneOf.1","typeLabel":"object"}],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"name":"Electric truck","taxonomy":{"uuid":"3c90c3cc-0d44-4b50-8888-8dd25736052a","name":"Material","path":"material"},"dataset":{"uuid":"3c90c3cc-0d44-4b50-8888-8dd25736052a","name":"Name","source":"ecoinvent 3.8","declaredUnit":"kg"},"code":"electric-truck"}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"31538706-d46f-4672-b456-dd872d88f71e":{"description":"The created transport mode","content":{"application/json":{"schema":{"type":"object","description":"How cargo moves on a transport leg. Built-in modes (`truck`, `container-ship`, `train`, `air-*`, …) are system-curated and work out of the box; create a custom mode only when no built-in fits. A custom mode is backed by a `Product[DATASET_CONTAINER]`, so its `code` is that product's `sku` and it also appears under `/v1/product` — intentional, not a leak.","properties":{"uuid":{"type":"string","format":"uuid","readOnly":true,"description":"Present only for custom modes; built-ins have none.","uniqueKey":"uuid","typeLabel":"string\u003cuuid>"},"code":{"type":"string","description":"Stable handle for the mode, equal to the backing product's `sku` for a custom mode. 1–128 characters of letters, digits, hyphens, dots, or underscores; unique within your company; cannot reuse a built-in code.","example":"electric-truck","uniqueKey":"code","typeLabel":"string"},"name":{"type":"string","description":"Required on create.","example":"Electric truck","uniqueKey":"name","typeLabel":"string"},"taxonomy":{"type":"object","description":"On write, reference a category by `{ path }` or `{ uuid }`; it must sit under `transport/freight/modes/*`. Required on create. Reads return the full reference.","properties":{"uuid":{"type":"string","format":"uuid","uniqueKey":"taxonomy.uuid","typeLabel":"string\u003cuuid>"},"name":{"type":"string","example":"Material","uniqueKey":"taxonomy.name","typeLabel":"string"},"path":{"type":"string","example":"material","uniqueKey":"taxonomy.path","typeLabel":"string"}},"uniqueKey":"taxonomy","typeLabel":"object"},"dataset":{"type":"object","description":"Custom modes only: the freight emission-factor dataset the mode draws from (declared per tonne-kilometre or tonne-mile). On write, reference it by `{ uuid }` — required on create, and it must be a freight-unit dataset (a per-km or per-kg dataset is rejected). Reads return the full reference. Built-ins have none.","required":["uuid"],"properties":{"uuid":{"type":"string","format":"uuid","isRequired":true,"uniqueKey":"dataset.uuid","typeLabel":"string\u003cuuid>"},"name":{"type":"string","example":"Name","uniqueKey":"dataset.name","typeLabel":"string"},"source":{"description":"The dataset's originating database.","type":"string","example":"ecoinvent 3.8","uniqueKey":"dataset.source","typeLabel":"string"},"declaredUnit":{"description":"The unit the dataset's per-unit impact is declared in.","type":"string","example":"kg","uniqueKey":"dataset.declaredUnit","typeLabel":"string"}},"uniqueKey":"dataset","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"uuid":"3c90c3cc-0d44-4b50-8888-8dd25736052a","code":"electric-truck","name":"Electric truck","taxonomy":{"uuid":"3c90c3cc-0d44-4b50-8888-8dd25736052a","name":"Material","path":"material"},"dataset":{"uuid":"3c90c3cc-0d44-4b50-8888-8dd25736052a","name":"Name","source":"ecoinvent 3.8","declaredUnit":"kg"}}}},"exampleType":"generated"}},"exampleType":"generated"},"f5ec1410-235d-4efc-bcf4-63a756fd11c0":{"description":"ExpiredToken","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","example":"token expired","uniqueKey":"message","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"message":"token expired"}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"dbc64f9d-c7b0-427c-9fff-9ebd51b1a4fe":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","scopes":[],"schemeName":"bearerAuth"}}},"servers":{"474f6128-2410-41da-aeba-18a544df26e0":{"url":"https://app.variable.global/api"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","bearerFormat":"JWT","scopes":[],"schemeName":"bearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Bearer authentication header of the form `Bearer \u003ctoken>`, where `\u003ctoken>` is your auth token.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"}]},"originalFileLocation":"api-reference/openapi.yaml"},"subdomain":"variable","siteName":"Variable API","title":"Create Transport Mode - Variable API","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-06-04T13:34:54.550Z","originalFileLocation":"api-reference/v1/transport/mode/post.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 a custom transport mode\">\u003cmeta data-mint-head name=\"application-name\" content=\"Variable API\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/variable/XSEKUEE_r7PB-_3g/_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/variable/XSEKUEE_r7PB-_3g/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/variable/XSEKUEE_r7PB-_3g/_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/variable/XSEKUEE_r7PB-_3g/_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/variable/XSEKUEE_r7PB-_3g/_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/variable/XSEKUEE_r7PB-_3g/_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/variable/XSEKUEE_r7PB-_3g/_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/variable/XSEKUEE_r7PB-_3g/_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/variable/XSEKUEE_r7PB-_3g/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Create Transport Mode - Variable API\">\u003cmeta data-mint-head property=\"og:description\" content=\"Create a custom transport mode\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Variable API\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.variable.global/api-reference/v1/transport/mode/post\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://variable.mintlify.site/_mintlify/api/og/v2?division=Transport+Mode\u0026amp;title=Create+Transport+Mode\u0026amp;description=Create+a+custom+transport+mode\u0026amp;theme=fd7c09a692b44be01087e493\u0026amp;signature=5fe383fd7f6b62223e74955b69814e9bb553ca1651af149492435b4dbbd65737\">\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=\"Create Transport Mode - Variable API\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Create a custom transport mode\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://variable.mintlify.site/_mintlify/api/og/v2?division=Transport+Mode\u0026amp;title=Create+Transport+Mode\u0026amp;description=Create+a+custom+transport+mode\u0026amp;theme=fd7c09a692b44be01087e493\u0026amp;signature=5fe383fd7f6b62223e74955b69814e9bb553ca1651af149492435b4dbbd65737\">\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/variable/XSEKUEE_r7PB-_3g/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Variable API\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#282624\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.variable.global/api-reference/v1/transport/mode/post\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/v1/transport/mode/post.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.variable.global/#organization\",\"name\":\"Variable API\",\"url\":\"https://docs.variable.global\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://app.variable.global/logo/logo-horizontal-onlight.svg\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.variable.global#website\",\"name\":\"Variable API\",\"url\":\"https://docs.variable.global\",\"publisher\":{\"@id\":\"https://docs.variable.global/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.variable.global/api-reference/v1/transport/mode/post#webpage\",\"url\":\"https://docs.variable.global/api-reference/v1/transport/mode/post\",\"name\":\"Create Transport Mode\",\"description\":\"Create a custom transport mode\",\"dateModified\":\"2026-06-04T13:34:54.550Z\",\"isPartOf\":{\"@id\":\"https://docs.variable.global#website\"},\"breadcrumb\":{\"@id\":\"https://docs.variable.global/api-reference/v1/transport/mode/post#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.variable.global/api-reference/v1/transport/mode/post#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Elements\",\"item\":\"https://docs.variable.global/api-reference/v1/material/list/get\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Transport Mode\",\"item\":\"https://docs.variable.global/api-reference/v1/transport/mode/list/get\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Create Transport Mode\",\"item\":\"https://docs.variable.global/api-reference/v1/transport/mode/post\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.variable.global/api-reference/v1/transport/mode/post#apireference\",\"headline\":\"Create Transport Mode\",\"name\":\"Create Transport Mode\",\"description\":\"Create a custom transport mode\",\"url\":\"https://docs.variable.global/api-reference/v1/transport/mode/post\",\"mainEntityOfPage\":{\"@id\":\"https://docs.variable.global/api-reference/v1/transport/mode/post#webpage\"},\"dateModified\":\"2026-06-04T13:34:54.550Z\",\"publisher\":{\"@id\":\"https://docs.variable.global/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.variable.global#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Variable API\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Variable API\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/v1/transport/mode/post.md","siteName":"Variable API","nav":{"global":null,"tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":"/docs/getting-started/welcome"}]},{"tab":"API Reference","groups":[{"group":"Getting started","pages":[{"title":"REST API","href":"/api-reference/welcome"}]},{"group":"Auth token","pages":[{"title":"API key","href":"/api-reference/auth/token/api-key"},{"title":"Get Token","openapi":"POST /auth/token","href":"/api-reference/auth/token/post"}]},{"group":"Database","pages":[{"title":"Search","openapi":"GET /v1/search","href":"/api-reference/v1/search/list"}]},{"group":"Product","pages":[{"title":"List Products","openapi":"GET /v1/product","href":"/api-reference/v1/product/list/get"},{"title":"Get Product","openapi":"GET /v1/product/{uuid}","href":"/api-reference/v1/product/get"},{"title":"Create Product","openapi":"POST /v1/product","href":"/api-reference/v1/product/post"},{"title":"Edit Product","openapi":"PATCH /v1/product/{uuid}","href":"/api-reference/v1/product/patch"},{"title":"Product Image","openapi":"PATCH /v1/product/{uuid}/image","href":"/api-reference/v1/product/image"},{"title":"Delete Product","openapi":"DELETE /v1/product/{uuid}","href":"/api-reference/v1/product/delete"}]},{"group":"Elements","pages":[{"group":"Material","pages":[{"title":"List Materials","openapi":"GET /v1/material","href":"/api-reference/v1/material/list/get"},{"title":"Get Material","openapi":"GET /v1/material/{uuid}","href":"/api-reference/v1/material/get"},{"title":"Create Material","openapi":"POST /v1/material","href":"/api-reference/v1/material/post"},{"title":"Update Material","openapi":"PATCH /v1/material/{uuid}","href":"/api-reference/v1/material/patch"},{"title":"Material Image","openapi":"PATCH /v1/material/{uuid}/image","href":"/api-reference/v1/material/image"},{"title":"Delete Material","openapi":"DELETE /v1/material/{uuid}","href":"/api-reference/v1/material/delete"}]},{"group":"Transport Lane","pages":[{"title":"List Transport Lanes","openapi":"GET /v1/transport/lane","href":"/api-reference/v1/transport/lane/list/get"},{"title":"Get Transport Lane","openapi":"GET /v1/transport/lane/{uuid}","href":"/api-reference/v1/transport/lane/get"},{"title":"Create Transport Lane","openapi":"POST /v1/transport/lane","href":"/api-reference/v1/transport/lane/post"},{"title":"Update Transport Lane","openapi":"PATCH /v1/transport/lane/{uuid}","href":"/api-reference/v1/transport/lane/patch"},{"title":"Delete Transport Lane","openapi":"DELETE /v1/transport/lane/{uuid}","href":"/api-reference/v1/transport/lane/delete"}]},{"group":"Transport Mode","pages":[{"title":"List Transport Modes","openapi":"GET /v1/transport/mode","href":"/api-reference/v1/transport/mode/list/get"},{"title":"Get Transport Mode","openapi":"GET /v1/transport/mode/{code}","description":"Get a transport mode by code or UUID","href":"/api-reference/v1/transport/mode/get"},{"title":"Create Transport Mode","openapi":"POST /v1/transport/mode","href":"/api-reference/v1/transport/mode/post"},{"title":"Update Transport Mode","openapi":"PATCH /v1/transport/mode/{code}","description":"Update a custom transport mode","href":"/api-reference/v1/transport/mode/patch"},{"title":"Delete Transport Mode","openapi":"DELETE /v1/transport/mode/{code}","href":"/api-reference/v1/transport/mode/delete"}]},{"group":"Energy","pages":[{"title":"List Energy","openapi":"GET /v1/energy","href":"/api-reference/v1/energy/list/get"},{"title":"Get Energy","openapi":"GET /v1/energy/{uuid}","href":"/api-reference/v1/energy/get"},{"title":"Create Energy","openapi":"POST /v1/energy","href":"/api-reference/v1/energy/post"},{"title":"Update Energy","openapi":"PATCH /v1/energy/{uuid}","href":"/api-reference/v1/energy/patch"},{"title":"Energy Image","openapi":"PATCH /v1/energy/{uuid}/image","href":"/api-reference/v1/energy/image"},{"title":"Delete Energy","openapi":"DELETE /v1/energy/{uuid}","href":"/api-reference/v1/energy/delete"}]},{"group":"Process","pages":[{"title":"List Processes","openapi":"GET /v1/process","href":"/api-reference/v1/process/list/get"},{"title":"Get Process","openapi":"GET /v1/process/{uuid}","href":"/api-reference/v1/process/get"},{"title":"Create Process","openapi":"POST /v1/process","href":"/api-reference/v1/process/post"},{"title":"Update Process","openapi":"PATCH /v1/process/{uuid}","href":"/api-reference/v1/process/patch"},{"title":"Process Image","openapi":"PATCH /v1/process/{uuid}/image","href":"/api-reference/v1/process/image"},{"title":"Delete Process","openapi":"DELETE /v1/process/{uuid}","href":"/api-reference/v1/process/delete"}]}]},{"group":"Dataset","pages":[{"title":"List Datasets","openapi":"GET /v1/dataset","href":"/api-reference/v1/dataset/list/get"},{"title":"Get Dataset","openapi":"GET /v1/dataset/{uuid}","href":"/api-reference/v1/dataset/get"},{"title":"Create Dataset","openapi":"POST /v1/dataset","href":"/api-reference/v1/dataset/post"},{"title":"Update Dataset","openapi":"PATCH /v1/dataset/{uuid}","href":"/api-reference/v1/dataset/patch"},{"title":"Set Dataset Impacts","openapi":"PUT /v1/dataset/{uuid}/impacts","href":"/api-reference/v1/dataset/impacts/put"},{"title":"Dataset Image","openapi":"PATCH /v1/dataset/{uuid}/image","href":"/api-reference/v1/dataset/image"},{"title":"Delete Dataset","openapi":"DELETE /v1/dataset/{uuid}","href":"/api-reference/v1/dataset/delete"}]},{"group":"Model","pages":[{"title":"List Inputs","openapi":"GET /v1/model/{uuid}/input","href":"/api-reference/v1/model/inputs/get"},{"title":"Create Input","openapi":"POST /v1/model/{uuid}/input","href":"/api-reference/v1/model/inputs/post"},{"title":"Edit Input","openapi":"PATCH /v1/model/{modelId}/input/{inputId}","href":"/api-reference/v1/model/inputs/patch"},{"title":"Delete Input","openapi":"DELETE /v1/model/{modelId}/input/{inputId}","href":"/api-reference/v1/model/inputs/delete"}]},{"group":"Switch","pages":[{"title":"List Switches","openapi":"GET /v1/switch","href":"/api-reference/v1/switch/list"},{"title":"Get Switch","openapi":"GET /v1/switch/{uuid}","href":"/api-reference/v1/switch/get"},{"title":"Create Switch","openapi":"POST /v1/switch","href":"/api-reference/v1/switch/post"},{"title":"Edit Switch","openapi":"PATCH /v1/switch/{uuid}","href":"/api-reference/v1/switch/patch"},{"title":"Switch Image","openapi":"PATCH /v1/switch/{uuid}/image","href":"/api-reference/v1/switch/image"},{"title":"Delete Switch","openapi":"DELETE /v1/switch/{uuid}","href":"/api-reference/v1/switch/delete"},{"title":"Add Source","openapi":"POST /v1/switch/{switchId}/source/{sourceId}","href":"/api-reference/v1/switch/add-source"},{"title":"Remove Source","openapi":"DELETE /v1/switch/{switchId}/source/{sourceId}","href":"/api-reference/v1/switch/remove-source"}]},{"group":"Geolocation","pages":[{"title":"Geocode an Address","openapi":"GET /v1/geolocation","href":"/api-reference/v1/geolocation/get"},{"title":"Persist a Geolocation","openapi":"POST /v1/geolocation","href":"/api-reference/v1/geolocation/post"}]},{"group":"Location","pages":[{"title":"List Locations","openapi":"GET /v1/location","href":"/api-reference/v1/location/list"},{"title":"Get Location","openapi":"GET /v1/location/{uuid}","href":"/api-reference/v1/location/get"},{"title":"Create Location","openapi":"POST /v1/location","href":"/api-reference/v1/location/post"},{"title":"Update Location","openapi":"PATCH /v1/location/{uuid}","href":"/api-reference/v1/location/patch"},{"title":"Delete Location","openapi":"DELETE /v1/location/{uuid}","href":"/api-reference/v1/location/delete"}]},{"group":"Supplier","pages":[{"title":"List Suppliers","openapi":"GET /v1/supplier","href":"/api-reference/v1/supplier/list/get"},{"title":"Get Supplier","openapi":"GET /v1/supplier/{uuid}","href":"/api-reference/v1/supplier/get"},{"title":"Create Supplier","openapi":"POST /v1/supplier","href":"/api-reference/v1/supplier/post"},{"title":"Edit Supplier","openapi":"PATCH /v1/supplier/{uuid}","href":"/api-reference/v1/supplier/patch"},{"title":"Supplier Image","openapi":"PATCH /v1/supplier/{uuid}/image","href":"/api-reference/v1/supplier/image"},{"title":"Delete Supplier","openapi":"DELETE /v1/supplier/{uuid}","href":"/api-reference/v1/supplier/delete"}]},{"group":"Activity","pages":[{"title":"List Activities","openapi":"GET /v1/activity","href":"/api-reference/v1/activity/list"},{"title":"Get Activity","openapi":"GET /v1/activity/{uuid}","href":"/api-reference/v1/activity/get"},{"title":"Create Activity","openapi":"POST /v1/activity","href":"/api-reference/v1/activity/post"},{"title":"Update Activity","openapi":"PATCH /v1/activity/{uuid}","href":"/api-reference/v1/activity/patch"},{"title":"Delete Activity","openapi":"DELETE /v1/activity/{uuid}","href":"/api-reference/v1/activity/delete"},{"title":"Bulk Activity Creation","openapi":"POST /v1/activity/bulk","href":"/api-reference/v1/activity/bulk"},{"title":"Bulk Activity Deletion","openapi":"POST /v1/activity/bulk/delete","href":"/api-reference/v1/activity/bulk-delete"}]},{"group":"Activity Group","pages":[{"title":"List Activity Groups","openapi":"GET /v1/activity/group","href":"/api-reference/v1/activity-group/list"},{"title":"Get Activity Group","openapi":"GET /v1/activity/group/{uuid}","href":"/api-reference/v1/activity-group/get"},{"title":"Create Activity Group","openapi":"POST /v1/activity/group","href":"/api-reference/v1/activity-group/post"},{"title":"Update Activity Group","openapi":"PATCH /v1/activity/group/{uuid}","href":"/api-reference/v1/activity-group/patch"},{"title":"Delete Activity Group","openapi":"DELETE /v1/activity/group/{uuid}","href":"/api-reference/v1/activity-group/delete"}]},{"group":"Account","pages":[{"title":"List Accounts","openapi":"GET /v1/account","href":"/api-reference/v1/account/get"}]},{"group":"Org","pages":[{"title":"List Orgs","openapi":"GET /v1/org","href":"/api-reference/v1/org/get"}]},{"group":"Scope","pages":[{"title":"List Scopes","openapi":"GET /v1/scope","href":"/api-reference/v1/scope/get"}]},{"group":"Taxonomy","pages":[{"title":"List Taxonomies","openapi":"GET /v1/taxonomy","href":"/api-reference/v1/taxonomy/get"}]},{"group":"Unit","pages":[{"title":"List Units","openapi":"GET /v1/unit","href":"/api-reference/v1/unit/get"}]}]},{"tab":"PACT API","pages":[{"title":"PACT API","href":"/pact-api/welcome"}]},{"tab":"MCP","pages":[{"title":"MCP","href":"/mcp/welcome"}]},{"tab":"Changelog","pages":[{"title":"Changelog","href":"/changelog/2026"}]}]},"basePath":"","title":"Create Transport Mode - Variable API","buildId":"dpl_DqYu5MPb49gWBBbUGgpHQUmCHY3P","deploymentId":"dpl_DqYu5MPb49gWBBbUGgpHQUmCHY3P","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-CybtLBIt.js","utils-BMLj2fvV.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-B6In562Y.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-Dr8Mfhp9.js","snippetPresets-2rmQvMVl.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-WMqJYdZj.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-CJ-MlPHu.js","shallow-dY3TMRCk.js","getApiPlaygroundDisplay-v-1B2bKm.js","CodeSnippet-BDhiTB7U.js","CodeSnippets-D9hnzQcS.js","Page-C4GwDT3_.js","getPastedJson-Th2V45jI.js","icon-BQXch1W9.js","MethodPill-BCqUneP3.js","DuplicateIcon-Q_-bhurZ.js","createIcon-DUjLHRqp.js","DynamicMarkdown-B-f2cqXQ.js","SectionHeading-Da5NsV4v.js","axios-vUo_bRtp.js","Markdown-D13FWkIM.js","clsx-D3Isdib3.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-C-XZBk9h.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink--qIqmmVG.js"]}