Connect can be launched with three different workflows (default, single select, and single select with VIN). Depending on your use case and what information you have about the vehicle ahead of a launching Connect, you may be able to leverage one of these flows for a more streamlined Connect experience.
Default
Authorizing a Single Vehicle
Bypassing the Brand Selection Screen
When you launch Connect, users will be able to select the brand of their vehicle from a list before they enter their credentials and grant access to your application.
Default Smartcar Connect Flow
In some cases you may only want to connect to a single vehicle, even if there are more than one on your user’s connected services account. Smartcar provides two ways for you to do this:
Limits the user’s selection on the permissions screen to a single car if there are multiple vehicles on their connected services account. Notice that check-boxes turn into radio buttons, and the call to action wording changes slightly.
Grant Screen - Single Select without VIN
To enable Single Select, you can pass single_select=true as URL parameter when launching Smartcar Connect.
In addition, if you know the user’s VIN ahead of time you can pass this over to us in the connect URL. In doing so:
Smartcar decodes the VIN to get the brand and send the user to the appropriate login form directly
If the owner has more than one vehicle on their connected services account, we’ll only show the VIN that was passed to us on the permission grant screen.
Single Select /w VIN: Preamble > Brand’s Login Form > Grant Screen - no vehicle choice
To enable Single Select with VIN, you can pass single_select=true and single_select_vin=:vin as URL parameters when launching Smartcar Connect.
Instead of having users go through the brand selector screen, you can pass us a brand in the Connect URL and send the user to the appropriate login form directly.
Brand Select
To enable Brand Select, you can pass make as URL parameter when launching Connect. For example, make=TESLA
Was this page helpful?
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"smartcar","colors":{"primary":"#3E577D","light":"#3E577D","dark":"#3E577D"},"logo":{"light":"https://mintcdn.com/smartcar-docs/YqcNJdgEDgXpXtEG/logo/light.png?fit=max\u0026auto=format\u0026n=YqcNJdgEDgXpXtEG\u0026q=85\u0026s=c8947958467fe403a12f769afada9b53","dark":"https://mintcdn.com/smartcar-docs/YqcNJdgEDgXpXtEG/logo/dark.png?fit=max\u0026auto=format\u0026n=YqcNJdgEDgXpXtEG\u0026q=85\u0026s=af6b6bcabc2fe0bc4bbd976ee5b71a36","href":"https://smartcar.com/"},"favicon":"https://mintcdn.com/smartcar-docs/NtuX9OSBHLxFwWIa/favicon.png?fit=max\u0026auto=format\u0026n=NtuX9OSBHLxFwWIa\u0026q=85\u0026s=de01fc4e56d5368d441e322ac50e3f81","api":{"playground":{"display":"interactive","proxy":false},"examples":{"prefill":true}},"navbar":{"links":[{"href":"https://dashboard.smartcar.com/login/","label":"Log in"},{"href":"https://dashboard.smartcar.com/signup/","label":"Sign up"}],"primary":{"type":"button","label":"Request a Demo","href":"https://smartcar.com/pricing/"}},"footer":{"socials":{"linkedin":"https://www.linkedin.com/company/smartcar","github":"https://github.com/smartcar","facebook":"https://www.facebook.com/smartcar","instagram":"https://www.instagram.com/mysmartcar","x":"https://x.com/mysmartcar"},"links":[{"header":"Product","items":[{"label":"Vehicle signals","href":"https://smartcar.com/product/signals"},{"label":"Vehicle commands","href":"https://smartcar.com/product/commands"},{"label":"Compatible brands","href":"https://smartcar.com/product/compatible-vehicles"},{"label":"Connect","href":"https://smartcar.com/product/connect"},{"label":"Integrations","href":"https://smartcar.com/product/integrations"},{"label":"Global coverage","href":"https://smartcar.com/global"},{"label":"Teams","href":"https://smartcar.com/product/teams"},{"label":"Vehicle management","href":"https://smartcar.com/product/vehicle-management"},{"label":"Analytics","href":"https://smartcar.com/product/analytics"},{"label":"Pricing","href":"https://smartcar.com/pricing"},{"label":"Status","href":"https://status.smartcar.com/"},{"label":"Brand reliability","href":"https://brandreliability.smartcar.com/"},{"label":"Data security","href":"https://smartcar.com/data-security"}]},{"header":"Energy Solutions","items":[{"label":"DERMs","href":"https://smartcar.com/industries/derms-software"},{"label":"Virtual Power Plants (VPPs)","href":"https://smartcar.com/industries/virtual-power-plant"},{"label":"Utilities","href":"https://smartcar.com/utilities"},{"label":"Home energy management","href":"https://smartcar.com/industries/home-energy-management"},{"label":"EV charging networks","href":"https://smartcar.com/industries/ev-charging"},{"label":"Charge point operators","href":"https://smartcar.com/industries/charge-point-operator"},{"label":"E-mobility service providers","href":"https://smartcar.com/industries/e-mobility-service-providers"}]},{"header":"Solutions","items":[{"label":"Repair and maintenance","href":"https://smartcar.com/industries/repair-maintenance"},{"label":"Autocare software","href":"https://smartcar.com/industries/autocare-software"},{"label":"Auto dealership","href":"https://smartcar.com/industries/auto-dealership-software"},{"label":"Roadside assistance","href":"https://smartcar.com/industries/roadside-assistance"},{"label":"Vehicle history reports","href":"https://smartcar.com/industries/vehicle-history-reports"},{"label":"Small fleet management","href":"https://smartcar.com/industries/fleet-management"},{"label":"Car subscription service","href":"https://smartcar.com/industries/car-subscription-services"},{"label":"Car sharing","href":"https://smartcar.com/industries/car-sharing"},{"label":"Ride hailing","href":"https://smartcar.com/industries/ride-sharing"},{"label":"Car rentals","href":"https://smartcar.com/industries/car-rental"},{"label":"Auto insurance","href":"https://smartcar.com/industries/auto-insurance"},{"label":"Warranty software","href":"https://smartcar.com/industries/warranty-management-software"},{"label":"Road usage charge","href":"https://smartcar.com/industries/road-usage-charge"}]},{"header":"Resources","items":[{"label":"Customers","href":"https://smartcar.com/customers"},{"label":"Blog","href":"https://smartcar.com/blog"},{"label":"For vehicle owners","href":"https://smartcar.com/vehicle-owners"},{"label":"For automakers","href":"https://smartcar.com/automakers"},{"label":"Terms of service","href":"https://smartcar.com/legal/terms"},{"label":"Privacy policy","href":"https://smartcar.com/legal/privacy"},{"label":"End user privacy policy","href":"https://smartcar.com/legal/end-user-privacy"},{"label":"Acceptable use","href":"https://smartcar.com/legal/acceptable-use"},{"label":"Data processing","href":"https://smartcar.com/legal/dpa"},{"label":"Vulnerability disclosure program","href":"https://smartcar.com/vdp"},{"label":"mySmartcar","href":"https://my.smartcar.com"}]}]},"search":{"prompt":"✨ Ask Smartcar"},"integrations":{"koala":{"publicApiKey":"pk_3a64cc4d12d7b978edffae0afd143df5b291"},"ga4":{"measurementId":"G-QHNXS91VZC"}},"styling":{"latex":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"smartcar-docs","hasAudioNarration":false,"actualSubdomain":"smartcar-docs","customDomains":["smartcar.com"],"gitSource":{"type":"github","owner":"smartcar","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6adbe250d05dd52d1c87e7c2","collectionId":"4e81bf89-a564-4084-82d5-a2f1a4b41ad6","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6adbe250d05dd52d1c87e7c2"},"feedback":{"thumbs":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"REMOVE_BRANDING":{"status":"ENABLED"},"CONTEXTUAL_FEEDBACK":{"status":"ENABLED"},"CODE_SNIPPET_FEEDBACK":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6adbe250d05dd52d1c87e7c2","clientVersion":"0.0.4044","searchFilterCounts":[{"language":"default","tag":"API \u0026 Integrations Reference","count":147},{"language":"default","tag":"API 2.0 Reference (Legacy)","count":64},{"language":"default","tag":"Vehicle Data","count":48},{"language":"default","tag":"Help Center","count":36},{"language":"default","tag":"Getting Started","count":28},{"language":"default","tag":"Make Specific","count":27},{"language":"default","tag":"Introduction","count":26},{"language":"default","tag":"Tesla","count":26},{"language":"default","tag":"Webhooks","count":25},{"language":"default","tag":"Errors","count":20}]},"assistantConfig":{},"basePath":"/docs","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":".hsfc-Form .hsfc-FieldLabel span:is(.dark *),.hsfc-Form .hsfc-RichText p:is(.dark *),.hsfc-PostSubmit .hsfc-RichText p:is(.dark *){color:#a0a1a2}.dark\\:text-primary-light:is(.dark *){color:#378ff0}.hsfc-FormWrapper .hsfc-Step .hsfc-Step__Content{padding:0 10px 20px;background-color:rgb(113 113 122/10%);border-radius:10px}.hsfc-FormWrapper .hsfc-Step .hsfc-Step__Content .hsfc-Row{margin-bottom:4px}.hsfc-FormWrapper .hsfc-Step .hsfc-Step__Content .hsfc-NavigationRow{margin-top:4px}.osano-cm-powered-by__link.osano-cm-link,.osano-cm-window__widget{display:none}.osano-cm-close svg{stroke:#fff!important}.osano-cm-dialog{font-family:Inter,ui-sans-serif,system-ui,sans-serif;border-radius:12px;box-shadow:0 -4px 24px rgba(0,0,0,.08);padding:20px 24px;background-color:#fff;color:#374151;border-top:1px solid #e5e7eb}.osano-cm-dialog__title{font-size:.9rem;font-weight:600;color:#111827;margin-bottom:6px}.osano-cm-dialog__description,.osano-cm-message{font-size:.825rem;color:#6b7280;line-height:1.5}.osano-cm-storage-policy{font-size:.825rem;line-height:1.5}.osano-cm-message:is(.dark *){color:#fff}.osano-cm-info a,.osano-cm-storage-policy{color:#3e577d}.osano-cm-button{font-family:Inter,ui-sans-serif,system-ui,sans-serif;font-size:.825rem;font-weight:500;border-radius:6px;padding:7px 14px;transition:opacity .15s ease}.osano-cm-button:hover{opacity:.85}.osano-cm-accept,.osano-cm-button--save,.osano-cm-save{background-color:#3e577d!important;color:#fff!important;border:0!important}.osano-cm-deny,.osano-cm-manage{background-color:transparent!important;color:#3e577d!important;border:1px solid #3e577d!important}.osano-cm-manage{border:0!important;padding-left:4px!important;padding-right:4px!important;text-decoration:underline;text-underline-offset:2px}.osano-cm-dialog:is(.dark *){background-color:#1f2937;color:#d1d5db;border-top-color:#374151;box-shadow:0 -4px 24px rgba(0,0,0,.3)}.osano-cm-dialog__title:is(.dark *){color:#f9fafb}.osano-cm-dialog__description:is(.dark *){color:#9ca3af}.osano-cm-info a:is(.dark *),.osano-cm-storage-policy:is(.dark *){color:#93b4d8}.osano-cm-deny:is(.dark *){color:#93b4d8!important;border-color:#93b4d8!important}.osano-cm-manage:is(.dark *){color:#93b4d8!important}.osano-cm-info{font-family:Inter,ui-sans-serif,system-ui,sans-serif;border-radius:0;box-shadow:0 -4px 24px rgba(0,0,0,.08);background-color:#fff;color:#374151;border-top:1px solid #e5e7eb;min-width:480px;overflow-y:visible}.osano-cm-header,.osano-cm-info-dialog-header{background-color:#fff!important}.osano-cm-info__title{font-size:.9rem;font-weight:600;color:#111827}.osano-cm-info__description,.osano-cm-info__list{font-size:.825rem;color:#6b7280;line-height:1.5}.osano-cm-toggle__switch{background-color:#e5e7eb!important;border-color:#3e577d!important}.osano-cm-toggle__input:checked+.osano-cm-toggle__switch{background-color:#3e577d!important;border-color:#3e577d!important}.osano-cm-toggle__input:checked+.osano-cm-toggle__switch::after{background-color:#e5e7eb!important}.osano-cm-info:is(.dark *){background-color:#1f2937;color:#d1d5db;border-top-color:#374151;box-shadow:0 -4px 24px rgba(0,0,0,.3)}.osano-cm-header:is(.dark *),.osano-cm-info-dialog-header:is(.dark *){background-color:#1f2937!important}.osano-cm-info__title:is(.dark *){color:#f9fafb}.osano-cm-info__description:is(.dark *),.osano-cm-info__list:is(.dark *){color:#9ca3af}.osano-cm-toggle__switch:is(.dark *){background-color:#374151!important}"}],"page":{"pagePath":"connect/advanced-config/flows","slug":"/connect/advanced-config/flows","pageMetadata":{"title":"Connect Flows","description":"Connect can be launched with three different workflows (default, single select, and single select with VIN). Depending on your use case and what information you have about the vehicle ahead of a launching Connect, you may be able to leverage one of these flows for a more streamlined Connect experience.","href":"/connect/advanced-config/flows"},"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: \"Connect can be launched with three different workflows (default, single select, and single select with VIN). Depending on your use case and what information you have about the vehicle ahead of a launching Connect, you may be able to leverage one of these flows for a more streamlined Connect experience.\"\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];function _createMdxContent(props){const _components={code:`code`,li:`li`,ol:`ol`,p:`p`,ul:`ul`,..._provideComponents(),...props.components},{Frame,Heading,OptimizedImage,Tab,Tabs}=_components;if(!Frame)_missingMdxReference(`Frame`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!OptimizedImage)_missingMdxReference(`OptimizedImage`,true);if(!Tab)_missingMdxReference(`Tab`,true);if(!Tabs)_missingMdxReference(`Tabs`,true);return _jsxs(Tabs,{children:[_jsxs(Tab,{title:`Default`,defaultOpen:`true`,id:`default`,children:[_jsx(_components.p,{children:`When you launch Connect, users will be able to select the brand of their vehicle from a list before they enter their credentials and grant access to your application.`}),_jsx(Frame,{caption:`Default Smartcar Connect Flow`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/smartcar-docs/klvdxjd2EpHsqsG2/images/default-connect-flow.png?fit=max\u0026auto=format\u0026n=klvdxjd2EpHsqsG2\u0026q=85\u0026s=c2cd906b5876221be223249b7ba0c8ef`,\"data-og-width\":`3782`,width:`3782`,\"data-og-height\":`1942`,height:`1942`,\"data-path\":`images/default-connect-flow.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/smartcar-docs/klvdxjd2EpHsqsG2/images/default-connect-flow.png?w=280\u0026fit=max\u0026auto=format\u0026n=klvdxjd2EpHsqsG2\u0026q=85\u0026s=57674aaf78d5e84ec7acf3a3e987101d 280w, https://mintcdn.com/smartcar-docs/klvdxjd2EpHsqsG2/images/default-connect-flow.png?w=560\u0026fit=max\u0026auto=format\u0026n=klvdxjd2EpHsqsG2\u0026q=85\u0026s=3009ebe305a4b1cbe0559c525f3b8bde 560w, https://mintcdn.com/smartcar-docs/klvdxjd2EpHsqsG2/images/default-connect-flow.png?w=840\u0026fit=max\u0026auto=format\u0026n=klvdxjd2EpHsqsG2\u0026q=85\u0026s=2d05dffc04980fbac98e83da00a09218 840w, https://mintcdn.com/smartcar-docs/klvdxjd2EpHsqsG2/images/default-connect-flow.png?w=1100\u0026fit=max\u0026auto=format\u0026n=klvdxjd2EpHsqsG2\u0026q=85\u0026s=4c7f94b577ddffff375afe841fe094b5 1100w, https://mintcdn.com/smartcar-docs/klvdxjd2EpHsqsG2/images/default-connect-flow.png?w=1650\u0026fit=max\u0026auto=format\u0026n=klvdxjd2EpHsqsG2\u0026q=85\u0026s=dc9a2de37a38d85955d176e3eea6a968 1650w, https://mintcdn.com/smartcar-docs/klvdxjd2EpHsqsG2/images/default-connect-flow.png?w=2500\u0026fit=max\u0026auto=format\u0026n=klvdxjd2EpHsqsG2\u0026q=85\u0026s=bfc194d9d2adabe6d5b0d2478dbe5954 2500w`})})]}),_jsxs(Tab,{title:`Authorizing a Single Vehicle`,id:`authorizing-a-single-vehicle`,\"data-child-heading-ids\":`[\"single-select\",\"single-select-with-vin\"]`,children:[_jsx(_components.p,{children:`In some cases you may only want to connect to a single vehicle, even if there are more than one on your user’s connected services account. Smartcar provides two ways for you to do this:`}),_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Single Select`}),`\n`,_jsx(_components.li,{children:`Single Select with VIN`}),`\n`]}),_jsx(Heading,{level:`3`,id:`single-select`,children:`Single Select`}),_jsx(_components.p,{children:`Limits the user’s selection on the permissions screen to a single car if there are multiple vehicles on their connected services account. Notice that check-boxes turn into radio buttons, and the call to action wording changes slightly.`}),_jsx(Frame,{caption:`Grant Screen - Single Select without VIN`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/smartcar-docs/YqcNJdgEDgXpXtEG/images/single-selection.png?fit=max\u0026auto=format\u0026n=YqcNJdgEDgXpXtEG\u0026q=85\u0026s=c0ea2b982a0c93a3ea88f57b73e22041`,\"data-og-width\":`863`,width:`863`,\"data-og-height\":`1867`,height:`1867`,\"data-path\":`images/single-selection.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/smartcar-docs/YqcNJdgEDgXpXtEG/images/single-selection.png?w=280\u0026fit=max\u0026auto=format\u0026n=YqcNJdgEDgXpXtEG\u0026q=85\u0026s=a3620d3ee18252ab2ca59ff4e87fe53a 280w, https://mintcdn.com/smartcar-docs/YqcNJdgEDgXpXtEG/images/single-selection.png?w=560\u0026fit=max\u0026auto=format\u0026n=YqcNJdgEDgXpXtEG\u0026q=85\u0026s=ebc0df1e6ee5fbb05d56a42e0b326958 560w, https://mintcdn.com/smartcar-docs/YqcNJdgEDgXpXtEG/images/single-selection.png?w=840\u0026fit=max\u0026auto=format\u0026n=YqcNJdgEDgXpXtEG\u0026q=85\u0026s=7976153b366c422d046291d2783b1846 840w, https://mintcdn.com/smartcar-docs/YqcNJdgEDgXpXtEG/images/single-selection.png?w=1100\u0026fit=max\u0026auto=format\u0026n=YqcNJdgEDgXpXtEG\u0026q=85\u0026s=ef5334216cccf2e27d08afee2e632dd2 1100w, https://mintcdn.com/smartcar-docs/YqcNJdgEDgXpXtEG/images/single-selection.png?w=1650\u0026fit=max\u0026auto=format\u0026n=YqcNJdgEDgXpXtEG\u0026q=85\u0026s=bd9266503099f1caba742b83d7c9bb94 1650w, https://mintcdn.com/smartcar-docs/YqcNJdgEDgXpXtEG/images/single-selection.png?w=2500\u0026fit=max\u0026auto=format\u0026n=YqcNJdgEDgXpXtEG\u0026q=85\u0026s=e3e1effe1e6566d0962278db31c4d410 2500w`})}),_jsxs(_components.p,{children:[`To enable Single Select, you can pass `,_jsx(_components.code,{children:`single_select=true`}),` as URL parameter when launching Smartcar Connect.`]}),_jsx(Heading,{level:`3`,id:`single-select-with-vin`,children:`Single Select with VIN`}),_jsx(_components.p,{children:`In addition, if you know the user’s VIN ahead of time you can pass this over to us in the connect URL. In doing so:`}),_jsxs(_components.ol,{children:[`\n`,_jsx(_components.li,{children:`Smartcar decodes the VIN to get the brand and send the user to the appropriate login form directly`}),`\n`,_jsx(_components.li,{children:`If the owner has more than one vehicle on their connected services account, we’ll only show the VIN that was passed to us on the permission grant screen.`}),`\n`]}),_jsx(Frame,{caption:`Single Select /w VIN: Preamble > Brand’s Login Form > Grant Screen - no vehicle choice`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/smartcar-docs/YqcNJdgEDgXpXtEG/images/single-select.png?fit=max\u0026auto=format\u0026n=YqcNJdgEDgXpXtEG\u0026q=85\u0026s=f27cd7030d595ec7c56f9a3dd537cfbc`,\"data-og-width\":`2822`,width:`2822`,\"data-og-height\":`1946`,height:`1946`,\"data-path\":`images/single-select.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/smartcar-docs/YqcNJdgEDgXpXtEG/images/single-select.png?w=280\u0026fit=max\u0026auto=format\u0026n=YqcNJdgEDgXpXtEG\u0026q=85\u0026s=2bed927de3ccb4ffcf2b97bd0451cc0a 280w, https://mintcdn.com/smartcar-docs/YqcNJdgEDgXpXtEG/images/single-select.png?w=560\u0026fit=max\u0026auto=format\u0026n=YqcNJdgEDgXpXtEG\u0026q=85\u0026s=884a0ea1717068601a7a1ce8e8b6d0c0 560w, https://mintcdn.com/smartcar-docs/YqcNJdgEDgXpXtEG/images/single-select.png?w=840\u0026fit=max\u0026auto=format\u0026n=YqcNJdgEDgXpXtEG\u0026q=85\u0026s=c3adb6503c4c610b99c9cae241e5f65f 840w, https://mintcdn.com/smartcar-docs/YqcNJdgEDgXpXtEG/images/single-select.png?w=1100\u0026fit=max\u0026auto=format\u0026n=YqcNJdgEDgXpXtEG\u0026q=85\u0026s=43e2c5bab7ff3861f6aee498b2ae81b7 1100w, https://mintcdn.com/smartcar-docs/YqcNJdgEDgXpXtEG/images/single-select.png?w=1650\u0026fit=max\u0026auto=format\u0026n=YqcNJdgEDgXpXtEG\u0026q=85\u0026s=428c81f882fb76a74c9fbebf816fa50f 1650w, https://mintcdn.com/smartcar-docs/YqcNJdgEDgXpXtEG/images/single-select.png?w=2500\u0026fit=max\u0026auto=format\u0026n=YqcNJdgEDgXpXtEG\u0026q=85\u0026s=34424df262f891adcb7281f89fbfc220 2500w`})}),_jsxs(_components.p,{children:[`To enable Single Select with VIN, you can pass `,_jsx(_components.code,{children:`single_select=true`}),` and `,_jsx(_components.code,{children:`single_select_vin=:vin`}),` as URL parameters when launching Smartcar Connect.`]})]}),_jsxs(Tab,{title:`Bypassing the Brand Selection Screen`,id:`bypassing-the-brand-selection-screen`,\"data-child-heading-ids\":`[\"brand-select\"]`,children:[_jsx(Heading,{level:`3`,id:`brand-select`,children:`Brand Select`}),_jsx(_components.p,{children:`Instead of having users go through the brand selector screen, you can pass us a brand in the Connect URL and send the user to the appropriate login form directly.`}),_jsx(Frame,{caption:`Brand Select`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/smartcar-docs/NtuX9OSBHLxFwWIa/images/brand-select.png?fit=max\u0026auto=format\u0026n=NtuX9OSBHLxFwWIa\u0026q=85\u0026s=8c25487faed02ad5dfba4e3a853a8ad0`,\"data-og-width\":`2822`,width:`2822`,\"data-og-height\":`1946`,height:`1946`,\"data-path\":`images/brand-select.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/smartcar-docs/NtuX9OSBHLxFwWIa/images/brand-select.png?w=280\u0026fit=max\u0026auto=format\u0026n=NtuX9OSBHLxFwWIa\u0026q=85\u0026s=60a46248faa5b363388cedaee53ef617 280w, https://mintcdn.com/smartcar-docs/NtuX9OSBHLxFwWIa/images/brand-select.png?w=560\u0026fit=max\u0026auto=format\u0026n=NtuX9OSBHLxFwWIa\u0026q=85\u0026s=f5c68e202d9fa45e93cfbc145acad703 560w, https://mintcdn.com/smartcar-docs/NtuX9OSBHLxFwWIa/images/brand-select.png?w=840\u0026fit=max\u0026auto=format\u0026n=NtuX9OSBHLxFwWIa\u0026q=85\u0026s=6b43c15fd66151bcb7bfbce57bbfb923 840w, https://mintcdn.com/smartcar-docs/NtuX9OSBHLxFwWIa/images/brand-select.png?w=1100\u0026fit=max\u0026auto=format\u0026n=NtuX9OSBHLxFwWIa\u0026q=85\u0026s=c938d1dd783ddd36b1bcee393fd95769 1100w, https://mintcdn.com/smartcar-docs/NtuX9OSBHLxFwWIa/images/brand-select.png?w=1650\u0026fit=max\u0026auto=format\u0026n=NtuX9OSBHLxFwWIa\u0026q=85\u0026s=8a255483bf29d22f3aaaea0157d64cf3 1650w, https://mintcdn.com/smartcar-docs/NtuX9OSBHLxFwWIa/images/brand-select.png?w=2500\u0026fit=max\u0026auto=format\u0026n=NtuX9OSBHLxFwWIa\u0026q=85\u0026s=3b1a65832e403075d321921f96c928a9 2500w`})}),_jsxs(_components.p,{children:[`To enable Brand Select, you can pass `,_jsx(_components.code,{children:`make`}),` as URL parameter when launching Connect. For example, `,_jsx(_components.code,{children:`make=TESLA`})]})]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{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":{"config":{},"pageMetadata":{"title":"Connect Flows","description":"Connect can be launched with three different workflows (default, single select, and single select with VIN). Depending on your use case and what information you have about the vehicle ahead of a launching Connect, you may be able to leverage one of these flows for a more streamlined Connect experience.","href":"/connect/advanced-config/flows"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Single Select","slug":"single-select","depth":3,"children":[],"tabId":"authorizing-a-single-vehicle"},{"title":"Single Select with VIN","slug":"single-select-with-vin","depth":3,"children":[],"tabId":"authorizing-a-single-vehicle"},{"title":"Brand Select","slug":"brand-select","depth":3,"children":[],"tabId":"bypassing-the-brand-selection-screen"}],"codeExamples":{}},"jsLinks":["/docs/_mintlify/custom/smartcar-docs/079ff91450d16dd6/osano.js"],"subdomain":"smartcar-docs","siteName":"smartcar","title":"Connect Flows - smartcar","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-01-27T19:00:58.912Z","originalFileLocation":"connect/advanced-config/flows.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=\"Connect can be launched with three different workflows (default, single select, and single select with VIN). Depending on your use case and what information you have about the vehicle ahead of a launching Connect, you may be able to leverage one of these flows for a more streamlined Connect experience.\">\u003cmeta data-mint-head name=\"application-name\" content=\"smartcar\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/smartcar-docs/mm2dBjYiMlWQ-TlV/_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=\"/docs/mintlify-assets/_mintlify/favicons/smartcar-docs/mm2dBjYiMlWQ-TlV/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/smartcar-docs/mm2dBjYiMlWQ-TlV/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/smartcar-docs/mm2dBjYiMlWQ-TlV/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/smartcar-docs/mm2dBjYiMlWQ-TlV/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/smartcar-docs/mm2dBjYiMlWQ-TlV/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/smartcar-docs/mm2dBjYiMlWQ-TlV/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/smartcar-docs/mm2dBjYiMlWQ-TlV/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/smartcar-docs/mm2dBjYiMlWQ-TlV/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Connect Flows - smartcar\">\u003cmeta data-mint-head property=\"og:description\" content=\"Connect can be launched with three different workflows (default, single select, and single select with VIN). Depending on your use case and what information you have about the vehicle ahead of a launching Connect, you may be able to leverage one of these flows for a more streamlined Connect experience.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"smartcar\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://smartcar.com/docs/connect/advanced-config/flows\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://smartcar-docs.mintlify.app/_mintlify/api/og/v2?division=Advanced+Configuration\u0026amp;title=Connect+Flows\u0026amp;description=Connect+can+be+launched+with+three+different+workflows+%28default%2C+single+select%2C+and+single+select+with+VIN%29.+Depending+on+your+use+case+and+what+information+you\u0026amp;theme=254a1f83924c8d0c1b4b5b15\u0026amp;signature=68298b77e26c71aab53aec9419f610d476b656ecb0b2c8cf4be7fe0923c7ae75\">\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=\"Connect Flows - smartcar\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Connect can be launched with three different workflows (default, single select, and single select with VIN). Depending on your use case and what information you have about the vehicle ahead of a launching Connect, you may be able to leverage one of these flows for a more streamlined Connect experience.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://smartcar-docs.mintlify.app/_mintlify/api/og/v2?division=Advanced+Configuration\u0026amp;title=Connect+Flows\u0026amp;description=Connect+can+be+launched+with+three+different+workflows+%28default%2C+single+select%2C+and+single+select+with+VIN%29.+Depending+on+your+use+case+and+what+information+you\u0026amp;theme=254a1f83924c8d0c1b4b5b15\u0026amp;signature=68298b77e26c71aab53aec9419f610d476b656ecb0b2c8cf4be7fe0923c7ae75\">\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=\"/docs/mintlify-assets/_mintlify/favicons/smartcar-docs/mm2dBjYiMlWQ-TlV/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"smartcar\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#3E577D\">\u003clink data-mint-head rel=\"canonical\" href=\"https://smartcar.com/docs/connect/advanced-config/flows\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/docs/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/docs/connect/advanced-config/flows.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://smartcar.com/#organization\",\"name\":\"smartcar\",\"url\":\"https://smartcar.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/smartcar-docs/YqcNJdgEDgXpXtEG/logo/light.png?fit=max\u0026auto=format\u0026n=YqcNJdgEDgXpXtEG\u0026q=85\u0026s=c8947958467fe403a12f769afada9b53\"}},{\"@type\":\"WebSite\",\"@id\":\"https://smartcar.com/docs#website\",\"name\":\"smartcar\",\"url\":\"https://smartcar.com/docs\",\"publisher\":{\"@id\":\"https://smartcar.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://smartcar.com/docs/connect/advanced-config/flows#webpage\",\"url\":\"https://smartcar.com/docs/connect/advanced-config/flows\",\"name\":\"Connect Flows\",\"description\":\"Connect can be launched with three different workflows (default, single select, and single select with VIN). Depending on your use case and what information you have about the vehicle ahead of a launching Connect, you may be able to leverage one of these flows for a more streamlined Connect experience.\",\"dateModified\":\"2026-01-27T19:00:58.912Z\",\"isPartOf\":{\"@id\":\"https://smartcar.com/docs#website\"},\"breadcrumb\":{\"@id\":\"https://smartcar.com/docs/connect/advanced-config/flows#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://smartcar.com/docs/connect/advanced-config/flows#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"smartcar\",\"item\":\"https://smartcar.com/docs\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Connect Flows\",\"item\":\"https://smartcar.com/docs/connect/advanced-config/flows\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://smartcar.com/docs/connect/advanced-config/flows#article\",\"headline\":\"Connect Flows\",\"name\":\"Connect Flows\",\"description\":\"Connect can be launched with three different workflows (default, single select, and single select with VIN). Depending on your use case and what information you have about the vehicle ahead of a launching Connect, you may be able to leverage one of these flows for a more streamlined Connect experience.\",\"url\":\"https://smartcar.com/docs/connect/advanced-config/flows\",\"mainEntityOfPage\":{\"@id\":\"https://smartcar.com/docs/connect/advanced-config/flows#webpage\"},\"dateModified\":\"2026-01-27T19:00:58.912Z\",\"publisher\":{\"@id\":\"https://smartcar.com/#organization\"},\"isPartOf\":{\"@id\":\"https://smartcar.com/docs#website\"}}]}\u003c/script>","siteName":"smartcar","nav":{"global":null,"tabs":[{"tab":"Getting Started","pages":[{"title":"Getting Started","href":"/getting-started/introduction"}]},{"tab":"Connecting Vehicles","groups":[{"group":"Introduction","pages":[{"title":"What is Connect?","href":"/connect/what-is-connect"},{"title":"SDKs for Connect","sidebarTitle":"SDKs","href":"/connect/connect-sdks"}]},{"group":"Launching Connect","pages":[{"title":"Dashboard Configuration","href":"/connect/dashboard-config"},{"title":"Build the Connect URL","href":"/connect/redirect-to-connect"},{"title":"Handle the Response","href":"/connect/handle-the-response"}]},{"group":"Reauthentication","pages":[{"title":"Redirect to Connect","href":"/connect/re-auth/redirect-to-connect"},{"title":"Handle the Response","href":"/connect/re-auth/handle-response"},{"title":"OEM Migrations and Re-authentication","sidebarTitle":"OEM Migrations","href":"/connect/re-auth/oem-migrations"}]},{"group":"Vehicle Owner Actions","pages":[{"title":"Rivian Bluetooth Pairing","sidebarTitle":"Rivian Bluetooth Pairing","href":"/connect/other-actions/rivian-bluetooth-pairing"},{"title":"Tesla Virtual Keys","sidebarTitle":"Tesla Virtual Keys","href":"/connect/other-actions/tesla-virtual-key"},{"title":"User Selected Battery Capacity","sidebarTitle":"Selecting Battery Capacity","description":"This flow can be launched using the URL provided by the [battery capacity](/docs/api-reference/get-nominal-capacity) endpoint.","href":"/connect/user-selected-batcap"}]},{"group":"Advanced Configuration","pages":[{"title":"Connect Flows","href":"/connect/advanced-config/flows"},{"title":"Modes","description":"Connect can be launched in different modes depending on whether you want to interact with real vehicles or test your integration.","href":"/connect/advanced-config/modes"},{"title":"Country Selection","href":"/connect/advanced-config/country-flag"},{"title":"Connect Options","href":"/connect/advanced-config/connect-options"},{"title":"Connection Filters","href":"/connect/advanced-config/connection-filters"}]},{"group":"Additional Connect Requirements","pages":[]}]},{"tab":"API \u0026 Integrations Reference","pages":[{"title":"API \u0026 Integrations Reference","href":"/api-reference/intro"}]},{"tab":"Vehicle Signals","pages":[{"title":"Vehicle Signals","href":"/api-reference/signals/schema"}]},{"tab":"Help Center","pages":[{"title":"Help Center","href":"/help/what-is-smartcar"}]},{"tab":"Changelog","pages":[{"title":"Changelog","href":"/changelog/latest"}]}]},"basePath":"","title":"Connect Flows - smartcar","buildId":"dpl_6cCEiK8XNNvaLBBkWzcBhdE9QfLC","deploymentId":"dpl_6cCEiK8XNNvaLBBkWzcBhdE9QfLC","dynamics":["07c022d89b","a74be98ba7","a9bb46feb3"],"chunks":["Frame-Bj1PpgeO.js","DynamicMarkdown-Bas9A7wq.js","zoom-image-lightbox-B-WKhCOL.js","lightbox-handle-r17bVUz3.js","Markdown-D3ZTwq_a.js","clsx-BcghKhHb.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-B66mVNPp.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-DmooSyTN.js"]}