{"docsConfig":{"$schema":"https://mintlify.com/docs.json","theme":"mint","name":"PathStack","colors":{"primary":"#2047FA","light":"#203dfa","dark":"#2047FA"},"favicon":"https://mintcdn.com/nuonic-39/IvvWU3allt6PGoB1/favicon.png?fit=max\u0026auto=format\u0026n=IvvWU3allt6PGoB1\u0026q=85\u0026s=13af1d1deb3e464f07af03b3c326ddd3","logo":{"light":"https://mintcdn.com/nuonic-39/syOOuB1ZSGS1zaSD/logo/light.png?fit=max\u0026auto=format\u0026n=syOOuB1ZSGS1zaSD\u0026q=85\u0026s=9b03c378d1fa1bbd0bfce37ccf17175c","dark":"https://mintcdn.com/nuonic-39/syOOuB1ZSGS1zaSD/logo/dark.png?fit=max\u0026auto=format\u0026n=syOOuB1ZSGS1zaSD\u0026q=85\u0026s=2e04739478900956a06ad5d8f726dfb1","href":"https://pathstack.io"},"api":{"openapi":["api-reference/openapi_2024-03-27.json","api-reference/openapi_2024-03-26.json"]},"navbar":{"links":[{"label":"Support","href":"mailto:support@pathstack.io"}],"primary":{"type":"button","label":"Sign up","href":"https://pathstack.io/register"}},"footer":{"socials":{"linkedin":"https://au.linkedin.com/company/nuonic"}},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"nuonic-39","hasAudioNarration":false,"actualSubdomain":"nuonic-39","customDomains":["docs.pathstack.io"],"gitSource":{"type":"github","owner":"nuonic","repo":"midland-docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6aa22862cf3ab925e991028c","collectionId":"26a2fba7-04c9-4265-8a37-e8d2acf3166e","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6aa22862cf3ab925e991028c"},"entitlements":{},"buildId":"6aa22862cf3ab925e991028c","clientVersion":"0.0.3990","searchFilterCounts":[{"language":"default","tag":"API Reference","count":83},{"language":"default","tag":"Endpoints","count":82},{"language":"default","tag":"Provider access guides","count":18},{"language":"default","tag":"Connections","count":14},{"language":"default","tag":"Milestones","count":12},{"language":"default","tag":"Documentation","count":12},{"language":"default","tag":"Devices","count":10},{"language":"default","tag":"Webhooks","count":10},{"language":"default","tag":"Legal","count":10},{"language":"default","tag":"Guides","count":9}]},"assistantConfig":{},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"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":"editor-v7-file-tree","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":"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":"pause-universal-search-reconcile","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":"per-site-search-delta","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":"editor-private-page-search","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":"editor-nav-generations","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":"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":"byok-sep-25","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":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-agent-model-picker","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","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":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"isAtlas":false,"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/2024-03-27/devices/create-device","slug":"/api-reference/2024-03-27/devices/create-device","pageMetadata":{"openapi":"openapi_2024-03-27 post /device","title":"Create Device","description":"This endpoint creates a Device.\n\nNot all providers are supported, currently only Digital Matter is supported.\n\nThe created Device is returned in the response.","href":"/api-reference/2024-03-27/devices/create-device"},"description":{"compiledSource":"\"use strict\";\nconst {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_Fragment, {\n children: [_jsx(_components.p, {\n children: \"This endpoint creates a Device.\"\n }), \"\\n\", _jsx(_components.p, {\n children: \"Not all providers are supported, currently only Digital Matter is supported.\"\n }), \"\\n\", _jsx(_components.p, {\n children: \"The created Device is returned in the response.\"\n })]\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":{"openapi":"openapi_2024-03-27 post /device","title":"Create Device","description":"This endpoint creates a Device.\n\nNot all providers are supported, currently only Digital Matter is supported.\n\nThe created Device is returned in the response.","href":"/api-reference/2024-03-27/devices/create-device"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["Devices"],"summary":"Create Device","description":"This endpoint creates a Device.\n\nNot all providers are supported, currently only Digital Matter is supported.\n\nThe created Device is returned in the response.","operationId":"create_device_device_post","security":["626761ac-ff45-41d5-b71e-29ba337fa4f8"],"parameters":["4f84e1db-27a0-4507-bd0c-808d4d89331f"],"requestBody":"4570903c-bde9-4e07-b889-97bd56ef2b0e","responses":{"200":"88c48fdb-d035-4ef9-9f09-eeacd786f2d5","400":"b3cc8be1-5f99-4301-b0f0-a73f09899429","401":"ee4531c0-01d7-4e30-896e-a027281aa776","403":"6f68f6bb-6c38-4ff1-aff8-4628a57e586b","404":"3d0c33ed-3a09-4d00-a066-345578a1db7c","405":"8ddb360f-1170-4388-a8ea-1a735157571e","422":"d34798a0-be40-4ab8-a18f-c0c2ecbe7d76"},"method":"post","type":"path","servers":["d1803bc1-eb91-4a2e-b2b3-a72ddd7dd766"],"path":"/device","baseUrlOptions":["https://api.pathstack.io"],"title":"Create Device","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"4f84e1db-27a0-4507-bd0c-808d4d89331f":{"name":"x-api-version","in":"header","required":false,"schema":{"type":"string","format":"date","default":"2024-03-27","title":"X-Api-Version","isRequired":false,"uniqueKey":"","typeLabel":"string\u003cdate>"},"examples":{"default":{"value":"2024-03-27"}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"system_device_id":{"type":"string","title":"System Device Id","isRequired":true,"uniqueKey":"system_device_id","typeLabel":"string"},"registration":{"oneOf":[{"type":"string","title":"Registration","isRequired":true,"uniqueKey":"registration.oneOf.0","typeLabel":"string"},{"type":"null","title":"Registration","isRequired":true,"uniqueKey":"registration.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"registration","typeLabel":"string | null"},"make":{"oneOf":[{"type":"string","title":"Make","isRequired":true,"uniqueKey":"make.oneOf.0","typeLabel":"string"},{"type":"null","title":"Make","isRequired":true,"uniqueKey":"make.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"make","typeLabel":"string | null"},"model":{"oneOf":[{"type":"string","title":"Model","isRequired":true,"uniqueKey":"model.oneOf.0","typeLabel":"string"},{"type":"null","title":"Model","isRequired":true,"uniqueKey":"model.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"model","typeLabel":"string | null"},"year":{"oneOf":[{"type":"integer","title":"Year","isRequired":true,"uniqueKey":"year.oneOf.0","typeLabel":"integer"},{"type":"null","title":"Year","isRequired":true,"uniqueKey":"year.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"year","typeLabel":"integer | null"},"active":{"type":"boolean","title":"Active","isRequired":true,"uniqueKey":"active","typeLabel":"boolean"},"tags":{"oneOf":[{"type":"array","items":{"type":"string","uniqueKey":"tags.oneOf.0.items.[INDEX]","typeLabel":"string"},"title":"Tags","isRequired":true,"uniqueKey":"tags.oneOf.0","typeLabel":"string[]"},{"type":"null","title":"Tags","isRequired":true,"uniqueKey":"tags.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"tags","typeLabel":"string[] | null"},"connection_id":{"type":"string","format":"uuid4","title":"Connection Id","isRequired":true,"uniqueKey":"connection_id","typeLabel":"string\u003cuuid4>"},"description":{"oneOf":[{"type":"string","title":"Description","uniqueKey":"description.oneOf.0","typeLabel":"string"},{"type":"null","title":"Description","uniqueKey":"description.oneOf.1","typeLabel":"null"}],"uniqueKey":"description","typeLabel":"string | null"}},"type":"object","required":["system_device_id","registration","make","model","year","active","tags","connection_id"],"title":"Device","description":"Details for device","uniqueKey":"","typeLabel":"Device · object"},"examples":{"Example":{"title":"Example","value":{"system_device_id":"\u003cstring>","registration":"\u003cstring>","make":"\u003cstring>","model":"\u003cstring>","year":123,"active":true,"tags":["\u003cstring>"],"connection_id":"\u003cstring>","description":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"88c48fdb-d035-4ef9-9f09-eeacd786f2d5":{"description":"Successful Response","content":{"application/json":{"schema":{"properties":{"data":{"properties":{"system_device_id":{"type":"string","title":"System Device Id","isRequired":true,"uniqueKey":"data.system_device_id","typeLabel":"string"},"registration":{"oneOf":[{"type":"string","title":"Registration","isRequired":true,"uniqueKey":"data.registration.oneOf.0","typeLabel":"string"},{"type":"null","title":"Registration","isRequired":true,"uniqueKey":"data.registration.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.registration","typeLabel":"string | null"},"make":{"oneOf":[{"type":"string","title":"Make","isRequired":true,"uniqueKey":"data.make.oneOf.0","typeLabel":"string"},{"type":"null","title":"Make","isRequired":true,"uniqueKey":"data.make.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.make","typeLabel":"string | null"},"model":{"oneOf":[{"type":"string","title":"Model","isRequired":true,"uniqueKey":"data.model.oneOf.0","typeLabel":"string"},{"type":"null","title":"Model","isRequired":true,"uniqueKey":"data.model.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.model","typeLabel":"string | null"},"year":{"oneOf":[{"type":"integer","title":"Year","isRequired":true,"uniqueKey":"data.year.oneOf.0","typeLabel":"integer"},{"type":"null","title":"Year","isRequired":true,"uniqueKey":"data.year.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.year","typeLabel":"integer | null"},"active":{"type":"boolean","title":"Active","isRequired":true,"uniqueKey":"data.active","typeLabel":"boolean"},"tags":{"oneOf":[{"type":"array","items":{"type":"string","uniqueKey":"data.tags.oneOf.0.items.[INDEX]","typeLabel":"string"},"title":"Tags","isRequired":true,"uniqueKey":"data.tags.oneOf.0","typeLabel":"string[]"},{"type":"null","title":"Tags","isRequired":true,"uniqueKey":"data.tags.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.tags","typeLabel":"string[] | null"},"id":{"type":"string","format":"uuid4","title":"Id","isRequired":true,"uniqueKey":"data.id","typeLabel":"string\u003cuuid4>"},"connection_id":{"type":"string","format":"uuid4","title":"Connection Id","isRequired":true,"uniqueKey":"data.connection_id","typeLabel":"string\u003cuuid4>"},"description":{"oneOf":[{"type":"string","title":"Description","uniqueKey":"data.description.oneOf.0","typeLabel":"string"},{"type":"null","title":"Description","uniqueKey":"data.description.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.description","typeLabel":"string | null"}},"type":"object","required":["system_device_id","registration","make","model","year","active","tags","id","connection_id"],"title":"Device","description":"Successful response payload","isRequired":true,"uniqueKey":"data","typeLabel":"Device · object"}},"type":"object","required":["data"],"title":"Success[Device]","uniqueKey":"","typeLabel":"Success[Device] · object"},"examples":{"Example":{"title":"Example","value":{"data":{"system_device_id":"\u003cstring>","registration":"\u003cstring>","make":"\u003cstring>","model":"\u003cstring>","year":123,"active":true,"tags":["\u003cstring>"],"id":"\u003cstring>","connection_id":"\u003cstring>","description":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"b3cc8be1-5f99-4301-b0f0-a73f09899429":{"content":{"application/json":{"schema":{"properties":{"error":{"type":"object","properties":{"code":{"type":"integer","example":400,"title":"Error code","uniqueKey":"error.code","typeLabel":"integer"},"message":{"type":"string","example":"Invalid JWT format","title":"Error message","uniqueKey":"error.message","typeLabel":"string"}},"uniqueKey":"error","typeLabel":"object"}},"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":400,"message":"Invalid JWT format"}}}},"exampleType":"generated"}},"description":"Bad Request","exampleType":"generated"},"ee4531c0-01d7-4e30-896e-a027281aa776":{"content":{"application/json":{"schema":{"properties":{"error":{"type":"object","properties":{"code":{"type":"integer","example":401,"title":"Error code","uniqueKey":"error.code","typeLabel":"integer"},"message":{"type":"string","example":"Authentication header is missing, or token is invalid/expired.","title":"Error message","uniqueKey":"error.message","typeLabel":"string"}},"uniqueKey":"error","typeLabel":"object"}},"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":401,"message":"Authentication header is missing, or token is invalid/expired."}}}},"exampleType":"generated"}},"description":"Unauthorized","exampleType":"generated"},"6f68f6bb-6c38-4ff1-aff8-4628a57e586b":{"content":{"application/json":{"schema":{"properties":{"error":{"type":"object","properties":{"code":{"type":"integer","example":403,"title":"Error code","uniqueKey":"error.code","typeLabel":"integer"},"message":{"type":"string","example":"You do not have access to this resource","title":"Error message","uniqueKey":"error.message","typeLabel":"string"}},"uniqueKey":"error","typeLabel":"object"}},"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":403,"message":"You do not have access to this resource"}}}},"exampleType":"generated"}},"description":"Forbidden","exampleType":"generated"},"3d0c33ed-3a09-4d00-a066-345578a1db7c":{"content":{"application/json":{"schema":{"properties":{"error":{"type":"object","properties":{"code":{"type":"integer","example":404,"title":"Error code","uniqueKey":"error.code","typeLabel":"integer"},"message":{"type":"string","example":"Connection with ID \u003cconnection_id> not found","title":"Error message","uniqueKey":"error.message","typeLabel":"string"}},"uniqueKey":"error","typeLabel":"object"}},"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":404,"message":"Connection with ID \u003cconnection_id> not found"}}}},"exampleType":"generated"}},"description":"Not Found","exampleType":"generated"},"8ddb360f-1170-4388-a8ea-1a735157571e":{"content":{"application/json":{"schema":{"properties":{"error":{"type":"object","properties":{"code":{"type":"integer","example":405,"title":"Error code","uniqueKey":"error.code","typeLabel":"integer"},"message":{"type":"string","example":"The telematics provider for this Device does not support creation of Devices with the API","title":"Error message","uniqueKey":"error.message","typeLabel":"string"}},"uniqueKey":"error","typeLabel":"object"}},"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":405,"message":"The telematics provider for this Device does not support creation of Devices with the API"}}}},"exampleType":"generated"}},"description":"Method Not Allowed","exampleType":"generated"},"d34798a0-be40-4ab8-a18f-c0c2ecbe7d76":{"content":{"application/json":{"schema":{"properties":{"error":{"type":"object","properties":{"code":{"type":"integer","example":422,"title":"Error code","uniqueKey":"error.code","typeLabel":"integer"},"message":{"type":"string","example":"Field required","title":"Error message","uniqueKey":"error.message","typeLabel":"string"},"loc":{"items":{"oneOf":[{"type":"string","uniqueKey":"error.loc.items.[INDEX].oneOf.0","typeLabel":"string"},{"type":"integer","uniqueKey":"error.loc.items.[INDEX].oneOf.1","typeLabel":"integer"}],"uniqueKey":"error.loc.items.[INDEX]","typeLabel":"string | integer"},"type":"array","title":"Location","uniqueKey":"error.loc","typeLabel":"(string | integer)[]"},"msg":{"type":"string","title":"Message","uniqueKey":"error.msg","typeLabel":"string"},"type":{"type":"string","title":"Error Type","uniqueKey":"error.type","typeLabel":"string"}},"uniqueKey":"error","typeLabel":"object"}},"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":422,"message":"Field required","loc":["\u003cstring>"],"msg":"\u003cstring>","type":"\u003cstring>"}}}},"exampleType":"generated"}},"description":"Unprocessable Entity","exampleType":"generated"}},"security":{"626761ac-ff45-41d5-b71e-29ba337fa4f8":{"JWTBearer":{"type":"http","scheme":"bearer","scopes":[]}}},"servers":{"d1803bc1-eb91-4a2e-b2b3-a72ddd7dd766":{"url":"https://api.pathstack.io","description":"PathStack production environment"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","scopes":[]},"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":"JWTBearer","name":"Authorization"}],"title":"JWTBearer"}]},"originalFileLocation":"api-reference/openapi_2024-03-27.json"},"subdomain":"nuonic-39","siteName":"PathStack","title":"Create Device - PathStack","navMaps":{"firstHrefInVersion":{"2024-03-27":{"href":"/api-reference/2024-03-27/devices/create-device","matchLevel":0},"2024-03-26":{"href":"/api-reference/2024-03-26/devices/create-device","matchLevel":1}},"firstHrefInLanguage":{}},"lastModified":"2025-09-09T05:07:59.597Z","originalFileLocation":"api-reference/2024-03-27/devices/create-device.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=\"This endpoint creates a Device. Not all providers are supported, currently only Digital Matter is supported. The created Device is returned in the response.\">\u003cmeta data-mint-head name=\"application-name\" content=\"PathStack\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/nuonic-39/fYQpJWsv94JQUvWa/_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/nuonic-39/fYQpJWsv94JQUvWa/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/nuonic-39/fYQpJWsv94JQUvWa/_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/nuonic-39/fYQpJWsv94JQUvWa/_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/nuonic-39/fYQpJWsv94JQUvWa/_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/nuonic-39/fYQpJWsv94JQUvWa/_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/nuonic-39/fYQpJWsv94JQUvWa/_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/nuonic-39/fYQpJWsv94JQUvWa/_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/nuonic-39/fYQpJWsv94JQUvWa/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Create Device - PathStack\">\u003cmeta data-mint-head property=\"og:description\" content=\"This endpoint creates a Device. Not all providers are supported, currently only Digital Matter is supported. The created Device is returned in the response.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"PathStack\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.pathstack.io/api-reference/2024-03-27/devices/create-device\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://nuonic-39.mintlify.app/_mintlify/api/og/v2?division=Devices\u0026amp;title=Create+Device\u0026amp;description=This+endpoint+creates+a+Device.%0A%0ANot+all+providers+are+supported%2C+currently+only+Digital+Matter+is+supported.%0A%0AThe+created+Device+is+returned+in+the+response.\u0026amp;theme=cb7cc1e2641545070c649087\u0026amp;signature=5b86c55486435a019615d74fc08ae4c8dd11a0973c7a2a4f65618e6127ead824\">\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 Device - PathStack\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"This endpoint creates a Device. Not all providers are supported, currently only Digital Matter is supported. The created Device is returned in the response.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://nuonic-39.mintlify.app/_mintlify/api/og/v2?division=Devices\u0026amp;title=Create+Device\u0026amp;description=This+endpoint+creates+a+Device.%0A%0ANot+all+providers+are+supported%2C+currently+only+Digital+Matter+is+supported.%0A%0AThe+created+Device+is+returned+in+the+response.\u0026amp;theme=cb7cc1e2641545070c649087\u0026amp;signature=5b86c55486435a019615d74fc08ae4c8dd11a0973c7a2a4f65618e6127ead824\">\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/nuonic-39/fYQpJWsv94JQUvWa/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"PathStack\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#2047FA\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.pathstack.io/api-reference/2024-03-27/devices/create-device\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/2024-03-27/devices/create-device.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.pathstack.io/#organization\",\"name\":\"PathStack\",\"url\":\"https://docs.pathstack.io\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/nuonic-39/syOOuB1ZSGS1zaSD/logo/light.png?fit=max\u0026auto=format\u0026n=syOOuB1ZSGS1zaSD\u0026q=85\u0026s=9b03c378d1fa1bbd0bfce37ccf17175c\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.pathstack.io#website\",\"name\":\"PathStack\",\"url\":\"https://docs.pathstack.io\",\"publisher\":{\"@id\":\"https://docs.pathstack.io/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.pathstack.io/api-reference/2024-03-27/devices/create-device#webpage\",\"url\":\"https://docs.pathstack.io/api-reference/2024-03-27/devices/create-device\",\"name\":\"Create Device\",\"description\":\"This endpoint creates a Device. Not all providers are supported, currently only Digital Matter is supported. The created Device is returned in the response.\",\"dateModified\":\"2025-09-09T05:07:59.597Z\",\"isPartOf\":{\"@id\":\"https://docs.pathstack.io#website\"},\"breadcrumb\":{\"@id\":\"https://docs.pathstack.io/api-reference/2024-03-27/devices/create-device#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.pathstack.io/api-reference/2024-03-27/devices/create-device#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Endpoints\",\"item\":\"https://docs.pathstack.io/api-reference/2024-03-27/account/account-summary\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Devices\",\"item\":\"https://docs.pathstack.io/api-reference/2024-03-27/devices/devices\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Create Device\",\"item\":\"https://docs.pathstack.io/api-reference/2024-03-27/devices/create-device\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.pathstack.io/api-reference/2024-03-27/devices/create-device#apireference\",\"headline\":\"Create Device\",\"name\":\"Create Device\",\"description\":\"This endpoint creates a Device. Not all providers are supported, currently only Digital Matter is supported. The created Device is returned in the response.\",\"url\":\"https://docs.pathstack.io/api-reference/2024-03-27/devices/create-device\",\"mainEntityOfPage\":{\"@id\":\"https://docs.pathstack.io/api-reference/2024-03-27/devices/create-device#webpage\"},\"dateModified\":\"2025-09-09T05:07:59.597Z\",\"publisher\":{\"@id\":\"https://docs.pathstack.io/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.pathstack.io#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"PathStack\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"PathStack","nav":{"global":null,"versions":[{"version":"2024-03-27","tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":"/introduction"}]},{"tab":"API Reference","groups":[{"group":"API Documentation","pages":[{"title":"Introduction","href":"/api-reference/introduction"}]},{"group":"Endpoints","pages":[{"group":"Account","pages":[{"openapi":"openapi_2024-03-27 get /account/summary","title":"Account Summary","href":"/api-reference/2024-03-27/account/account-summary"},{"openapi":"openapi_2024-03-27 get /account/activity-summary","title":"Account Activity Summary","href":"/api-reference/2024-03-27/account/account-activity-summary"}]},{"group":"Auth","pages":[{"openapi":"openapi_2024-03-27 post /token","title":"Login","href":"/api-reference/2024-03-27/auth/login"},{"openapi":"openapi_2024-03-27 post /refresh","title":"Refresh","href":"/api-reference/2024-03-27/auth/refresh"}]},{"group":"Connections","pages":[{"openapi":"openapi_2024-03-27 get /connection","title":"Connections","href":"/api-reference/2024-03-27/connections/connections"},{"openapi":"openapi_2024-03-27 post /connection","title":"Create Connection","href":"/api-reference/2024-03-27/connections/create-connection"},{"openapi":"openapi_2024-03-27 get /connection/{connection_id}","title":"Connection By Id","href":"/api-reference/2024-03-27/connections/connection-by-id"},{"openapi":"openapi_2024-03-27 patch /connection/{connection_id}","title":"Update Connection","href":"/api-reference/2024-03-27/connections/update-connection"},{"openapi":"openapi_2024-03-27 get /connection/{connection_id}/credentials","title":"Connection Credentials By Id","href":"/api-reference/2024-03-27/connections/connection-credentials-by-id"},{"openapi":"openapi_2024-03-27 patch /connection/{connection_id}/credentials","title":"Update Connection Credentials","href":"/api-reference/2024-03-27/connections/update-connection-credentials"},{"openapi":"openapi_2024-03-27 get /connection-tag","title":"List Connection Tags","href":"/api-reference/2024-03-27/connections/list-connection-tags"}]},{"group":"Devices","pages":[{"openapi":"openapi_2024-03-27 get /device","title":"Devices","description":"This endpoint returns all Devices that have been created by Connections for your Tenancy.\n\nYou can specify the telematics_provider, and it will return only Devices with that provider.\n\nYou can specify the tags, and it will return only Devices that have all the tags specified.\n\nThe response is paginated, so if the next link is not null, use that link to get the next page of results.","href":"/api-reference/2024-03-27/devices/devices"},{"openapi":"openapi_2024-03-27 post /device","title":"Create Device","href":"/api-reference/2024-03-27/devices/create-device"},{"openapi":"openapi_2024-03-27 get /device/{device_id}","title":"Device By Id","description":"This endpoint returns a Device by ID.","href":"/api-reference/2024-03-27/devices/device-by-id"},{"openapi":"openapi_2024-03-27 delete /device/{device_id}","title":"Delete Device By Id","href":"/api-reference/2024-03-27/devices/delete-device-by-id"},{"openapi":"openapi_2024-03-27 patch /device/{device_id}","title":"Update Device By Id","href":"/api-reference/2024-03-27/devices/update-device-by-id"}]},{"group":"Trips","pages":[{"openapi":"openapi_2024-03-27 get /device/{device_id}/trip","title":"Trips","href":"/api-reference/2024-03-27/trips/trips"},{"openapi":"openapi_2024-03-27 get /trip/{trip_id}","title":"Trip By Id","href":"/api-reference/2024-03-27/trips/trip-by-id"}]},{"group":"Positions","pages":[{"openapi":"openapi_2024-03-27 get /device/{device_id}/position","title":"Positions","href":"/api-reference/2024-03-27/positions/positions"},{"openapi":"openapi_2024-03-27 get /trip/{trip_id}/position","title":"Positions By Trip Id","href":"/api-reference/2024-03-27/positions/positions-by-trip-id"}]},{"group":"Real-time","pages":[{"openapi":"openapi_2024-03-27 post /realtime/device","title":"Get Realtime Positions","href":"/api-reference/2024-03-27/real-time/get-realtime-positions"},{"openapi":"openapi_2024-03-27 get /realtime/connect","title":"Get Connect","href":"/api-reference/2024-03-27/real-time/get-connect"}]},{"group":"Webhooks","pages":[{"openapi":"openapi_2024-03-27 get /webhook","title":"Get Webhooks","href":"/api-reference/2024-03-27/webhooks/get-webhooks"},{"openapi":"openapi_2024-03-27 post /webhook","title":"Create Webhook","href":"/api-reference/2024-03-27/webhooks/create-webhook"},{"openapi":"openapi_2024-03-27 get /webhook/{webhook_id}","title":"Get Webhook","href":"/api-reference/2024-03-27/webhooks/get-webhook"},{"openapi":"openapi_2024-03-27 delete /webhook/{webhook_id}","title":"Delete Webhook","href":"/api-reference/2024-03-27/webhooks/delete-webhook"},{"openapi":"openapi_2024-03-27 patch /webhook/{webhook_id}","title":"Patch Webhook","href":"/api-reference/2024-03-27/webhooks/patch-webhook"}]},{"group":"Tags","pages":[{"openapi":"openapi_2024-03-27 get /tag","title":"Get Tags","href":"/api-reference/2024-03-27/tags/get-tags"}]},{"group":"Events","pages":[{"openapi":"openapi_2024-03-27 get /device/{device_id}/event","title":"Events","href":"/api-reference/2024-03-27/events/events"},{"openapi":"openapi_2024-03-27 get /event/{event_id}","title":"Event By Id","href":"/api-reference/2024-03-27/events/event-by-id"}]},{"group":"Tenants","pages":[{"openapi":"openapi_2024-03-27 get /tenant","title":"Tenant By Id","href":"/api-reference/2024-03-27/tenants/tenant-by-id"},{"openapi":"openapi_2024-03-27 patch /tenant","title":"Update Tenant By Id","href":"/api-reference/2024-03-27/tenants/update-tenant-by-id"},{"openapi":"openapi_2024-03-27 get /tenant/configuration","title":"Tenant Configuration","href":"/api-reference/2024-03-27/tenants/tenant-configuration"}]},{"group":"Milestones","pages":[{"openapi":"openapi_2024-03-27 get /milestone","title":null,"href":"/api-reference/2024-03-27/milestones/get-milestones"},{"openapi":"openapi_2024-03-27 post /milestone","title":null,"href":"/api-reference/2024-03-27/milestones/create-milestone"},{"openapi":"openapi_2024-03-27 get /milestone/{milestone_id}","title":"Get Milestone","href":"/api-reference/2024-03-27/milestones/get-milestone"},{"openapi":"openapi_2024-03-27 delete /milestone/{milestone_id}","title":"Delete Milestone","href":"/api-reference/2024-03-27/milestones/delete-milestone"},{"openapi":"openapi_2024-03-27 patch /milestone/{milestone_id}","title":"Patch Milestone","href":"/api-reference/2024-03-27/milestones/patch-milestone"},{"openapi":"openapi_2024-03-27 get /milestone/{milestone_id}/update","title":"Get Milestone Update","href":"/api-reference/2024-03-27/milestones/get-milestone-update"}]},{"group":"Consumer","pages":[{"openapi":"openapi_2024-03-27 get /consumer/connection/share_request","title":"Get Share Requests","href":"/api-reference/2024-03-27/consumer/get-share-requests"},{"openapi":"openapi_2024-03-27 post /consumer/connection/share_request","title":"Create Share Request","href":"/api-reference/2024-03-27/consumer/create-share-request"}]}]}]},{"tab":"Provider access guides","pages":[{"title":"Provider access guides","href":"/integration-guides/verizon"}]},{"tab":"Legal","pages":[{"title":"Legal","href":"/legal/data-provider-terms"}]}]},{"version":"2024-03-26","pages":[{"title":"2024-03-26","href":"/api-reference/2024-03-26/devices/create-device"}]}]},"title":"Create Device - PathStack","buildId":"dpl_2oYXwqkEXirXBPk8wV1FtM5USFWi","deploymentId":"dpl_2oYXwqkEXirXBPk8wV1FtM5USFWi","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-WRhTSUDL.js","utils-ChMov4Kr.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-_REmC2bI.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-Bp6nVRCu.js","snippetPresets-DZadmXoU.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-CY2WdoTl.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-DwYG-Q4l.js","shallow-BXQIGwv4.js","getApiPlaygroundDisplay-CK5nK5B9.js","CodeSnippet-TH4a2aGW.js","CodeSnippets-DwsQiOFS.js","Page-R3M_BF4L.js","getPastedJson-DD7kUzi_.js","icon-holE3QoJ.js","MethodPill-DUW0T8us.js","DuplicateIcon-CI_p4be-.js","createIcon-BdbRvavb.js","DynamicMarkdown-DN96a4Ur.js","SectionHeading-SCu36A9d.js","axios-vUo_bRtp.js","Markdown-CCeGv-zI.js","clsx-BGBGWFTt.js","lib--scc4DXi.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-Cv_O2fky.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-2C5OB2eV.js"]}