{
"success": true,
"message": "",
"error_code": "",
"errors": {},
"data": {
"message": "No data found!"
}
}
Customers
Update customer mapping
Re-links your customer IDs to existing Swipe records in bulk. Use this after changing IDs in your own system, so future calls don’t create duplicate customers.
Bearer authentication header of the form Bearer <token>, where <token> is an API key from the API Integration section of your dashboard. Keys are scoped to the company they are generated in — for testing, add a separate test company and generate the key there, so requests never touch your real books.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Swipe","colors":{"primary":"#2045D1","light":"#538DFF","dark":"#2045D1"},"logo":{"light":"https://mintcdn.com/swipe/DQkaOg10KeYQlKIu/logo/logo_g_light.webp?fit=max\u0026auto=format\u0026n=DQkaOg10KeYQlKIu\u0026q=85\u0026s=44d5e4b626518cb3542e8ef16e85f182","dark":"https://mintcdn.com/swipe/DQkaOg10KeYQlKIu/logo/logo_g_dark.webp?fit=max\u0026auto=format\u0026n=DQkaOg10KeYQlKIu\u0026q=85\u0026s=84cf20e2bc4f85a8fea2938d2f43412e","href":"/"},"favicon":"https://mintcdn.com/swipe/ZOyvFX50eH4DT_Wr/favicon.svg?fit=max\u0026auto=format\u0026n=ZOyvFX50eH4DT_Wr\u0026q=85\u0026s=9f4476cef1667d0c527f72dd6036726b","api":{"playground":{"display":"interactive"},"examples":{"defaults":"required","languages":["curl","python","javascript"]}},"navbar":{"links":[{"href":"https://app.getswipe.in/user?tab=api_integration","label":"Support"}],"primary":{"type":"button","label":"Dashboard","href":"https://app.getswipe.in"}},"footer":{"socials":{"x":"https://twitter.com/swipebilling","instagram":"https://www.instagram.com/swipebilling","linkedin":"https://www.linkedin.com/company/swipebilling"}},"search":{"prompt":"Search the Swipe API docs..."},"seo":{"metatags":{"og:site_name":"Swipe API Documentation","og:type":"website"}},"errors":{"404":{"redirect":true}},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"styling":{"latex":false},"navigation":{"global":{"anchors":[{"anchor":"Run in Postman","icon":{"style":"thin","name":"user-astronaut"},"href":"https://god.gw.postman.com/run-collection/43895811-b7327b9d-1e50-4fed-af6f-660a918aa817?action=collection%2Ffork\u0026source=rip_markdown\u0026collection-url=entityId%3D43895811-b7327b9d-1e50-4fed-af6f-660a918aa817%26entityType%3Dcollection%26workspaceId%3D5d3fc3f0-668c-499e-833b-03222666ba2a"},{"anchor":"Blog","icon":"newspaper","href":"https://getswipe.in/blog"},{"anchor":"Community","icon":"slack","href":"https://community.getswipe.in/c/api-integration/14"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"swipe","hasAudioNarration":false,"actualSubdomain":"swipe","customDomains":["developers.getswipe.in"],"gitSource":{"type":"github","owner":"swipe-yc21","repo":"partner-api-docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6aa158f50379420e6579534a","collectionId":"9e7e6d91-a01b-44eb-b79d-efe99a4644f3","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6aa158f50379420e6579534a"},"entitlements":{},"buildId":"6aa158f50379420e6579534a","clientVersion":"0.0.3990","searchFilterCounts":[{"language":"default","tag":"Documentation","count":74},{"language":"default","tag":"Guides","count":10},{"language":"default","tag":"Customers","count":7},{"language":"default","tag":"Customer","count":7},{"language":"default","tag":"Vendors","count":7},{"language":"default","tag":"Documents","count":6},{"language":"default","tag":"Products","count":6},{"language":"default","tag":"Product","count":6},{"language":"default","tag":"Get Started","count":5},{"language":"default","tag":"Resources","count":4}]},"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/customer-v2/update-customer-mapping","slug":"/api-reference/customer-v2/update-customer-mapping","pageMetadata":{"openapi":"post /v2/customer/list","title":"Update customer mapping","description":"Re-links your customer IDs to existing Swipe records in bulk. Use this after changing IDs in your own system, so future calls don't create duplicate customers.","href":"/api-reference/customer-v2/update-customer-mapping"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Re-links your customer IDs to existing Swipe records in bulk. Use this after changing IDs in your own system, so future calls don’t create duplicate customers.\"\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 /v2/customer/list","title":"Update customer mapping","description":"Re-links your customer IDs to existing Swipe records in bulk. Use this after changing IDs in your own system, so future calls don't create duplicate customers.","href":"/api-reference/customer-v2/update-customer-mapping"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"summary":"Update customer mapping","operationId":"post_customer_list","tags":["Customer V2"],"requestBody":"1e06cad5-52c5-4092-a2ac-7263f34bb55f","responses":{"200":"25b2e86c-deb8-413a-adfd-cfc901892927","400":"fec3a9fd-602e-4602-b15c-98f77af18f42","401":"51b43329-d348-4851-a3ab-d4ce8a889a5f","409":"055e6f9f-9bc3-4203-a4bb-585fa448bcee","500":"ab547b85-5580-41c0-b531-446b7887b121"},"description":"Re-links your customer IDs to existing Swipe records in bulk. Use this after changing IDs in your own system, so future calls don't create duplicate customers.","method":"post","type":"path","servers":["82b38fec-7303-4b6e-86bb-63d990b1e4ef"],"security":["13576f02-530d-4f08-aab7-91987ee153ab"],"path":"/v2/customer/list","baseUrlOptions":["https://app.getswipe.in/api/partner"],"title":"Update customer mapping","codeSamples":[],"requestExampleLanguages":["bash","python","javascript"],"requiredOnlyExamples":true,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"content":{"application/json":{"schema":{"required":["customer_mapping"],"properties":{"customer_mapping":{"type":"array","items":{"required":["customer_id","swipe_id"],"properties":{"customer_id":{"type":"string","description":"Customer ID","isRequired":true,"uniqueKey":"customer_mapping.items.[INDEX].customer_id","typeLabel":"string"},"swipe_id":{"type":"string","description":"Swipe ID","example":1,"isRequired":true,"uniqueKey":"customer_mapping.items.[INDEX].swipe_id","typeLabel":"string"},"force_update":{"type":"boolean","description":"Updates even if the customer id is already mapped with other swipe id, no customer details will be updated","example":true,"uniqueKey":"customer_mapping.items.[INDEX].force_update","typeLabel":"boolean"}},"type":"object","uniqueKey":"customer_mapping.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"customer_mapping","typeLabel":"object[]"}},"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"customer_mapping":[{"customer_id":"\u003cstring>","swipe_id":1,"force_update":true}]}}},"exampleType":"generated"}},"required":true,"exampleType":"generated"},"responses":{"25b2e86c-deb8-413a-adfd-cfc901892927":{"description":"Updated successfully","content":{"application/json":{"schema":{"properties":{"success":{"type":"boolean","description":"Success flag","example":true,"uniqueKey":"success","typeLabel":"boolean"},"message":{"type":"string","description":"Response message","example":"","uniqueKey":"message","typeLabel":"string"},"error_code":{"type":"string","description":"Error Code","example":"","uniqueKey":"error_code","typeLabel":"string"},"errors":{"type":"object","description":"Errors","uniqueKey":"errors","typeLabel":"object"},"data":{"properties":{"message":{"type":"string","description":"Response message","example":"No data found!","uniqueKey":"data.message","typeLabel":"string"}},"type":"object","uniqueKey":"data","typeLabel":"object"}},"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"success":true,"message":"","error_code":"","errors":{},"data":{"message":"No data found!"}}}},"exampleType":"generated"}},"exampleType":"generated"},"fec3a9fd-602e-4602-b15c-98f77af18f42":{"description":"Error in mapping Customer List","content":{"application/json":{"schema":{"properties":{"success":{"type":"boolean","description":"Success flag","example":true,"uniqueKey":"success","typeLabel":"boolean"},"message":{"type":"string","description":"Response message","example":"","uniqueKey":"message","typeLabel":"string"},"error_code":{"type":"string","description":"Error Code","example":"","uniqueKey":"error_code","typeLabel":"string"},"errors":{"type":"object","description":"Errors","uniqueKey":"errors","typeLabel":"object"},"data":{"properties":{"message":{"type":"string","description":"Response message","example":"No data found!","uniqueKey":"data.message","typeLabel":"string"}},"type":"object","uniqueKey":"data","typeLabel":"object"}},"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"success":true,"message":"","error_code":"","errors":{},"data":{"message":"No data found!"}}}},"exampleType":"generated"}},"exampleType":"generated"},"51b43329-d348-4851-a3ab-d4ce8a889a5f":{"description":"Unauthorized","content":{"application/json":{"schema":{"properties":{"success":{"type":"boolean","description":"Success flag","example":true,"uniqueKey":"success","typeLabel":"boolean"},"message":{"type":"string","description":"Response message","example":"","uniqueKey":"message","typeLabel":"string"},"error_code":{"type":"string","description":"Error Code","example":"","uniqueKey":"error_code","typeLabel":"string"},"errors":{"type":"object","description":"Errors","uniqueKey":"errors","typeLabel":"object"},"data":{"properties":{"message":{"type":"string","description":"Response message","example":"No data found!","uniqueKey":"data.message","typeLabel":"string"}},"type":"object","uniqueKey":"data","typeLabel":"object"}},"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"success":true,"message":"","error_code":"","errors":{},"data":{"message":"No data found!"}}}},"exampleType":"generated"}},"exampleType":"generated"},"055e6f9f-9bc3-4203-a4bb-585fa448bcee":{"description":"Error in mapping Customer List","content":{"application/json":{"schema":{"properties":{"success":{"type":"boolean","description":"Success flag","example":true,"uniqueKey":"success","typeLabel":"boolean"},"message":{"type":"string","description":"Response message","example":"Message","uniqueKey":"message","typeLabel":"string"},"error_code":{"type":"string","description":"Error Code","example":"","uniqueKey":"error_code","typeLabel":"string"},"errors":{"type":"object","description":"Errors","uniqueKey":"errors","typeLabel":"object"},"data":{"type":"object","description":"Data","uniqueKey":"data","typeLabel":"object"}},"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"success":true,"message":"Message","error_code":"","errors":{},"data":{}}}},"exampleType":"generated"}},"exampleType":"generated"},"ab547b85-5580-41c0-b531-446b7887b121":{"description":"Internal Server Error","content":{"application/json":{"schema":{"properties":{"success":{"type":"boolean","description":"Success flag","example":true,"uniqueKey":"success","typeLabel":"boolean"},"message":{"type":"string","description":"Response message","example":"","uniqueKey":"message","typeLabel":"string"},"error_code":{"type":"string","description":"Error Code","example":"","uniqueKey":"error_code","typeLabel":"string"},"errors":{"type":"object","description":"Errors","uniqueKey":"errors","typeLabel":"object"},"data":{"properties":{"message":{"type":"string","description":"Response message","example":"No data found!","uniqueKey":"data.message","typeLabel":"string"}},"type":"object","uniqueKey":"data","typeLabel":"object"}},"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"success":true,"message":"","error_code":"","errors":{},"data":{"message":"No data found!"}}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"13576f02-530d-4f08-aab7-91987ee153ab":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Bearer authentication header of the form `Bearer \u003ctoken>`, where `\u003ctoken>` is an API key from the [API Integration](https://app.getswipe.in/user?tab=api_integration) section of your dashboard. Keys are scoped to the company they are generated in — for testing, [add a separate test company](https://community.getswipe.in/t/how-to-add-new-company-on-web/1191) and generate the key there, so requests never touch your real books.","scopes":[]}}},"servers":{"82b38fec-7303-4b6e-86bb-63d990b1e4ef":{"url":"https://app.getswipe.in/api/partner"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Bearer authentication header of the form `Bearer \u003ctoken>`, where `\u003ctoken>` is an API key from the [API Integration](https://app.getswipe.in/user?tab=api_integration) section of your dashboard. Keys are scoped to the company they are generated in — for testing, [add a separate test company](https://community.getswipe.in/t/how-to-add-new-company-on-web/1191) and generate the key there, so requests never touch your real books.","scopes":[]},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Bearer authentication header of the form `Bearer \u003ctoken>`, where `\u003ctoken>` is an API key from the [API Integration](https://app.getswipe.in/user?tab=api_integration) section of your dashboard. Keys are scoped to the company they are generated in — for testing, [add a separate test company](https://community.getswipe.in/t/how-to-add-new-company-on-web/1191) and generate the key there, so requests never touch your real books.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"}]},"originalFileLocation":"api-reference/openapi.json"},"subdomain":"swipe","siteName":"Swipe","title":"Update customer mapping - Swipe","navMaps":{"firstHrefInVersion":{"v2":{"href":"/api-reference/customer-v2/update-customer-mapping","matchLevel":0},"v1 (Deprecated)":{"href":"/api-reference/customer/update-customer-mapping","matchLevel":1}},"firstHrefInLanguage":{}},"lastModified":"2026-08-27T07:51:52.670Z","originalFileLocation":"api-reference/customer-v2/update-customer-mapping.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=\"Re-links your customer IDs to existing Swipe records in bulk. Use this after changing IDs in your own system, so future calls don\u0026#x27;t create duplicate customers.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Swipe\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/swipe/c1cYpNBFxkNdbDrf/_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/swipe/c1cYpNBFxkNdbDrf/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/swipe/c1cYpNBFxkNdbDrf/_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/swipe/c1cYpNBFxkNdbDrf/_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/swipe/c1cYpNBFxkNdbDrf/_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/swipe/c1cYpNBFxkNdbDrf/_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/swipe/c1cYpNBFxkNdbDrf/_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/swipe/c1cYpNBFxkNdbDrf/_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/swipe/c1cYpNBFxkNdbDrf/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Update customer mapping - Swipe\">\u003cmeta data-mint-head property=\"og:description\" content=\"Re-links your customer IDs to existing Swipe records in bulk. Use this after changing IDs in your own system, so future calls don\u0026#x27;t create duplicate customers.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Swipe API Documentation\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://developers.getswipe.in/api-reference/customer-v2/update-customer-mapping\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://swipe.mintlify.app/_mintlify/api/og/v2?division=Customers\u0026amp;title=Update+customer+mapping\u0026amp;description=Re-links+your+customer+IDs+to+existing+Swipe+records+in+bulk.+Use+this+after+changing+IDs+in+your+own+system%2C+so+future+calls+don%27t+create+duplicate+customers.\u0026amp;theme=6f6d44835af80bcfb7f23dbb\u0026amp;signature=51103b2c3d8bde89f517253f7cd70fec0aaacb002f1ff877648f60a31ec3aa1d\">\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=\"Update customer mapping - Swipe\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Re-links your customer IDs to existing Swipe records in bulk. Use this after changing IDs in your own system, so future calls don\u0026#x27;t create duplicate customers.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://swipe.mintlify.app/_mintlify/api/og/v2?division=Customers\u0026amp;title=Update+customer+mapping\u0026amp;description=Re-links+your+customer+IDs+to+existing+Swipe+records+in+bulk.+Use+this+after+changing+IDs+in+your+own+system%2C+so+future+calls+don%27t+create+duplicate+customers.\u0026amp;theme=6f6d44835af80bcfb7f23dbb\u0026amp;signature=51103b2c3d8bde89f517253f7cd70fec0aaacb002f1ff877648f60a31ec3aa1d\">\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/swipe/c1cYpNBFxkNdbDrf/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Swipe\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#2045D1\">\u003clink data-mint-head rel=\"canonical\" href=\"https://developers.getswipe.in/api-reference/customer-v2/update-customer-mapping\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/customer-v2/update-customer-mapping.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://developers.getswipe.in/#organization\",\"name\":\"Swipe\",\"url\":\"https://developers.getswipe.in\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/swipe/DQkaOg10KeYQlKIu/logo/logo_g_light.webp?fit=max\u0026auto=format\u0026n=DQkaOg10KeYQlKIu\u0026q=85\u0026s=44d5e4b626518cb3542e8ef16e85f182\"}},{\"@type\":\"WebSite\",\"@id\":\"https://developers.getswipe.in#website\",\"name\":\"Swipe\",\"url\":\"https://developers.getswipe.in\",\"publisher\":{\"@id\":\"https://developers.getswipe.in/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://developers.getswipe.in/api-reference/customer-v2/update-customer-mapping#webpage\",\"url\":\"https://developers.getswipe.in/api-reference/customer-v2/update-customer-mapping\",\"name\":\"Update customer mapping\",\"description\":\"Re-links your customer IDs to existing Swipe records in bulk. Use this after changing IDs in your own system, so future calls don't create duplicate customers.\",\"dateModified\":\"2026-08-27T07:51:52.670Z\",\"isPartOf\":{\"@id\":\"https://developers.getswipe.in#website\"},\"breadcrumb\":{\"@id\":\"https://developers.getswipe.in/api-reference/customer-v2/update-customer-mapping#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://developers.getswipe.in/api-reference/customer-v2/update-customer-mapping#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Customers\",\"item\":\"https://developers.getswipe.in/api-reference/customer-v2/add-a-customer\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Update customer mapping\",\"item\":\"https://developers.getswipe.in/api-reference/customer-v2/update-customer-mapping\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://developers.getswipe.in/api-reference/customer-v2/update-customer-mapping#apireference\",\"headline\":\"Update customer mapping\",\"name\":\"Update customer mapping\",\"description\":\"Re-links your customer IDs to existing Swipe records in bulk. Use this after changing IDs in your own system, so future calls don't create duplicate customers.\",\"url\":\"https://developers.getswipe.in/api-reference/customer-v2/update-customer-mapping\",\"mainEntityOfPage\":{\"@id\":\"https://developers.getswipe.in/api-reference/customer-v2/update-customer-mapping#webpage\"},\"dateModified\":\"2026-08-27T07:51:52.670Z\",\"publisher\":{\"@id\":\"https://developers.getswipe.in/#organization\"},\"isPartOf\":{\"@id\":\"https://developers.getswipe.in#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Swipe\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Swipe","nav":{"global":{"anchors":[{"anchor":"Run in Postman","icon":{"style":"thin","name":"user-astronaut"},"href":"https://god.gw.postman.com/run-collection/43895811-b7327b9d-1e50-4fed-af6f-660a918aa817?action=collection%2Ffork\u0026source=rip_markdown\u0026collection-url=entityId%3D43895811-b7327b9d-1e50-4fed-af6f-660a918aa817%26entityType%3Dcollection%26workspaceId%3D5d3fc3f0-668c-499e-833b-03222666ba2a"},{"anchor":"Blog","icon":"newspaper","href":"https://getswipe.in/blog"},{"anchor":"Community","icon":"slack","href":"https://community.getswipe.in/c/api-integration/14"}]},"versions":[{"version":"v2","anchors":[{"anchor":"Documentation","icon":"book-open","groups":[{"group":"Get Started","pages":[{"title":"Introduction","icon":"rocket","href":"/introduction"},{"title":"Quickstart","icon":"play","href":"/quickstart"},{"title":"Authentication","icon":"key","href":"/authentication"},{"title":"API Conventions","icon":"list-check","href":"/api-conventions"},{"title":"Build with AI","icon":"robot","href":"/build-with-ai"}]},{"group":"Guides","pages":[{"title":"Documents","icon":"file-invoice","href":"/document"},{"title":"Customers","icon":"users","href":"/customer"},{"title":"Vendors","icon":"building","href":"/vendor"},{"title":"Payments","icon":"credit-card","href":"/payment"},{"title":"Products","icon":"boxes-stacked","href":"/product"},{"title":"Inventory","icon":"warehouse","href":"/inventory"},{"title":"Subscriptions","icon":"repeat","href":"/subscriptions"},{"title":"E-Way Bills","icon":"truck-fast","href":"/ewaybills"},{"title":"E-Invoices","icon":"file-circle-check","href":"/einvoices"},{"title":"Webhooks","icon":"bolt","href":"/webhooks"}]},{"group":"Resources","pages":[{"title":"Error Codes","icon":"triangle-exclamation","href":"/api-reference/error-codes"},{"title":"Tax Codes (TDS \u0026 TCS)","icon":"percent","href":"/api-reference/tax-codes"},{"title":"Currencies, States \u0026 Countries","icon":"globe","href":"/api-reference/reference-data"},{"title":"Change Log","icon":"clock-rotate-left","href":"/api-reference/change-log"}]},{"group":"Documents","pages":[{"openapi":"post /v2/doc","title":"Create a document","href":"/api-reference/document-v2/create-a-document"},{"openapi":"get /v2/doc/{doc_hash_id}","title":"Get a document","href":"/api-reference/document-v2/get-a-document"},{"openapi":"get /v2/doc/pdf/{doc_hash_id}","title":"Get document PDF","href":"/api-reference/document-v2/get-document-pdf"},{"openapi":"put /v2/doc/{doc_hash_id}","title":"Edit a document","href":"/api-reference/document-v2/edit-a-document"},{"openapi":"delete /v2/doc/{doc_hash_id}","title":"Cancel a document","href":"/api-reference/document-v2/cancel-a-document"},{"openapi":"get /v2/doc/list","title":"List of documents","href":"/api-reference/document-v2/list-of-documents"}]},{"group":"Payments","pages":[{"openapi":"post /v2/payment","title":"Record payment","href":"/api-reference/payment-v2/record-payment"},{"openapi":"get /v2/payment/list","title":"List of payments","href":"/api-reference/payment-v2/list-of-payments"}]},{"group":"E-Way Bills","pages":[{"openapi":"post /v2/ewaybill/{doc_hash_id}","title":"Create e-way bill","href":"/api-reference/ewaybill/create-eway-bill"},{"openapi":"get /v2/ewaybill/pdf/{doc_hash_id}","title":"Get e-way bill PDF","href":"/api-reference/ewaybill/get-ewaybill-pdf"}]},{"group":"Customers","pages":[{"openapi":"post /v2/customer","title":"Add a customer","href":"/api-reference/customer-v2/add-a-customer"},{"openapi":"get /v2/customer/{customer_id}","title":"Get customer details","href":"/api-reference/customer-v2/get-customer-details"},{"openapi":"put /v2/customer","title":"Update a customer","href":"/api-reference/customer-v2/update-a-customer"},{"openapi":"delete /v2/customer/{customer_id}","title":"Delete a customer","href":"/api-reference/customer-v2/delete-a-customer"},{"openapi":"get /v2/customer/ledger","title":"Get payment ledger","href":"/api-reference/customer-v2/get-payment-ledger"},{"openapi":"get /v2/customer/list","title":"Get list of customers","description":"Lists your customers with their basic details.","href":"/api-reference/customer-v2/get-list-of-customers"},{"openapi":"post /v2/customer/list","title":"Update customer mapping","href":"/api-reference/customer-v2/update-customer-mapping"}]},{"group":"Vendors","pages":[{"openapi":"post /v2/vendor","title":"Add a vendor","description":"Creates a vendor keyed by your own `id`. Vendors are the parties on purchase-side documents. They are also created automatically when a document references an unknown vendor `party.id`.","href":"/api-reference/vendor-v2/add-a-vendor"},{"openapi":"get /v2/vendor/{vendor_id}","title":"Get vendor details","href":"/api-reference/vendor-v2/get-vendor-details"},{"openapi":"put /v2/vendor","title":"Update a vendor","href":"/api-reference/vendor-v2/update-a-vendor"},{"openapi":"delete /v2/vendor/{vendor_id}","title":"Delete a vendor","href":"/api-reference/vendor-v2/delete-a-vendor"},{"openapi":"get /v2/vendor/ledger","title":"Get payment ledger","href":"/api-reference/vendor-v2/get-payment-ledger"},{"openapi":"get /v2/vendor/list","title":"Get list of vendors","href":"/api-reference/vendor-v2/get-list-of-vendors"},{"openapi":"post /v2/vendor/list","title":"Update vendor mapping","href":"/api-reference/vendor-v2/update-vendor-mapping"}]},{"group":"Products","pages":[{"openapi":"post /v2/product","title":"Add an item","href":"/api-reference/product-v2/add-an-item"},{"openapi":"get /v2/product/{item_id}","title":"Get item details","href":"/api-reference/product-v2/get-item-details"},{"openapi":"put /v2/product","title":"Update an item","href":"/api-reference/product-v2/update-an-item"},{"openapi":"delete /v2/product/{item_id}","title":"Delete an item","href":"/api-reference/product-v2/delete-an-item"},{"openapi":"get /v2/product/list","title":"Get list of items","href":"/api-reference/product-v2/get-list-of-items"},{"openapi":"post /v2/product/list","title":"Update items mapping","href":"/api-reference/product-v2/update-items-mapping"}]},{"group":"Inventory","pages":[{"openapi":"post /v2/inventory/stock","title":"Update inventory stock","href":"/api-reference/inventory-v2/inventory-stock-in-out"},{"openapi":"get /v2/inventory/warehouses/list","title":"Get all warehouses","href":"/api-reference/inventory-v2/get-all-warehouses"}]},{"group":"Subscriptions","pages":[{"openapi":"get /v2/subscriptions/list","title":"List of subscriptions","href":"/api-reference/subscriptions-v2/list-of-subscriptions"},{"openapi":"get /v2/subscriptions/{subscription_hash_id}","title":"Get subscription details","href":"/api-reference/subscriptions-v2/get-subscription-details"}]},{"group":"Utility","pages":[{"openapi":"get /v2/utils/gstin/{gstin}","title":"Get GSTIN details","href":"/api-reference/utility-v2/get-gstin-v2"}]}]}]},{"version":"v1 (Deprecated)","pages":[{"title":"v1 (Deprecated)","href":"/api-reference/customer/update-customer-mapping"}]}]},"title":"Update customer mapping - Swipe","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"]}