Default currency in which the vendor's financial operations,such as purchases, payments, or invoices, are primarily conducted. (ISO 4217 currency code (3 letters))
The name field represents the official name of the Vendor as it is recorded in the target ERP/accounting system. This name is used to uniquely identify the vendor within the accounting workflow and is visible to the Pleo bookkeeper.
Unique external identifier of the vendor, assigned by the target ERP/accounting system, used by the client for identification. Can be the same as code if no other identifier is available.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Pleo Docs","colors":{"primary":"#FEB6FE","light":"#FEB6FE","dark":"#131414"},"logo":{"light":"https://mintcdn.com/pleo-61d4d38b/0im2PqYmwpP-taWp/logo/pleo-developers-light.svg?fit=max\u0026auto=format\u0026n=0im2PqYmwpP-taWp\u0026q=85\u0026s=c000128fc6805d6e5d279ec0fdc06880","dark":"https://mintcdn.com/pleo-61d4d38b/0im2PqYmwpP-taWp/logo/pleo-developers-dark.svg?fit=max\u0026auto=format\u0026n=0im2PqYmwpP-taWp\u0026q=85\u0026s=4bb015d539b87030ea9e8b2f6e9bcacf"},"favicon":"https://mintcdn.com/pleo-61d4d38b/earhx-WV21nRUBYy/favicon.ico?fit=max\u0026auto=format\u0026n=earhx-WV21nRUBYy\u0026q=85\u0026s=d2072fecca8a5747cb9f15e5a0b405f8","background":{"color":{"light":"#fff","dark":"#212222"}},"navbar":{"links":[{"href":"https://status.pleo.io/","label":"Status"},{"href":"https://help.pleo.io/en/support/home","label":"Support"},{"href":"https://www.pleo.io/en/integrations","label":"Pre-Built"},{"href":"https://www.pleo.io/en/explore-product","label":"Products"},{"href":"https://blog.pleo.io/en","label":"Blog"}],"primary":{"type":"button","label":"Demo","href":"https://www.pleo.io/en/demo"}},"footer":{"socials":{"x":"https://www.twitter.com/pleo","youtube":"https://www.youtube.com/channel/UCQQitvQIlEgIxNyLlOgilXQ","linkedin":"https://www.linkedin.com/company/pleo-company"}},"fonts":{"heading":{"family":"Pleo Scandi Gellix Headline","weight":545,"source":"fonts/PleoScandiGellix-Headline.woff2","format":"woff2"},"body":{"family":"Pleo Scandi Gellix Text","weight":450,"source":"fonts/PleoScandiGellix-Text.woff2","format":"woff2"}},"styling":{"latex":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"pleo-61d4d38b","hasAudioNarration":false,"actualSubdomain":"pleo-61d4d38b","customDomains":["developers.pleo.io"],"gitSource":{"type":"github","owner":"pleo-io","repo":"external-documentation","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6adb657f57868d74937d8606","collectionId":"fc637e25-cd5b-4e3a-8595-03cc0551f3af","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6adb657f57868d74937d8606"},"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":"6adb657f57868d74937d8606","clientVersion":"0.0.4021","searchFilterCounts":[{"language":"default","tag":"API Reference","count":199},{"language":"default","tag":"API 1","count":199},{"language":"default","tag":"Build with Pleo","count":108},{"language":"default","tag":"AS/ERP","count":86},{"language":"default","tag":"How-to's","count":69},{"language":"default","tag":"Integration Design","count":59},{"language":"default","tag":"PLEO.IO API (DEPRECATED)","count":54},{"language":"default","tag":"Exports","count":52},{"language":"default","tag":"Expenses","count":46},{"language":"default","tag":"Imports","count":42}]},"assistantConfig":{"enableStarterQuestions":true,"enableContextualStarterQuestions":true},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"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":"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":"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}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":"@font-face{font-family:\"Pleo Scandi Gellix Headline\";src:url(/fonts/PleoScandiGellix-HeadlineItalic.woff2) format(\"woff2\");font-weight:545;font-style:italic;font-display:swap}@font-face{font-family:\"Pleo Scandi Gellix Text\";src:url(/fonts/PleoScandiGellix-TextItalic.woff2) format(\"woff2\");font-weight:450;font-style:italic;font-display:swap}html{font-synthesis:none}html:not(.dark) b,html:not(.dark) strong{color:#131414}#navbar .border-b{border-bottom-width:0!important}html:not(.dark) .eyebrow:not(:empty){display:inline-flex;align-items:center;background-color:#eef4f4!important;color:#131414!important;padding:2px 10px;border-radius:9999px}header#navbar.is-center~* .eyebrow{display:none!important}html:not(.dark) #sidebar a[aria-current=page].bg-primary\\/10,html:not(.dark) li[data-active-nav-item=true]>a{background-color:#eef4f4!important;color:#131414!important}html:not(.dark) #sidebar a:not([aria-current=page]),html:not(.dark) .prose{color:#6b7070!important}html:not(.dark) #table-of-contents li[data-active]>a{background-color:#fafcfc!important;color:#131414!important;border-radius:.5rem}html:not(.dark) [data-component-part=accordion-button]:hover{background-color:#eef4f4!important}html.dark b,html.dark strong{color:#fafcfc}html:not(.dark) [role=menuitemradio][aria-checked=true]{background-color:#feb6fe!important;color:#131414!important}html:not(.dark) [role=menuitemradio]:hover svg,html:not(.dark) [role=menuitemradio][aria-checked=true] svg,html:not(.dark) a.nav-dropdown-item:hover .nav-dropdown-item-title,html:not(.dark) a.nav-dropdown-item:hover svg,html:not(.dark) a.nav-dropdown-item[aria-current=location] .nav-dropdown-item-title,html:not(.dark) a.nav-dropdown-item[aria-current=location] svg{color:#131414!important}html:not(.dark) [role=menuitemradio]:hover{background-color:#fafcfc!important;color:#131414!important}html:not(.dark) a.nav-dropdown-item[aria-current=location]{background-color:#feb6fe!important}html:not(.dark) .nav-dropdown-trigger .nav-dropdown-item-icon svg,html:not(.dark) a.nav-dropdown-item:hover .nav-dropdown-item-icon svg,html:not(.dark) a.nav-dropdown-item[aria-current=location] .nav-dropdown-item-icon svg{background-color:#131414!important}html:not(.dark) a.nav-dropdown-item:hover,html:not(.dark) li:not([data-active-nav-item=true])>a:hover{background-color:#fafcfc!important}html.dark .prose{color:#eef4f4!important}html.dark li[data-active-nav-item=true]>a{background-color:#131414!important;color:#feb6fe!important}html:not(.dark) [data-component-part=update-label]{background-color:#eef4f4!important;color:#131414!important}[data-component-part=update-description]{color:#feb6fe!important}.sidebar-group-header,.sidebar-group-header .sidebar-title{font-weight:450!important}html:not(.dark) .sidebar-group-header,html:not(.dark) .sidebar-group-header .sidebar-title{color:#131414!important}html.dark .callout-badge svg,html.dark .callout-icon svg,html.dark .sidebar-group-header,html.dark .sidebar-group-header .sidebar-title{color:#fafcfc!important}h1,h2,h3,h4,h5,h6{font-weight:545!important}html.dark li:not([data-active-nav-item=true])>a:hover{background-color:#212222!important}#navigation-items,#navigation-items :not(.method-nav-pill *){font-size:15px!important}.prose:not(.prose-sm){font-size:17px!important}:root{--recommended-title:#131414;--recommended-bg:#FAFCFC;--callout-note-accent:#6B7070;--callout-note-border:#EEF4F4;--callout-note-shadow:rgb(238, 244, 244, 0.3);--callout-remember-accent:#FEB6FE;--callout-remember-shadow:rgb(254, 182, 254, 0.3);--callout-recommended-accent:#227F47;--callout-recommended-shadow:rgb(34, 127, 71, 0.3);--callout-explorative-accent:#407CD6;--callout-explorative-shadow:rgb(64, 124, 214, 0.3);--callout-warning-accent:#F0E556;--callout-warning-icon:#DBC713;--callout-warning-shadow:rgb(240, 229, 86, 0.75);--callout-danger-accent:#F15A71;--callout-danger-shadow:rgb(241, 90, 113, 0.75)}html.dark{--recommended-title:#FAFCFC;--recommended-bg:#252e34;--callout-note-accent:#EEF4F4;--callout-note-border:#EEF4F4;--callout-note-shadow:rgb(238, 244, 244, 0.3);--callout-remember-accent:#FEB6FE;--callout-remember-shadow:rgb(254, 182, 254, 0.3);--callout-recommended-accent:#21C663;--callout-recommended-shadow:rgb(33, 198, 99, 0.3);--callout-explorative-accent:#A8D9FF;--callout-explorative-shadow:rgb(168, 217, 255, 0.3);--callout-warning-accent:#F0E556;--callout-warning-icon:#F0E556;--callout-warning-shadow:rgb(240, 229, 86, 0.75);--callout-danger-accent:#FF90A1;--callout-danger-shadow:rgb(255, 144, 161, 0.75)}.callout-box{background-color:var(--recommended-bg);padding:18px 22px;margin-bottom:20px;border-left:4px solid}.callout-row{display:flex;align-items:flex-start;gap:14px}.callout-icon{font-size:22px;line-height:1;flex-shrink:0}.callout-badge{display:flex;align-items:center;justify-content:center;width:32px;height:32px;border-radius:50%;border:2px solid;flex-shrink:0}.callout-title{font-size:16px;font-weight:600;color:var(--recommended-title);margin-bottom:6px}.callout-body{font-size:14px;line-height:1.65}.callout-badge svg,.callout-icon svg{color:#131414!important}.callout-note{border-left-color:var(--callout-note-border)}.callout-note .callout-icon svg{color:var(--callout-note-accent)}.callout-remember{border-left-color:var(--callout-remember-accent)}.callout-remember .callout-icon svg,html.dark .callout-remember .callout-icon svg{color:var(--callout-remember-accent)!important}.callout-recommended{border-left-color:var(--callout-recommended-accent)}.callout-recommended .callout-icon svg,html.dark .callout-recommended .callout-icon svg{color:var(--callout-recommended-accent)!important}.callout-explorative{border-left-color:var(--callout-explorative-accent)}.callout-explorative .callout-icon svg,html.dark .callout-explorative .callout-icon svg{color:var(--callout-explorative-accent)!important}.callout-warning{border-left-color:var(--callout-warning-accent)}.callout-warning .callout-badge{border-color:var(--callout-warning-accent)}.callout-warning .callout-badge svg{color:var(--callout-warning-icon)}.callout-danger{border-left-color:var(--callout-danger-accent)}.callout-danger .callout-badge{border-color:var(--callout-danger-accent)}.callout-danger .callout-badge svg{color:var(--callout-danger-accent)}.btn-primary,.btn-secondary{display:inline-flex;align-items:center;justify-content:center;border-radius:9999px;padding:.75rem 1.5rem;font-size:.875rem;font-weight:500;border:0;text-decoration:none!important;transition:background-color .15s ease,color .15s ease}.btn-primary{background-color:#feb6fe!important;color:#131414!important}.btn-primary:hover,.btn-secondary,.btn-secondary:hover{background-color:#2e3030!important;color:#fafcfc!important}html.dark .btn-primary:hover,html.dark .btn-secondary{border:1px solid #6b7070!important}.btn-secondary{background-color:#131414!important}html:not(.dark) #navbar .nav-tabs-item.text-gray-800,html:not(.dark) [data-component-part=field-name],html:not(.dark) [role=tab].text-primary,html:not(.dark) button[aria-label=\"Select language\"] div:hover{color:#131414!important}html:not(.dark) [data-component-part=tab-button][data-active=true]{color:#131414!important;background-color:#eef4f4;padding-left:10px;padding-right:10px;margin-right:-10px;border-radius:9999px;border-bottom-color:transparent!important}html:not(.dark) .method-nav-pill .text-green-700,html:not(.dark) .method-pill.text-green-700{background-color:rgb(34,127,71,.14)!important;color:#227f47!important}html.dark .method-nav-pill .text-green-400,html.dark .method-pill.text-green-400{background-color:rgb(33,198,99,.16)!important;color:#21c663!important}html:not(.dark) .method-nav-pill .text-blue-700,html:not(.dark) .method-pill.text-blue-700{background-color:rgb(64,124,214,.14)!important;color:#407cd6!important}html.dark .method-nav-pill .text-blue-400,html.dark .method-pill.text-blue-400{background-color:rgb(168,217,255,.16)!important;color:#a8d9ff!important}html:not(.dark) .method-nav-pill .text-yellow-700,html:not(.dark) .method-pill.text-yellow-700{background-color:rgb(219,199,19,.14)!important;color:#dbc713!important}html.dark .method-nav-pill .text-yellow-400,html.dark .method-pill.text-yellow-400{background-color:rgb(240,229,86,.18)!important;color:#f0e556!important}html:not(.dark) .method-nav-pill .text-red-700,html:not(.dark) .method-pill.text-red-700{background-color:rgb(241,90,113,.14)!important;color:#f15a71!important}html.dark .method-nav-pill .text-red-400,html.dark .method-pill.text-red-400{background-color:rgb(255,144,161,.16)!important;color:#ff90a1!important}html:not(.dark) [data-component-part=field-required-pill]{background-color:rgb(241,90,113,.12)!important;color:#f15a71!important}html:not(.dark) .method-nav-pill .bg-\\[\\#2AB673\\]{background-color:rgb(34,127,71,.14)!important;color:#227f47!important}html.dark .method-nav-pill .bg-\\[\\#2AB673\\]{background-color:rgb(33,198,99,.16)!important;color:#21c663!important}html:not(.dark) .method-nav-pill .bg-\\[\\#3064E3\\]{background-color:rgb(64,124,214,.14)!important;color:#407cd6!important}html.dark .method-nav-pill .bg-\\[\\#3064E3\\]{background-color:rgb(168,217,255,.16)!important;color:#a8d9ff!important}html:not(.dark) .method-nav-pill .bg-\\[\\#C28C30\\]{background-color:rgb(219,199,19,.14)!important;color:#dbc713!important}html.dark .method-nav-pill .bg-\\[\\#C28C30\\]{background-color:rgb(240,229,86,.18)!important;color:#f0e556!important}html:not(.dark) .method-nav-pill .bg-\\[\\#CB3A32\\]{background-color:rgb(241,90,113,.14)!important;color:#f15a71!important}html.dark .method-nav-pill .bg-\\[\\#CB3A32\\]{background-color:rgb(255,144,161,.16)!important;color:#ff90a1!important}html.dark [data-component-part=field-required-pill]{background-color:rgb(255,144,161,.14)!important;color:#ff90a1!important}.tryit-button.bg-\\[\\#2AB673\\],.tryit-button.bg-\\[\\#3064E3\\],.tryit-button.bg-\\[\\#C28C30\\],.tryit-button.bg-\\[\\#CB3A32\\]{background-color:#feb6fe!important;color:#131414!important}.tryit-button:hover{opacity:1!important;background-color:#2e3030!important;color:#fafcfc!important}.tryit-button svg.bg-white{background-color:#131414!important}.tryit-button:hover svg.bg-white{background-color:#fafcfc!important}.card,.code-block,.code-block>div{border-radius:4px!important}.card,.code-block{transition:box-shadow .15s ease}.card:not(:hover){border-color:transparent!important}html:not(.dark) .card{background-color:#fafcfc!important}html.dark .card{background-color:#2e3030!important}.card:hover{box-shadow:none!important}html.dark img[src*=\"/images/current/icons/\"]{filter:invert(1) brightness(1.5)}.card:hover img[src*=\"/images/current/icons/\"]{filter:invert(97%) sepia(73%) saturate(4507%) hue-rotate(231deg) brightness(108%) contrast(99%)!important}.callout-box{border-radius:4px!important}#table-of-contents [class*=font-medium],#table-of-contents [class*=font-semibold],aside [class*=font-medium],aside [class*=font-semibold],nav [class*=font-medium],nav [class*=font-semibold]{font-weight:450!important}#navbar a,#table-of-contents a,aside a,nav a{text-shadow:none!important}.prose{counter-reset:step}.prose h3:is([id^=\"0\"], [id^=\"1\"], [id^=\"2\"], [id^=\"3\"], [id^=\"4\"], [id^=\"5\"], [id^=\"6\"], [id^=\"7\"], [id^=\"8\"], [id^=\"9\"]){counter-increment:step}.prose h3:is([id^=\"0\"], [id^=\"1\"], [id^=\"2\"], [id^=\"3\"], [id^=\"4\"], [id^=\"5\"], [id^=\"6\"], [id^=\"7\"], [id^=\"8\"], [id^=\"9\"])~ol{counter-reset:substep;list-style:none;margin-left:0;padding-left:0}.prose h3:is([id^=\"0\"], [id^=\"1\"], [id^=\"2\"], [id^=\"3\"], [id^=\"4\"], [id^=\"5\"], [id^=\"6\"], [id^=\"7\"], [id^=\"8\"], [id^=\"9\"])~ol>li{counter-increment:substep;position:relative;padding-left:2.75em}.prose h3:is([id^=\"0\"], [id^=\"1\"], [id^=\"2\"], [id^=\"3\"], [id^=\"4\"], [id^=\"5\"], [id^=\"6\"], [id^=\"7\"], [id^=\"8\"], [id^=\"9\"])~ol>li::before{content:counter(step) \".\" counter(substep) \". \";position:absolute;left:0;font-weight:450}[data-component-part=update-content] div[style*=margin-left]{position:relative}[data-component-part=update-content] div[style*=margin-left] img{position:absolute;top:0;left:0}[data-component-part=update-content] div[style*=margin-left] img[src*=\"-dark.svg\"],html.dark [data-component-part=update-content] div[style*=margin-left] img[src*=\"-light.svg\"]{display:none}html.dark [data-component-part=update-content] div[style*=margin-left] img[src*=\"-dark.svg\"]{display:block}[data-component-part=update-content] div[style*=margin-left]>span{display:block;padding-left:22px}@media (min-width:1024px){.update-container>.lg\\:w-\\[160px\\]{width:170px}}"}],"page":{"pagePath":"reference/external-vendors/create-a-new-vendor","slug":"/reference/external-vendors/create-a-new-vendor","pageMetadata":{"openapi":"post /v1/vendors","title":"Create a New Vendor","description":"This endpoint has the following functions:\n- Create a corresponding record in Pleo for any new vendor created in the ERP/accounting system.\n- Create a new vendor in Pleo, without the record yet existing in the ERP/accounting system.","href":"/reference/external-vendors/create-a-new-vendor"},"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 li: \"li\",\n p: \"p\",\n ul: \"ul\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_Fragment, {\n children: [_jsx(_components.p, {\n children: \"This endpoint has the following functions:\"\n }), \"\\n\", _jsxs(_components.ul, {\n children: [\"\\n\", _jsx(_components.li, {\n children: \"Create a corresponding record in Pleo for any new vendor created in the ERP/accounting system.\"\n }), \"\\n\", _jsx(_components.li, {\n children: \"Create a new vendor in Pleo, without the record yet existing in the ERP/accounting system.\"\n }), \"\\n\"]\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":"post /v1/vendors","title":"Create a New Vendor","description":"This endpoint has the following functions:\n- Create a corresponding record in Pleo for any new vendor created in the ERP/accounting system.\n- Create a new vendor in Pleo, without the record yet existing in the ERP/accounting system.","href":"/reference/external-vendors/create-a-new-vendor"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["external-vendors"],"summary":"Create a New Vendor","description":"This endpoint has the following functions:\n- Create a corresponding record in Pleo for any new vendor created in the ERP/accounting system.\n- Create a new vendor in Pleo, without the record yet existing in the ERP/accounting system.","operationId":"postVendor","requestBody":"626fd2bd-949d-4f02-9e97-4b098745c804","responses":{"201":"a2781fab-b18f-41c1-b272-b13ecf83488f","409":"c5c26ba8-4c65-446c-96ce-328774e8cada"},"method":"post","type":"path","servers":["1d029dcd-7abd-4a16-8c79-a4c58ec41d56","090bddf0-fb1f-47bb-b5fe-8b8ab3fa7410"],"security":["e1158f28-2306-4a65-b30b-cfe3765b9740","a7e78d30-816f-4857-81aa-c72d4f836d39"],"path":"/v1/vendors","baseUrlOptions":["https://external.pleo.io","https://external.staging.pleo.io"],"title":"Create a New Vendor","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"content":{"application/json;charset=UTF-8":{"schema":{"required":["companyId","defaultCurrency","name"],"type":"object","properties":{"companyId":{"type":"string","description":"Pleo's internal identifier for the company the Vendor is associated with.","format":"uuid","example":"c082afd8-c1d2-46ee-8f56-1512638f0e67","isRequired":true,"uniqueKey":"companyId","typeLabel":"string\u003cuuid>"},"defaultCurrency":{"type":"string","description":"Default currency in which the vendor's financial operations,such as purchases, payments, or invoices, are primarily conducted. (ISO 4217 currency code (3 letters))","example":"DKK","isRequired":true,"uniqueKey":"defaultCurrency","typeLabel":"string"},"name":{"type":"string","description":"The name field represents the official name of the Vendor as it is recorded in the target ERP/accounting system. This name is used to uniquely identify the vendor within the accounting workflow and is visible to the Pleo bookkeeper.","example":"Pleo","isRequired":true,"uniqueKey":"name","typeLabel":"string"},"code":{"type":"string","description":"Account code assigned to the vendor in the target ERP/accounting system for aiding users in identifying the correct record.","uniqueKey":"code","typeLabel":"string"},"country":{"type":"string","description":"Country of registration of the Vendor (ISO 3166-1 alpha-2 country code (2 letters))","example":"DK","enum":["UNDEFINED","AC","AD","AE","AF","AG","AI","AL","AM","AN","AO","AQ","AR","AS","AT","AU","AW","AX","AZ","BA","BB","BD","BE","BF","BG","BH","BI","BJ","BL","BM","BN","BO","BQ","BR","BS","BT","BU","BV","BW","BY","BZ","CA","CC","CD","CF","CG","CH","CI","CK","CL","CM","CN","CO","CP","CR","CS","CU","CV","CW","CX","CY","CZ","DE","DG","DJ","DK","DM","DO","DZ","EA","EC","EE","EG","EH","ER","ES","ET","EU","EZ","FI","FJ","FK","FM","FO","FR","FX","GA","GB","GD","GE","GF","GG","GH","GI","GL","GM","GN","GP","GQ","GR","GS","GT","GU","GW","GY","HK","HM","HN","HR","HT","HU","IC","ID","IE","IL","IM","IN","IO","IQ","IR","IS","IT","JE","JM","JO","JP","KE","KG","KH","KI","KM","KN","KP","KR","KW","KY","KZ","LA","LB","LC","LI","LK","LR","LS","LT","LU","LV","LY","MA","MC","MD","ME","MF","MG","MH","MK","ML","MM","MN","MO","MP","MQ","MR","MS","MT","MU","MV","MW","MX","MY","MZ","NA","NC","NE","NF","NG","NI","NL","NO","NP","NR","NT","NU","NZ","OM","PA","PE","PF","PG","PH","PK","PL","PM","PN","PR","PS","PT","PW","PY","QA","RE","RO","RS","RU","RW","SA","SB","SC","SD","SE","SF","SG","SH","SI","SJ","SK","SL","SM","SN","SO","SR","SS","ST","SU","SV","SX","SY","SZ","TA","TC","TD","TF","TG","TH","TJ","TK","TL","TM","TN","TO","TP","TR","TT","TV","TW","TZ","UA","UG","UK","UM","US","UY","UZ","VA","VC","VE","VG","VI","VN","VU","WF","WS","XI","XU","XK","YE","YT","YU","ZA","ZM","ZR","ZW"],"uniqueKey":"country","typeLabel":"enum\u003cstring>"},"externalId":{"type":"string","description":"Unique external identifier of the vendor, assigned by the target ERP/accounting system, used by the client for identification. Can be the same as code if no other identifier is available.","uniqueKey":"externalId","typeLabel":"string"},"registrationNumber":{"type":"string","description":"Unique identification of a registered vendor in a country.","uniqueKey":"registrationNumber","typeLabel":"string"},"taxRegistrationNumber":{"type":"string","description":"VAT/GST/TaxId number of the Vendor.","uniqueKey":"taxRegistrationNumber","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"companyId":"c082afd8-c1d2-46ee-8f56-1512638f0e67","defaultCurrency":"DKK","name":"Pleo","code":"\u003cstring>","country":"DK","externalId":"\u003cstring>","registrationNumber":"\u003cstring>","taxRegistrationNumber":"\u003cstring>"}}},"exampleType":"generated"}},"required":true,"exampleType":"generated"},"responses":{"a2781fab-b18f-41c1-b272-b13ecf83488f":{"description":"New vendor created","content":{"application/json;charset=UTF-8":{"schema":{"required":["data"],"type":"object","properties":{"data":{"required":["companyId","defaultCurrency","id","name","state"],"type":"object","properties":{"companyId":{"type":"string","description":"Pleo's internal identifier for the company the Vendor is associated with.","format":"uuid","example":"c082afd8-c1d2-46ee-8f56-1512638f0e67","isRequired":true,"uniqueKey":"data.companyId","typeLabel":"string\u003cuuid>"},"defaultCurrency":{"maxLength":3,"minLength":3,"type":"string","description":"Default currency in which the vendor's financial operations,such as purchases, payments, or invoices, are primarily conducted. (ISO 4217 currency code (3 letters))","example":"DKK","isRequired":true,"uniqueKey":"data.defaultCurrency","typeLabel":"string"},"id":{"type":"string","description":"Pleo's internal identifier of the vendor.","format":"uuid","example":"123e4567-e89b-12d3-a456-426614174000","isRequired":true,"uniqueKey":"data.id","typeLabel":"string\u003cuuid>"},"name":{"type":"string","description":"The name field represents the official name of the Vendor as it is recorded in the target ERP/accounting system. This name is used to uniquely identify the vendor within the accounting workflow and is visible to the Pleo bookkeeper.","example":"Pleo","isRequired":true,"uniqueKey":"data.name","typeLabel":"string"},"state":{"type":"string","description":"Current state of the Vendor. ACTIVE means the vendor is in-sync with target ERP/accounting system. DRAFT means the vendor needs to be created in the target ERP/accounting system.","enum":["DRAFT","ACTIVE","ARCHIVED"],"isRequired":true,"uniqueKey":"data.state","typeLabel":"enum\u003cstring>"},"accountingSystem":{"type":"string","description":"The target ERP/accounting system the Vendor is associated with.","uniqueKey":"data.accountingSystem","typeLabel":"string"},"code":{"type":"string","description":"Account code assigned to the vendor in the target ERP/accounting system for aiding users in identifying the correct record.","uniqueKey":"data.code","typeLabel":"string"},"country":{"type":"string","description":"Country of registration of the Vendor (ISO 3166-1 alpha-2 country code (2 letters))","example":"DK","enum":["UNDEFINED","AC","AD","AE","AF","AG","AI","AL","AM","AN","AO","AQ","AR","AS","AT","AU","AW","AX","AZ","BA","BB","BD","BE","BF","BG","BH","BI","BJ","BL","BM","BN","BO","BQ","BR","BS","BT","BU","BV","BW","BY","BZ","CA","CC","CD","CF","CG","CH","CI","CK","CL","CM","CN","CO","CP","CR","CS","CU","CV","CW","CX","CY","CZ","DE","DG","DJ","DK","DM","DO","DZ","EA","EC","EE","EG","EH","ER","ES","ET","EU","EZ","FI","FJ","FK","FM","FO","FR","FX","GA","GB","GD","GE","GF","GG","GH","GI","GL","GM","GN","GP","GQ","GR","GS","GT","GU","GW","GY","HK","HM","HN","HR","HT","HU","IC","ID","IE","IL","IM","IN","IO","IQ","IR","IS","IT","JE","JM","JO","JP","KE","KG","KH","KI","KM","KN","KP","KR","KW","KY","KZ","LA","LB","LC","LI","LK","LR","LS","LT","LU","LV","LY","MA","MC","MD","ME","MF","MG","MH","MK","ML","MM","MN","MO","MP","MQ","MR","MS","MT","MU","MV","MW","MX","MY","MZ","NA","NC","NE","NF","NG","NI","NL","NO","NP","NR","NT","NU","NZ","OM","PA","PE","PF","PG","PH","PK","PL","PM","PN","PR","PS","PT","PW","PY","QA","RE","RO","RS","RU","RW","SA","SB","SC","SD","SE","SF","SG","SH","SI","SJ","SK","SL","SM","SN","SO","SR","SS","ST","SU","SV","SX","SY","SZ","TA","TC","TD","TF","TG","TH","TJ","TK","TL","TM","TN","TO","TP","TR","TT","TV","TW","TZ","UA","UG","UK","UM","US","UY","UZ","VA","VC","VE","VG","VI","VN","VU","WF","WS","XI","XU","XK","YE","YT","YU","ZA","ZM","ZR","ZW"],"uniqueKey":"data.country","typeLabel":"enum\u003cstring>"},"createdAt":{"type":"string","description":"The date and time when the vendor was created in Pleo.","format":"date-time","uniqueKey":"data.createdAt","typeLabel":"string\u003cdate-time>"},"externalId":{"type":"string","description":"Unique external identifier of the vendor, assigned by the target ERP/accounting system, used by the client for identification. Can be the same as code if no other identifier is available.","uniqueKey":"data.externalId","typeLabel":"string"},"registrationNumber":{"type":"string","description":"Unique identification of a registered vendor in a country.","uniqueKey":"data.registrationNumber","typeLabel":"string"},"taxRegistrationNumber":{"type":"string","description":"VAT/GST/TaxId number of the Vendor.","uniqueKey":"data.taxRegistrationNumber","typeLabel":"string"},"updatedAt":{"type":"string","description":"The date and time when the vendor details were updated (initially same as createdAt).","format":"date-time","uniqueKey":"data.updatedAt","typeLabel":"string\u003cdate-time>"}},"isRequired":true,"uniqueKey":"data","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"data":{"companyId":"c082afd8-c1d2-46ee-8f56-1512638f0e67","defaultCurrency":"DKK","id":"123e4567-e89b-12d3-a456-426614174000","name":"Pleo","state":"DRAFT","accountingSystem":"\u003cstring>","code":"\u003cstring>","country":"DK","createdAt":"2023-11-07T05:31:56Z","externalId":"\u003cstring>","registrationNumber":"\u003cstring>","taxRegistrationNumber":"\u003cstring>","updatedAt":"2023-11-07T05:31:56Z"}}}},"exampleType":"generated"}},"exampleType":"generated"},"c5c26ba8-4c65-446c-96ce-328774e8cada":{"description":"Vendor already exists","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}}},"security":{"e1158f28-2306-4a65-b30b-cfe3765b9740":{"bearerAuth":{"type":"http","description":"JWT Bearer token authentication. Include the token in the Authorization header as: `Bearer \u003ctoken>`","scheme":"bearer","bearerFormat":"JWT","scopes":[]}},"a7e78d30-816f-4857-81aa-c72d4f836d39":{"basicAuth":{"type":"http","description":"Basic HTTP authentication using API key. Use your API key as the username and leave the password empty. The credentials will be Base64 encoded automatically.","scheme":"basic","scopes":[]}}},"servers":{"1d029dcd-7abd-4a16-8c79-a4c58ec41d56":{"url":"https://external.pleo.io","description":"Production server"},"090bddf0-fb1f-47bb-b5fe-8b8ab3fa7410":{"url":"https://external.staging.pleo.io","description":"Staging server"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","description":"JWT Bearer token authentication. Include the token in the Authorization header as: `Bearer \u003ctoken>`","scheme":"bearer","bearerFormat":"JWT","scopes":[]},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"JWT Bearer token authentication. Include the token in the Authorization header as: `Bearer \u003ctoken>`","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"},{"schemes":[{"scheme":{"type":"http","description":"Basic HTTP authentication using API key. Use your API key as the username and leave the password empty. The credentials will be Base64 encoded automatically.","scheme":"basic","scopes":[]},"schema":{"title":"Basic Auth","type":"object","description":"Basic HTTP authentication using API key. Use your API key as the username and leave the password empty. The credentials will be Base64 encoded automatically.","isRequired":true,"properties":{"username":{"type":"string","uniqueKey":"username","isRequired":true,"typeLabel":"string","deprecated":false},"password":{"type":"string","uniqueKey":"password","isRequired":true,"typeLabel":"string","deprecated":false}},"additionalProperties":false,"deprecated":false},"schemeName":"basicAuth","name":"Authorization"}],"title":"basicAuth"}]},"originalFileLocation":"reference/Vendors API.json"},"subdomain":"pleo-61d4d38b","siteName":"Pleo Docs","title":"Create a New Vendor - Pleo Docs","contextualStarterQuestions":[{"_id":"6a2941e5d6d9baaf82cf4e1c","deploymentId":"68c825a5227dcad6bb288ea7","questionText":"What data is required to add vendors?","status":"active","generatedBy":"contextual","path":"reference/external-vendors/create-a-new-vendor","createdAt":"2026-06-10T10:52:21.611Z","updatedAt":"2026-06-10T10:52:21.611Z","__v":0},{"_id":"6a2941e5d6d9baaf82cf4e1b","deploymentId":"68c825a5227dcad6bb288ea7","questionText":"Can I sync vendors from ERP?","status":"active","generatedBy":"contextual","path":"reference/external-vendors/create-a-new-vendor","createdAt":"2026-06-10T10:52:21.611Z","updatedAt":"2026-06-10T10:52:21.611Z","__v":0},{"_id":"6a2941e5d6d9baaf82cf4e1a","deploymentId":"68c825a5227dcad6bb288ea7","questionText":"How do I create a vendor?","status":"active","generatedBy":"contextual","path":"reference/external-vendors/create-a-new-vendor","createdAt":"2026-06-10T10:52:21.611Z","updatedAt":"2026-06-10T10:52:21.611Z","__v":0}],"navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-01-22T07:31:02.075Z","originalFileLocation":"reference/external-vendors/create-a-new-vendor.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 has the following functions: - Create a corresponding record in Pleo for any new vendor created in the ERP/accounting system. - Create a new vendor in Pleo, without the record yet existing in the ERP/accounting system.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Pleo Docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/pleo-61d4d38b/zKRuSzeccuPGu0vR/_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/pleo-61d4d38b/zKRuSzeccuPGu0vR/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/pleo-61d4d38b/zKRuSzeccuPGu0vR/_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/pleo-61d4d38b/zKRuSzeccuPGu0vR/_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/pleo-61d4d38b/zKRuSzeccuPGu0vR/_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/pleo-61d4d38b/zKRuSzeccuPGu0vR/_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/pleo-61d4d38b/zKRuSzeccuPGu0vR/_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/pleo-61d4d38b/zKRuSzeccuPGu0vR/_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/pleo-61d4d38b/zKRuSzeccuPGu0vR/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Create a New Vendor - Pleo Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"This endpoint has the following functions: - Create a corresponding record in Pleo for any new vendor created in the ERP/accounting system. - Create a new vendor in Pleo, without the record yet existing in the ERP/accounting system.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Pleo Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://developers.pleo.io/reference/external-vendors/create-a-new-vendor\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://pleo-61d4d38b.mintlify.app/_mintlify/api/og/v2?division=Vendors+API\u0026amp;title=Create+a+New+Vendor\u0026amp;description=This+endpoint+has+the+following+functions%3A%0A-+Create+a+corresponding+record+in+Pleo+for+any+new+vendor+created+in+the+ERP%2Faccounting+system.%0A-+Create+a+new+vendo\u0026amp;theme=2e297d5e519a5f48b072c145\u0026amp;signature=8e038d2ac4ccfd089276ad3aeceb36f307b64daec1faa51e185ee2ddb0d7d0a6\">\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 a New Vendor - Pleo Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"This endpoint has the following functions: - Create a corresponding record in Pleo for any new vendor created in the ERP/accounting system. - Create a new vendor in Pleo, without the record yet existing in the ERP/accounting system.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://pleo-61d4d38b.mintlify.app/_mintlify/api/og/v2?division=Vendors+API\u0026amp;title=Create+a+New+Vendor\u0026amp;description=This+endpoint+has+the+following+functions%3A%0A-+Create+a+corresponding+record+in+Pleo+for+any+new+vendor+created+in+the+ERP%2Faccounting+system.%0A-+Create+a+new+vendo\u0026amp;theme=2e297d5e519a5f48b072c145\u0026amp;signature=8e038d2ac4ccfd089276ad3aeceb36f307b64daec1faa51e185ee2ddb0d7d0a6\">\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/pleo-61d4d38b/zKRuSzeccuPGu0vR/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Pleo Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#FEB6FE\">\u003clink data-mint-head rel=\"canonical\" href=\"https://developers.pleo.io/reference/external-vendors/create-a-new-vendor\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/reference/external-vendors/create-a-new-vendor.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://developers.pleo.io/#organization\",\"name\":\"Pleo Docs\",\"url\":\"https://developers.pleo.io\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/pleo-61d4d38b/0im2PqYmwpP-taWp/logo/pleo-developers-light.svg?fit=max\u0026auto=format\u0026n=0im2PqYmwpP-taWp\u0026q=85\u0026s=c000128fc6805d6e5d279ec0fdc06880\"}},{\"@type\":\"WebSite\",\"@id\":\"https://developers.pleo.io#website\",\"name\":\"Pleo Docs\",\"url\":\"https://developers.pleo.io\",\"publisher\":{\"@id\":\"https://developers.pleo.io/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://developers.pleo.io/reference/external-vendors/create-a-new-vendor#webpage\",\"url\":\"https://developers.pleo.io/reference/external-vendors/create-a-new-vendor\",\"name\":\"Create a New Vendor\",\"description\":\"This endpoint has the following functions: - Create a corresponding record in Pleo for any new vendor created in the ERP/accounting system. - Create a new vendor in Pleo, without the record yet existing in the ERP/accounting system.\",\"dateModified\":\"2026-01-22T07:31:02.075Z\",\"isPartOf\":{\"@id\":\"https://developers.pleo.io#website\"},\"breadcrumb\":{\"@id\":\"https://developers.pleo.io/reference/external-vendors/create-a-new-vendor#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://developers.pleo.io/reference/external-vendors/create-a-new-vendor#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"VENDORS API\",\"item\":\"https://developers.pleo.io/reference/vendor/vendors-api-overview\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Create a New Vendor\",\"item\":\"https://developers.pleo.io/reference/external-vendors/create-a-new-vendor\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://developers.pleo.io/reference/external-vendors/create-a-new-vendor#apireference\",\"headline\":\"Create a New Vendor\",\"name\":\"Create a New Vendor\",\"description\":\"This endpoint has the following functions: - Create a corresponding record in Pleo for any new vendor created in the ERP/accounting system. - Create a new vendor in Pleo, without the record yet existing in the ERP/accounting system.\",\"url\":\"https://developers.pleo.io/reference/external-vendors/create-a-new-vendor\",\"mainEntityOfPage\":{\"@id\":\"https://developers.pleo.io/reference/external-vendors/create-a-new-vendor#webpage\"},\"dateModified\":\"2026-01-22T07:31:02.075Z\",\"publisher\":{\"@id\":\"https://developers.pleo.io/#organization\"},\"isPartOf\":{\"@id\":\"https://developers.pleo.io#website\"}}]}\u003c/script>","siteName":"Pleo Docs","nav":{"global":null,"tabs":[{"tab":"Home","pages":[{"title":"Home","href":""}]},{"tab":"Build with Pleo","pages":[{"title":"Build with Pleo","href":"/docs/current/getting-started/what-is-pleo"}]},{"tab":"AS/ERP","pages":[{"title":"AS/ERP","href":"/docs/current/getting-started/accounting-integrations-quickstart"}]},{"tab":"API Reference","dropdowns":[{"dropdown":"API 1","icon":"code","groups":[{"group":"ABOUT THE PLEO API","pages":[{"title":"Introduction","href":"/reference/api-introduction"},{"title":"Authentication","url":"/docs/authentication-authorisation-introduction","href":"/reference/authentication"},{"title":"Metadata","href":"/reference/metadata-1"},{"title":"Request IDs","href":"/reference/request-ids-1"},{"title":"Pagination","href":"/reference/pagination"},{"title":"API Response Codes | Errors","href":"/reference/api-response-codes-errors-1"}]},{"group":"ACCOUNTING ENTRIES API","pages":[{"title":"Overview","href":"/reference/accounting-entries/accounting-entry-overview"},{"title":"Scopes","href":"/reference/accounting-entries/scopes"},{"group":"Accounting Entries API v1","pages":[{"openapi":"get /v1/accounting-entries/{accountingEntryId}","title":"Fetch a single accounting entry by id. ","href":"/reference/accounting-entries/v1/get-accounting-entry-by-id"},{"openapi":"post /v1/accounting-entries:search","title":"Fetch accounting entries based on filters. ","href":"/reference/accounting-entries/v1/search-accounting-entries"},{"openapi":"get /v1/accounting-entries/{accountingEntryId}/receipts","title":"Get all receipts of an accounting entry.","href":"/reference/accounting-entries/v1/get-all-receipts"},{"openapi":"get /v1/accounting-entries/{accountingEntryId}/receipts/{receiptId}","title":"Returns a receipt with time-bound access to the receipt file.","href":"/reference/accounting-entries/v1/get-receipt-file"},{"openapi":"post /v1/accounting-entries/receipts:search","title":"Apply filters to search for specific accounting entry receipts.","href":"/reference/accounting-entries/v1/search-receipts-by-post"}]}]},{"group":"EXPORT API","pages":[{"title":"Export API Overview","href":"/reference/export-api/export-api-overview"},{"title":"Export API Scopes","href":"/reference/export-api/export-api-scopes"},{"title":"Vendor Tagging in Export Items","href":"/reference/export-api/vendor-tagging-in-export-items"},{"title":"Multi Currency Configuration","href":"/reference/export-api/multi-currency-configuration"},{"title":"Export API Workflow","href":"/reference/export-api/export-api-workflow"},{"group":"Export API (v3)","pages":[{"openapi":"post /v3/export-job-events","title":"Create an Export Job Event","href":"/reference/export-api/export-api-v3/create-an-export-job-event"},{"openapi":"get /v3/export-jobs","title":"Get a list of Export Jobs","href":"/reference/export-api/export-api-v3/get-a-list-of-export-jobs"},{"openapi":"post /v3/export-jobs","title":"Create a new export job","href":"/reference/export-api/export-api-v3/create-a-new-export-job"},{"openapi":"get /v3/export-jobs/{jobId}","title":"Get an Export Job","href":"/reference/export-api/export-api-v3/get-an-export-job"},{"openapi":"get /v3/export-jobs/{jobId}/items","title":"Get Export Job Items","href":"/reference/export-api/export-api-v3/get-export-job-items"},{"openapi":"put /v3/export-jobs/{jobId}/items","title":"Update Export Job Items","href":"/reference/export-api/export-api-v3/update-export-job-items"},{"openapi":"get /v3/export-items","title":"Get Export Items","href":"/reference/export-api/export-items-v3/get-export-items"}]},{"group":"Export API (v2)","pages":[{"openapi":"post /v2/export-job-events","title":"Create an Export Job Event","href":"/reference/export-api/export-api-v2/create-an-export-job-event"},{"openapi":"get /v2/export-jobs","title":"Get a list of Export Jobs","href":"/reference/export-api/export-api-v2/get-a-list-of-export-jobs"},{"openapi":"post /v2/export-jobs","title":"Create a new export job","href":"/reference/export-api/export-api-v2/create-a-new-export-job"},{"openapi":"get /v2/export-jobs/{jobId}","title":"Get an Export Job","href":"/reference/export-api/export-api-v2/get-an-export-job"},{"openapi":"get /v2/export-jobs/{jobId}/items","title":"Get Export Job Items","href":"/reference/export-api/export-api-v2/get-export-job-items"},{"openapi":"put /v2/export-jobs/{jobId}/items","title":"Update Export Job Items","href":"/reference/export-api/export-api-v2/update-export-job-items"},{"openapi":"get /v2/export-items","title":"Get Export Items","href":"/reference/export-api/export-items-v2/get-export-items"}]},{"group":"Export API (v1)","pages":[{"openapi":"post /v1/export-job-events","deprecated":true,"title":"Create an Export Job Event","href":"/reference/export-api/export-api-v1/create-an-export-job-event"},{"openapi":"get /v1/export-jobs","deprecated":true,"title":"Get a list of Export Jobs","href":"/reference/export-api/export-api-v1/get-a-list-of-export-jobs"},{"openapi":"post /v1/export-jobs","deprecated":true,"title":"Create a new export job","href":"/reference/export-api/export-api-v1/create-a-new-export-job"},{"openapi":"get /v1/export-jobs/{jobId}","deprecated":true,"title":"Get an Export Job","href":"/reference/export-api/export-api-v1/get-an-export-job"},{"openapi":"get /v1/export-jobs/{jobId}/items","deprecated":true,"title":"Get Export Job Items","href":"/reference/export-api/export-api-v1/get-export-job-items"},{"openapi":"put /v1/export-jobs/{jobId}/items","deprecated":true,"title":"Update Export Job Items","href":"/reference/export-api/export-api-v1/update-export-job-items"}]},{"group":"Export Items (v1)","pages":[{"openapi":"get /v1/export-items","deprecated":true,"title":"Get Export Items","href":"/reference/export-api/export-items-v1/get-export-items"}]}]},{"group":"TAGS API","pages":[{"title":"Overview","href":"/reference/tags-overview"},{"title":"Scopes","href":"/reference/scopes-2"},{"group":"Tag Groups","pages":[{"openapi":"get /v0/aggregations/tag-groups","title":"Returns all tag groups for given company in an aggregated format","href":"/reference/tags-api/tag-groups/returns-all-tag-groups-for-given-company-in-an-aggregated-format"},{"openapi":"get /v0/aggregations/tag-groups/{groupId}","title":"Returns an aggregated tag group by its ID","href":"/reference/tags-api/tag-groups/returns-an-aggregated-tag-group-by-its-id"},{"openapi":"get /v0/tag-groups","title":"Returns all tag groups for given company","href":"/reference/tags-api/tag-groups/returns-all-tag-groups-for-given-company"},{"openapi":"post /v0/tag-groups","title":"Creates a new tag group resource","href":"/reference/tags-api/tag-groups/creates-a-new-tag-group-resource"},{"openapi":"get /v0/tag-groups/{groupId}","title":"Returns the tag group resource by id","href":"/reference/tags-api/tag-groups/returns-the-tag-group-resource-by-id"},{"openapi":"put /v0/tag-groups/{groupId}","title":"Updates the tag group resource by id","href":"/reference/tags-api/tag-groups/updates-the-tag-group-resource-by-id"},{"openapi":"delete /v0/tag-groups/{groupId}","title":"Deletes the tag group resource by id","href":"/reference/tags-api/tag-groups/deletes-the-tag-group-resource-by-id"},{"openapi":"get /v0/tag-groups/{groupId}/dimensions","title":"Get a list of tag group dimensions","href":"/reference/tags-api/tag-groups/get-a-list-of-tag-group-dimensions"},{"openapi":"post /v0/tag-groups/{groupId}/dimensions","title":"Creates a new tag group dimension","href":"/reference/tags-api/tag-groups/creates-a-new-tag-group-dimension"},{"openapi":"get /v0/tag-groups/{groupId}/dimensions/{dimensionId}","title":"Get a tag group dimension","href":"/reference/tags-api/tag-groups/get-a-tag-group-dimension"},{"openapi":"put /v0/tag-groups/{groupId}/dimensions/{dimensionId}","title":"Update a tag group dimension","href":"/reference/tags-api/tag-groups/update-a-tag-group-dimension"},{"openapi":"delete /v0/tag-groups/{groupId}/dimensions/{dimensionId}","title":"Delete a tag group dimension","href":"/reference/tags-api/tag-groups/delete-a-tag-group-dimension"}]},{"group":"Tags","pages":[{"openapi":"post /v0/aggregations/tags","title":"Search and return aggregated tags","href":"/reference/tags-api/tags/search-and-return-aggregated-tags"},{"openapi":"get /v0/tag-groups/{groupId}/tags","title":"Returns tags for given tag group","href":"/reference/tags-api/tags/returns-tags-for-given-tag-group"},{"openapi":"post /v0/tag-groups/{groupId}/tags","title":"Creates a new tag sub-resource under the given tag group","href":"/reference/tags-api/tags/creates-a-new-tag-sub-resource-under-the-given-tag-group"},{"openapi":"get /v0/tags","title":"Search tags","href":"/reference/tags-api/tags/search-tags"},{"openapi":"get /v0/tags/{tagId}","title":"Returns tag by id","href":"/reference/tags-api/tags/returns-tag-by-id"},{"openapi":"put /v0/tags/{tagId}","title":"Updates tag by id","href":"/reference/tags-api/tags/updates-tag-by-id"},{"openapi":"delete /v0/tags/{tagId}","title":"Deletes tag by id","href":"/reference/tags-api/tags/deletes-tag-by-id"},{"openapi":"get /v0/tags/{tagId}/dimensions","title":"Fetches dimension values","href":"/reference/tags-api/tags/fetches-dimension-values"},{"openapi":"get /v0/tags/{tagId}/dimensions/{dimensionId}","title":"Gets a dimension value","href":"/reference/tags-api/tags/gets-a-dimension-value"},{"openapi":"put /v0/tags/{tagId}/dimensions/{dimensionId}","title":"Updates a dimension value","href":"/reference/tags-api/tags/updates-a-dimension-value"},{"openapi":"post /v0/tags/{tagId}/dimensions/{dimensionId}","title":"Creates a dimension value","href":"/reference/tags-api/tags/creates-a-dimension-value"},{"openapi":"delete /v0/tags/{tagId}/dimensions/{dimensionId}","title":"Deletes a dimension value","href":"/reference/tags-api/tags/deletes-a-dimension-value"}]}]},{"group":"ENRICHMENT API","pages":[{"title":"Overview","href":"/reference/enrichment-api/enrichment-api-overview"},{"title":"Scopes","href":"/reference/enrichment-api/enrichment-api-scopes"},{"title":"Enrichment Workflow Quick Guide","href":"/reference/enrichment-api/enrichment-workflow-basic-guide"},{"group":"Enrichment API (v2)","pages":[{"title":"Enrich Accounting Entry","openapi":"post /v2/accounting-entries:enrich","href":"/reference/enrichment-api/enrichment-api-v2/enrich-accounting-entry"}]}]},{"group":"TAX CODE API","pages":[{"title":"Overview","href":"/reference/tax-codes-overview"},{"title":"Scopes","href":"/reference/scopes-3"},{"group":"Tax Codes","pages":[{"openapi":"post /v0/tax-codes","title":"Create a new tax code","href":"/reference/tax-codes/create-a-new-tax-code"},{"openapi":"get /v0/tax-codes/{taxCodeId}","title":"Returns a given tax code","href":"/reference/tax-codes/returns-a-given-tax-code"},{"openapi":"put /v0/tax-codes/{taxCodeId}","title":"Update an tax code","href":"/reference/tax-codes/update-an-tax-code"},{"openapi":"delete /v0/tax-codes/{taxCodeId}","title":"Delete an tax code","href":"/reference/tax-codes/delete-an-tax-code"},{"openapi":"post /v0/tax-codes:search","title":"Returns a list of tax codes","href":"/reference/tax-codes/returns-a-list-of-tax-codes"}]}]},{"group":"TEAMS API","pages":[{"title":"Team API Overview","href":"/reference/teams/teams-api-overview"},{"title":"Scopes","href":"/reference/teams/teams-api-scopes"},{"group":"Teams","pages":[{"openapi":"post /v1/teams/{teamId}/members","title":"Add members to a Team","href":"/reference/teams/add-team-members"},{"openapi":"post /v1/teams","title":"Create a Team","href":"/reference/teams/create-a-team"},{"openapi":"delete /v1/teams/{teamId}","title":"Delete a Team by ID","href":"/reference/teams/delete-a-team"},{"openapi":"get /v1/teams/{teamId}","title":"Get a Team by ID","href":"/reference/teams/get-a-team-by-id"},{"openapi":"get /v1/teams","title":"Search for teams","href":"/reference/teams/search-for-teams"},{"openapi":"delete /v1/teams/{teamId}/members/{employeeId}","title":"Remove a member from a Team","href":"/reference/teams/remove-a-team-member"},{"openapi":"patch /v1/teams/{teamId}","title":"Partially update a Team","href":"/reference/teams/update-a-team"}]}]},{"group":"APP MARKETPLACE API","pages":[{"title":"Overview","href":"/reference/marketplace/marketplace-overview"},{"title":"Migrating from /completions to /me:activate","href":"/reference/marketplace/installations-completions-migration"},{"group":"Installations","pages":[{"openapi":"put /v1/installations/completions","deprecated":true,"title":"Complete the installation of a client","href":"/reference/installations/complete-the-installation-of-a-client"},{"openapi":"get /v1/installations/me","title":"Get client installation","href":"/reference/installations/get-client-installation"},{"openapi":"put /v1/installations/me","title":"Update a client installation","href":"/reference/installations/update-a-client-installation"},{"openapi":"post /v1/installations/me","title":"Create a client installation","href":"/reference/installations/create-a-client-installation"},{"openapi":"delete /v1/installations/me","title":"Delete client's installation","href":"/reference/installations/delete-clients-installation"},{"openapi":"post /v1/installations/me:activate","title":"Activate the installation for a client","href":"/reference/installations/activate-the-installation-for-a-client"}]},{"group":"External Clients","pages":[{"openapi":"get /v1/introspect","title":"Introspect the details of the current authentication.","href":"/reference/external-clients/introspect-the-details-of-the-current-authentication"}]}]},{"group":"EMPLOYEES API","pages":[{"title":"Overview","href":"/reference/employees/employees-api-overview"},{"title":"Scopes","href":"/reference/employees/employees-api-scopes"},{"group":"Employees","pages":[{"openapi":"get /v2/employees","title":"Search for employees","href":"/reference/employees/search-for-employees"},{"openapi":"get /v2/employees/{employeeId}","title":"Search for a specific employee","href":"/reference/employees/search-for-a-specific-employee"}]}]},{"group":"CHART OF ACCOUNTS API","pages":[{"title":"Overview","href":"/reference/accounts/chart-of-accounts-api-overview"},{"title":"Scopes","href":"/reference/accounts/chart-of-accounts-api-scopes"},{"group":"Accounts","pages":[{"openapi":"post /v1/chart-of-accounts","title":"Create a new account","href":"/reference/accounts/create-a-new-account"},{"openapi":"get /v1/chart-of-accounts/{accountId}","title":"Retrieve an account in Pleo by its ID","href":"/reference/accounts/retrieve-an-account-in-pleo-by-its-id"},{"openapi":"put /v1/chart-of-accounts/{accountId}","title":"Update an account","href":"/reference/accounts/update-an-account"},{"openapi":"delete /v1/chart-of-accounts/{accountId}","title":"Delete an account","href":"/reference/accounts/delete-an-account"},{"openapi":"post /v1/chart-of-accounts:search","title":"Fetch a list of accounts","href":"/reference/accounts/fetch-a-list-of-accounts"},{"openapi":"post /v1/chart-of-accounts/batch","title":"Create multiple accounts in a single request","href":"/reference/accounts/create-multiple-accounts-in-a-single-request"}]}]},{"group":"BOOKKEEPING CATEGORIES API","pages":[{"title":"Overview","href":"/reference/categories/bookkeeping-categories-api-overview"},{"title":"Scopes","href":"/reference/categories/bookkeeping-categories-api-scopes"},{"group":"Categories","pages":[{"openapi":"post /v1/bookkeeping-categories","title":"Create a new bookkeeping category","href":"/reference/bookkeeping-categories/create-a-new-bookkeeping-category"},{"openapi":"get /v1/bookkeeping-categories/{categoryId}","title":"Retrieve a bookkeeping category by its ID","href":"/reference/bookkeeping-categories/retrieve-a-bookkeeping-category-by-its-id"},{"openapi":"put /v1/bookkeeping-categories/{categoryId}","title":"Update a bookkeeping category","href":"/reference/bookkeeping-categories/update-a-bookkeeping-category"},{"openapi":"delete /v1/bookkeeping-categories/{categoryId}","title":"Delete a bookkeeping category","href":"/reference/bookkeeping-categories/delete-a-bookkeeping-category"},{"openapi":"post /v1/bookkeeping-categories:search","title":"Fetch a list of bookkeeping categories","href":"/reference/bookkeeping-categories/fetch-a-list-of-bookkeeping-categories"}]},{"group":"Category groups","pages":[{"openapi":"post /v1/bookkeeping-category-groups","title":"Create a new bookkeeping category group","href":"/reference/bookkeeping-category-groups/create-a-new-bookkeeping-category-group"},{"openapi":"get /v1/bookkeeping-category-groups/{categoryGroupId}","title":"Retrieve a bookkeeping category group by its ID","href":"/reference/bookkeeping-category-groups/retrieve-a-bookkeeping-category-group-by-its-id"},{"openapi":"put /v1/bookkeeping-category-groups/{categoryGroupId}","title":"Update a bookkeeping category group","href":"/reference/bookkeeping-category-groups/update-a-bookkeeping-category-group"},{"openapi":"delete /v1/bookkeeping-category-groups/{categoryGroupId}","title":"Delete a bookkeeping category group","href":"/reference/bookkeeping-category-groups/delete-a-bookkeeping-category-group"},{"openapi":"post /v1/bookkeeping-category-groups:search","title":"Fetch a list of bookkeeping category groups","href":"/reference/bookkeeping-category-groups/fetch-a-list-of-bookkeeping-category-groups"}]},{"group":"Category aggregations","pages":[{"openapi":"get /v1/bookkeeping-category-aggregations","title":"Get aggregated bookkeeping category groups","href":"/reference/bookkeeping-category-aggregations/get-aggregated-bookkeeping-category-groups"}]}]},{"group":"COMPANY BALANCE API","pages":[{"title":"Overview","href":"/reference/company-balance/company-balance-api-overview"},{"title":"Scopes","href":"/reference/company-balance/company-balance-api-scopes"},{"openapi":"get /v1/companies/{companyId}/balance","title":"Get the balance for a company","href":"/reference/company-balance/get-the-balance-for-a-company"}]},{"group":"WEBHOOK SUBSCRIPTIONS API","pages":[{"title":"Overview","href":"/reference/webhooks/overview-webhooks"},{"title":"Authentication and Authorisation","href":"/reference/webhooks/webhooks-authentication-authorisation"},{"group":"Subscriptions","pages":[{"title":"Subscriptions","href":"/reference/webhooks/subscriptions"},{"openapi":"get /v1/subscriptions","title":"Get subscriptions","href":"/reference/subscriptions/get-subscriptions"},{"openapi":"post /v1/subscriptions","title":"Create a subscription","href":"/reference/subscriptions/create-a-subscription"},{"openapi":"get /v1/subscriptions/{id}","title":"Get subscription by id","href":"/reference/subscriptions/get-subscription-by-id"},{"openapi":"put /v1/subscriptions/{id}","title":"Update a subscription","href":"/reference/subscriptions/update-a-subscription"},{"openapi":"delete /v1/subscriptions/{id}","title":"Delete subscription by id","href":"/reference/subscriptions/delete-subscription-by-id"},{"openapi":"get /v1/subscriptions/{id}/activities","title":"Get subscription activities","href":"/reference/subscriptions/get-subscription-activities"},{"openapi":"get /v1/subscriptions/{id}/secret","title":"Get subscription secret by id","href":"/reference/subscriptions/get-subscription-secret-by-id"}]},{"title":"Webhook Events","href":"/reference/webhooks/webhook-events"}]},{"group":"COMPANIES API","pages":[{"title":"Company API Overview","href":"/reference/companies/companies-api-overview"},{"title":"Scopes","href":"/reference/companies/companies-api-scopes"},{"group":"Companies","pages":[{"openapi":"get /v1/companies","title":"Search for Companies","href":"/reference/companies/search-for-companies"},{"openapi":"get /v1/companies/{companyId}","title":"Search for a Specific Company","href":"/reference/companies/search-for-a-specific-company"}]}]},{"group":"VENDORS API","pages":[{"title":"Overview","href":"/reference/vendor/vendors-api-overview"},{"title":"Vendor API Scopes","description":"The following table specifies the scopes required to access the Vendors API endpoints:","href":"/reference/vendor/vendor-api-scopes"},{"group":"Vendors API","pages":[{"openapi":"post /v1/vendors","title":"Create a New Vendor","href":"/reference/external-vendors/create-a-new-vendor"},{"openapi":"get /v1/vendors/{id}","title":"Retrieves a Vendor in Pleo by its id","description":"Retrieves a Vendor in Pleo by its id.","href":"/reference/external-vendors/retrieves-a-vendor-in-pleo-by-its-id"},{"openapi":"put /v1/vendors/{id}","title":"Update a Vendor","href":"/reference/external-vendors/update-a-vendor"},{"openapi":"post /v1/vendors/{id}:activate","title":"Activate a Vendor","href":"/reference/external-vendors/activate-a-vendor"},{"openapi":"post /v1/vendors/{id}:archive","title":"Archive a Vendor","href":"/reference/external-vendors/archive-a-vendor"},{"openapi":"post /v1/vendors:search","title":"Fetches Vendors by search criteria","href":"/reference/external-vendors/fetches-vendors-by-search-criteria"}]}]},{"group":"PLEO.IO API (DEPRECATED)","pages":[{"title":"Deprecation and Migration Information","href":"/reference/notice"},{"title":"Authentication for the Legacy API","icon":"circle-exclamation","href":"/reference/authentication-legacy"},{"title":"Attribute explanations","icon":"circle-exclamation","href":"/reference/attribute-explanations"},{"title":"Request ID's","icon":"circle-exclamation","href":"/reference/request-ids"},{"title":"Errors","icon":"circle-exclamation","href":"/reference/errors"},{"title":"Versioning","icon":"circle-exclamation","href":"/reference/versioning"},{"title":"FAQ","icon":"circle-exclamation","href":"/reference/faq-1"},{"title":"Postman Collection","icon":"circle-exclamation","href":"/reference/open-api"},{"group":"HealthCheck","icon":"circle-exclamation","pages":[{"openapi":"get /health","deprecated":true,"title":"Returns healtcheck status of OpenAPIs for a given company","href":"/reference/pleo-deprecated/healthcheck/returns-healtcheck-status-of-openapis-for-a-given-company"}]},{"group":"Expenses","icon":"circle-exclamation","pages":[{"openapi":"get /expenses/{expenseId}","deprecated":true,"title":"Get an expense for a company","href":"/reference/pleo-deprecated/expenses/get-an-expense-for-a-company"},{"openapi":"get /expenses","deprecated":true,"title":"Get expenses for a company","href":"/reference/pleo-deprecated/expenses/get-expenses-for-a-company"},{"openapi":"put /expenses","deprecated":true,"title":"Update a given list of expenses. ","href":"/reference/pleo-deprecated/expenses/update-a-given-list-of-expenses"}]},{"group":"Tag Groups","icon":"circle-exclamation","pages":[{"openapi":"get /tag-groups","deprecated":true,"title":"Get all tag groups belonging to the specified company.","href":"/reference/pleo-deprecated/tag-groups/get-all-tag-groups-belonging-to-the-specified-company"},{"openapi":"post /tag-groups","deprecated":true,"title":"Create a new tag group.","href":"/reference/pleo-deprecated/tag-groups/create-a-new-tag-group"},{"openapi":"get /tag-groups/{tagGroupId}","deprecated":true,"title":"Get a tag group","href":"/reference/pleo-deprecated/tag-groups/get-a-tag-group"},{"openapi":"delete /tag-groups/{tagGroupId}","deprecated":true,"title":"Delete or archive a tag group.","href":"/reference/pleo-deprecated/tag-groups/delete-or-archive-a-tag-group"},{"openapi":"patch /tag-groups/{tagGroupId}","deprecated":true,"title":"Update a tag group","href":"/reference/pleo-deprecated/tag-groups/update-a-tag-group"},{"openapi":"get /tag-groups/{tagGroupId}/tags","deprecated":true,"title":"Get all tags for a specified tag group","href":"/reference/pleo-deprecated/tag-groups/get-all-tags-for-a-specified-tag-group"},{"openapi":"post /tag-groups/{tagGroupId}/tags","deprecated":true,"title":"Create a new tag","href":"/reference/pleo-deprecated/tag-groups/create-a-new-tag"},{"openapi":"get /tag-groups/{tagGroupId}/tags/{tagId}","deprecated":true,"title":"Get a tag from a tag group","href":"/reference/pleo-deprecated/tag-groups/get-a-tag-from-a-tag-group"},{"openapi":"delete /tag-groups/{tagGroupId}/tags/{tagId}","deprecated":true,"title":"Delete a tag","href":"/reference/pleo-deprecated/tag-groups/delete-a-tag"},{"openapi":"patch /tag-groups/{tagGroupId}/tags/{tagId}","deprecated":true,"title":"Update a tag","href":"/reference/pleo-deprecated/tag-groups/update-a-tag"}]},{"group":"Company","icon":"circle-exclamation","pages":[{"openapi":"get /companies/balance","deprecated":true,"title":"Get company account balance","href":"/reference/pleo-deprecated/company/get-company-account-balance"}]},{"group":"Receipts","icon":"circle-exclamation","pages":[{"openapi":"get /expenses/{expenseId}/receipts","deprecated":true,"title":"Get expense receipts","href":"/reference/pleo-deprecated/receipts/get-expense-receipts"},{"openapi":"get /expenses/{expenseId}/receipts/{receiptId}","deprecated":true,"title":"Get an expense receipt","href":"/reference/pleo-deprecated/receipts/get-an-expense-receipt"}]},{"group":"Employees","icon":"circle-exclamation","pages":[{"openapi":"get /employees/{employeeId}","deprecated":true,"title":"Get an employee for a company","href":"/reference/pleo-deprecated/employees/get-an-employee-for-a-company"},{"openapi":"put /employees/{employeeId}","deprecated":true,"title":"Update an employee for a company","href":"/reference/pleo-deprecated/employees/update-an-employee-for-a-company"},{"openapi":"delete /employees/{employeeId}","deprecated":true,"title":"Delete an employee for a company","href":"/reference/pleo-deprecated/employees/delete-an-employee-for-a-company"},{"openapi":"get /employees","deprecated":true,"title":"Get company employees","href":"/reference/pleo-deprecated/employees/get-company-employees"},{"openapi":"post /employees","deprecated":true,"title":"Create an employee for a company","href":"/reference/pleo-deprecated/employees/create-an-employee-for-a-company"}]},{"group":"Accounts","icon":"circle-exclamation","pages":[{"openapi":"get /accounts/{accountId}","deprecated":true,"title":"Get an account for a company","href":"/reference/pleo-deprecated/accounts/get-an-account-for-a-company"},{"openapi":"put /accounts/{accountId}","deprecated":true,"title":"Update an account for a company","href":"/reference/pleo-deprecated/accounts/update-an-account-for-a-company"},{"openapi":"delete /accounts/{accountId}","deprecated":true,"title":"Delete an account for a company","href":"/reference/pleo-deprecated/accounts/delete-an-account-for-a-company"},{"openapi":"get /accounts","deprecated":true,"title":"Get company accounts","href":"/reference/pleo-deprecated/accounts/get-company-accounts"},{"openapi":"post /accounts","deprecated":true,"title":"Create an account for a company","href":"/reference/pleo-deprecated/accounts/create-an-account-for-a-company"},{"openapi":"get /account-groups","deprecated":true,"title":"Get all company account groups","href":"/reference/pleo-deprecated/accounts/get-all-company-account-groups"},{"openapi":"post /account-groups","deprecated":true,"title":"Create an account group for a company","href":"/reference/pleo-deprecated/accounts/create-an-account-group-for-a-company"},{"openapi":"get /account-groups/{accountCategoryId}","deprecated":true,"title":"Get an account group for a company","href":"/reference/pleo-deprecated/accounts/get-an-account-group-for-a-company"},{"openapi":"put /account-groups/{accountCategoryId}","deprecated":true,"title":"Update an account group for a company","href":"/reference/pleo-deprecated/accounts/update-an-account-group-for-a-company"},{"openapi":"delete /account-groups/{accountCategoryId}","deprecated":true,"title":"Delete an account group for a company","href":"/reference/pleo-deprecated/accounts/delete-an-account-group-for-a-company"}]},{"group":"Experimental","icon":"circle-exclamation","pages":[{"openapi":"get /account-categories","deprecated":true,"title":"Get all company account groups","href":"/reference/pleo-deprecated/experimental/get-all-company-account-groups"},{"openapi":"post /account-categories","deprecated":true,"title":"Create an account group for a company","href":"/reference/pleo-deprecated/experimental/create-an-account-group-for-a-company"},{"openapi":"get /account-categories/{accountCategoryId}","deprecated":true,"title":"Get an account group for a company","href":"/reference/pleo-deprecated/experimental/get-an-account-group-for-a-company"},{"openapi":"put /account-categories/{accountCategoryId}","deprecated":true,"title":"Update an account group for a company","href":"/reference/pleo-deprecated/experimental/update-an-account-group-for-a-company"},{"openapi":"delete /account-categories/{accountCategoryId}","deprecated":true,"title":"Delete an account group for a company","href":"/reference/pleo-deprecated/experimental/delete-an-account-group-for-a-company"}]},{"group":"Teams","icon":"circle-exclamation","pages":[{"openapi":"get /teams","deprecated":true,"title":"Get all teams for a company","href":"/reference/pleo-deprecated/teams/get-all-teams-for-a-company"},{"openapi":"post /teams","deprecated":true,"title":"Create a team for a company","href":"/reference/pleo-deprecated/teams/create-a-team-for-a-company"},{"openapi":"get /teams/{teamId}","deprecated":true,"title":"Get a team for a company","href":"/reference/pleo-deprecated/teams/get-a-team-for-a-company"},{"openapi":"put /teams/{teamId}","deprecated":true,"title":"Update a team for a company","href":"/reference/pleo-deprecated/teams/update-a-team-for-a-company"},{"openapi":"delete /teams/{teamId}","deprecated":true,"title":"Delete a team for a company","href":"/reference/pleo-deprecated/teams/delete-a-team-for-a-company"},{"openapi":"put /teams/{teamId}/employees/{employeeId}","deprecated":true,"title":"Add an employee to a team","href":"/reference/pleo-deprecated/teams/add-an-employee-to-a-team"},{"openapi":"delete /teams/{teamId}/employees/{employeeId}","deprecated":true,"title":"Remove an employee from a team","href":"/reference/pleo-deprecated/teams/remove-an-employee-from-a-team"}]},{"group":"Tax Codes","icon":"circle-exclamation","pages":[{"openapi":"get /tax-codes/{taxCodeId}","deprecated":true,"title":"Get a tax code for a company","href":"/reference/pleo-deprecated/tax-codes/get-a-tax-code-for-a-company"},{"openapi":"get /tax-codes","deprecated":true,"title":"Get tax codes for a company","href":"/reference/pleo-deprecated/tax-codes/get-tax-codes-for-a-company"}]}]}]}]},{"tab":"Pleo MCP","pages":[{"title":"Pleo MCP","href":"/docs/current/pleo-mcp/get-started/pleo-mcp-overview"}]},{"tab":"Changelog","pages":[{"title":"Changelog","href":"/changelog"}]},{"tab":"Deprecation and Migration","pages":[{"title":"Deprecation and Migration","href":"/deprecation/overview"}]},{"tab":"Terms of Service","pages":[{"title":"Terms of Service","href":"/page/terms-of-service"}]}]},"title":"Create a New Vendor - Pleo Docs","buildId":"dpl_EnxDqhjaNc9a8MVa833TGULPd9uJ","deploymentId":"dpl_EnxDqhjaNc9a8MVa833TGULPd9uJ","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-26-lDe7V.js","utils-CWQmgYtH.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-4-Aw3rSD.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-C2zjXYA5.js","snippetPresets-DFmpFA7C.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-FJpQavWq.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-D_GvPF7k.js","shallow-Bs2ZB0NO.js","getApiPlaygroundDisplay-DCcqJJk-.js","CodeSnippet-DzDxawVe.js","CodeSnippets-aUr7fU-7.js","Page-CT9uE8Ip.js","getPastedJson-Y1fKsj_I.js","icon-DI4zTsDr.js","MethodPill-C0nDlmSQ.js","DuplicateIcon-NUXbx2nQ.js","createIcon-BdTHrPAi.js","DynamicMarkdown-CtpgKJwj.js","SectionHeading-B3x35tOt.js","axios-vUo_bRtp.js","Markdown-3OmurJMP.js","clsx-DMKzROTp.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-1ms6tsT-.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-Ke9xIMFx.js"]}