{"activeVersionTag":"latest","latestAvailableVersionTag":"latest","collection":{"info":{"_postman_id":"999fea89-452e-4d7e-b8a7-30c98d92d902","name":"Multivende Integration Services","description":"Multivende Integration Services (MIS) allows clients or third-party applications to interact with the user's information in a standard way. To connect using OAuth 2.0, you must first have a developer account and create your application. To learn how to create your account, please contact [api@multivende.com](https://null)\n\n# Getting started with the REST API\n\nLearn how to use the Multivende REST API.\n\n### Step 1. Implements the connection using Oauth2.0\n\nThis connection allows you to grant permissions from the merchant account to your application and generate an **authorization code**. You have two options to connect your application to a Multivende merchant account:\n\n#### Option 1: Using a graphical interface from your system\n\nFollow the instructions in this article:  \n[https://help.multivende.com/hc/es-419/articles/13698734687501-Configuración-de-Autenticación-OAuth2-Todo-lo-que-necesitas-saber](https://help.multivende.com/hc/es-419/articles/13698734687501-Configuraci%C3%B3n-de-Autenticaci%C3%B3n-OAuth2-Todo-lo-que-necesitas-saber)\n\n#### Option 2: Using the Developers platform by setting the merchant account ID in your app\n\nIf your integration or system does **not** include a graphical interface, follow this article to link a merchant account to your app:  \n[https://help.multivende.com/hc/es-419/articles/29109021397773--Cómo-generar-authorization-code-sin-interfaz-gráfica](https://help.multivende.com/hc/es-419/articles/29109021397773--C%C3%B3mo-generar-authorization-code-sin-interfaz-gr%C3%A1fica)\n\n---\n\nAt this point, you should have the following parameters:\n\n- **Client ID**\n    \n- **Client Secret**\n    \n- **Code (Authorization Code)**\n    \n\n---\n\n### 🔐 Obtain an access token\n\nUse the parameters above to request a valid token that will allow you to make API calls. The {{base_url}} pointing to [https://app.multivende.com](https://app.multivende.com).\n\n- Use the `POST Authenticate OAuth2` [endpoint](https://dev.multivende.com/#1894fcd3-ed03-4f5d-88b8-6b8d29f564cc) to obtain the access token.\n    \n- Implement token refresh using the `POST Refresh token OAuth2` [endpoint](https://dev.multivende.com/#64a040fc-8937-4c1d-a334-80348054ea65).\n    \n\n---\n\n### Step 2. Make your first test API call\n\nOnce you have a valid `access_token`, you can begin interacting with the Multivende API. The first recommended step is to validate that authentication is working correctly by making a test call.\n\nYou can start testing the integration using an account where the `{{base_url}}` points to:  \n[<b>https://app.multivende.com</b>](https://app.multivende.com)\n\n---\n\n#### 📘 Example: Get application information\n\nThis endpoint allows you to validate that the token works and that you have access to the API.\n\n``` json\nGET {{base_url}}/api/d/info\n\n ```\n\nResponse 200:\n\n``` json\n{\n  \"_id\": \"9c4e3348-c58e-48d2-b083-xxxxxxxxxxx\",\n  \"MerchantId\": \"xxxxxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx\",\n  \"DeveloperApp\": {\n    \"_id\": \"72c5a8f6-91a0-46d5-b9d7-xxxxxxxxxxx\",\n    \"displayName\": \"app test\",\n    \"name\": \"app test\",\n    \"code\": \"app_test\",\n    \"visibility\": \"private\",\n    \"updatedAt\": \"2021-03-27T18:39:34.000Z\",\n    \"createdById\": \"444755c9-fcb6-45f2-8ac3-xxxxxxxxxxx\",\n    \"updatedById\": \"444755c9-fcb6-45f2-8ac3-xxxxxxxxxxx\",\n    \"status\": \"created\"\n  },\n  \"scopes\": {\n    \"read:products\": true,\n    \"write:products\": true,\n    \"read:clients\": true,\n    \"write:clients\": true,\n    \"manage:clients\": true,\n    \"read:warehouses\": {\n      \"all\": true\n    },\n    \"write:warehouses\": {\n      \"all\": true\n    },\n    \"manage:warehouses\": true,\n    \"read:stocks\": {\n      \"all\": true\n    },\n    \"write:stocks\": {\n      \"all\": true\n    },\n    \"read:prices\": {\n      \"all\": true\n    },\n    \"write:prices\": {\n      \"all\": true\n    },\n    \"read:checkouts\": {\n      \"all\": true\n    },\n    \"write:checkouts\": {\n      \"all\": true\n    },\n    \"read:product_links\": {\n      \"all\": true\n    },\n    \"write:product_links\": {\n      \"all\": true\n    },\n    \"manage:checkouts\": true,\n    \"manage:product_links\": true,\n    \"read:couriers\": {\n      \"all\": true\n    },\n    \"write:couriers\": {\n      \"all\": true\n    }\n  },\n  \"MarketplaceConnection\": {\n    \"_name\": \"app test\",\n    \"_id\": \"052a4518-899c-4d9d-9ebb-xxxxxxxxxxx\",\n    \"name\": \"app test\",\n    \"provider\": \"app_test\",\n    \"createdAt\": \"2021-04-22T22:29:04.000Z\",\n    \"updatedAt\": \"2021-04-22T22:29:04.000Z\",\n    \"createdById\": \"d0699084-6054-4f27-b779-xxxxxxxxxxx\",\n    \"updatedById\": \"d0699084-6054-4f27-b779-xxxxxxxxxxx\",\n    \"status\": \"created\",\n    \"MerchantAppId\": \"9c4e3348-c58e-48d2-b083-xxxxxxxxxxx\"\n  }\n}\n\n ```\n\nIf you get a successful response from this call, your authentication is working, and you are ready to start consuming the rest of the API.\n\n---\n\n✅ _If you receive this response successfully, your authentication is working and you’re ready to consume the rest of the API!_\n\n# Overview\n\nMIS allows to interact with several aspects of the users' account. Usually it will allow to interact with stock, prices, products and checkouts.\n\nYou can start testing the integration using an account with the {{base_url}} pointing to [https://app.multivende.com](https://app.multivende.com).\n\n# Authentication\n\nAn access token must be provided in every request. The access token is attached to a user, and the client can invite as many users as they want.\n\n# General info for the requests\n\nThe requests must have Content-Type: application/x-www-form-urlencoded. All the responses are in JSON format.\n\n# Pagination\n\nMost endpoints returning lists will actually return an object containing the property \"entries\" with the result as array and a property \"pagination\" with the information needed to move back and forth through the array. Arrays will list mostly 50 items per page. The first page is the numbered \"1\".\n\n# Error Codes\n\nStandard HTTP errors should be expected.\n\n# Rate limit\n\n**Request limit 5 rps**. Through the response header \"**x-im-request-count**\" the number of requests made per second is notified and \"x-im-request-limit\" to know the limit of requests allowed. If it exceeds the limit, the response will be status 429.\n\n# Dates\n\nAll dates are in UTC format, so the integration must adjust according to the time zone\n\n# Security\n\nHTTPS communication only with TLS>= 1.2  \n**HTTP and TLS< 1.2 will be deprecated on 07/31/2021**\n\nThe token must be sent in the header not as a query string","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","isPublicCollection":true,"owner":"4439232","team":111570,"collectionId":"999fea89-452e-4d7e-b8a7-30c98d92d902","publishedId":"2sBXcGDepk","public":true,"publicUrl":"https://dev.multivende.com","privateUrl":"https://go.postman.co/documentation/4439232-999fea89-452e-4d7e-b8a7-30c98d92d902","customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"documentationLayout":"classic-double-column","customisation":{"metaTags":[{"name":"description","value":"Welcome to the official Multivende Postman workspace. Our REST API is built for developers aiming to automate and enhance omnichannel e-commerce operations.\nThis collection provides the tools to seamlessly integrate major marketplaces and e-commerce platforms within your own technical ecosystem."},{"name":"title","value":"API Multivende Integration Services"}],"appearance":{"default":"system_default","themes":[{"name":"dark","logo":null,"colors":{"top-bar":"212121","right-sidebar":"303030","highlight":"FF6C37"}},{"name":"light","logo":null,"colors":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"}}]}},"version":"8.10.1","publishDate":"2026-02-24T13:53:34.000Z","activeVersionTag":"latest","documentationTheme":"light","metaTags":{"title":"API Multivende Integration Services","description":"Welcome to the official Multivende Postman workspace. Our REST API is built for developers aiming to automate and enhance omnichannel e-commerce operations.\nThis collection provides the tools to seamlessly integrate major marketplaces and e-commerce platforms within your own technical ecosystem."},"logos":{"logoLight":null,"logoDark":null}},"statusCode":200},"environments":[],"user":{"authenticated":false,"permissions":{"publish":false}},"run":{"button":{"js":"https://run.pstmn.io/button.js","css":"https://run.pstmn.io/button.css"}},"web":"https://www.getpostman.com/","team":{"logo":"https://res.cloudinary.com/postman/image/upload/t_team_logo_pubdoc/v1/team/60d6cde7c377961f990391151e357562061ad04382fbe981732354a240500e27","favicon":"https://multivende.com/favicon.ico"},"isEnvFetchError":false,"languages":"[{\"key\":\"csharp\",\"label\":\"C#\",\"variant\":\"HttpClient\"},{\"key\":\"csharp\",\"label\":\"C#\",\"variant\":\"RestSharp\"},{\"key\":\"curl\",\"label\":\"cURL\",\"variant\":\"cURL\"},{\"key\":\"dart\",\"label\":\"Dart\",\"variant\":\"http\"},{\"key\":\"go\",\"label\":\"Go\",\"variant\":\"Native\"},{\"key\":\"http\",\"label\":\"HTTP\",\"variant\":\"HTTP\"},{\"key\":\"java\",\"label\":\"Java\",\"variant\":\"OkHttp\"},{\"key\":\"java\",\"label\":\"Java\",\"variant\":\"Unirest\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"Fetch\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"jQuery\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"XHR\"},{\"key\":\"c\",\"label\":\"C\",\"variant\":\"libcurl\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Axios\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Native\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Request\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Unirest\"},{\"key\":\"objective-c\",\"label\":\"Objective-C\",\"variant\":\"NSURLSession\"},{\"key\":\"ocaml\",\"label\":\"OCaml\",\"variant\":\"Cohttp\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"cURL\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"Guzzle\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"HTTP_Request2\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"pecl_http\"},{\"key\":\"powershell\",\"label\":\"PowerShell\",\"variant\":\"RestMethod\"},{\"key\":\"python\",\"label\":\"Python\",\"variant\":\"http.client\"},{\"key\":\"python\",\"label\":\"Python\",\"variant\":\"Requests\"},{\"key\":\"r\",\"label\":\"R\",\"variant\":\"httr\"},{\"key\":\"r\",\"label\":\"R\",\"variant\":\"RCurl\"},{\"key\":\"ruby\",\"label\":\"Ruby\",\"variant\":\"Net::HTTP\"},{\"key\":\"shell\",\"label\":\"Shell\",\"variant\":\"Httpie\"},{\"key\":\"shell\",\"label\":\"Shell\",\"variant\":\"wget\"},{\"key\":\"swift\",\"label\":\"Swift\",\"variant\":\"URLSession\"}]","languageSettings":[{"key":"csharp","label":"C#","variant":"HttpClient"},{"key":"csharp","label":"C#","variant":"RestSharp"},{"key":"curl","label":"cURL","variant":"cURL"},{"key":"dart","label":"Dart","variant":"http"},{"key":"go","label":"Go","variant":"Native"},{"key":"http","label":"HTTP","variant":"HTTP"},{"key":"java","label":"Java","variant":"OkHttp"},{"key":"java","label":"Java","variant":"Unirest"},{"key":"javascript","label":"JavaScript","variant":"Fetch"},{"key":"javascript","label":"JavaScript","variant":"jQuery"},{"key":"javascript","label":"JavaScript","variant":"XHR"},{"key":"c","label":"C","variant":"libcurl"},{"key":"nodejs","label":"NodeJs","variant":"Axios"},{"key":"nodejs","label":"NodeJs","variant":"Native"},{"key":"nodejs","label":"NodeJs","variant":"Request"},{"key":"nodejs","label":"NodeJs","variant":"Unirest"},{"key":"objective-c","label":"Objective-C","variant":"NSURLSession"},{"key":"ocaml","label":"OCaml","variant":"Cohttp"},{"key":"php","label":"PHP","variant":"cURL"},{"key":"php","label":"PHP","variant":"Guzzle"},{"key":"php","label":"PHP","variant":"HTTP_Request2"},{"key":"php","label":"PHP","variant":"pecl_http"},{"key":"powershell","label":"PowerShell","variant":"RestMethod"},{"key":"python","label":"Python","variant":"http.client"},{"key":"python","label":"Python","variant":"Requests"},{"key":"r","label":"R","variant":"httr"},{"key":"r","label":"R","variant":"RCurl"},{"key":"ruby","label":"Ruby","variant":"Net::HTTP"},{"key":"shell","label":"Shell","variant":"Httpie"},{"key":"shell","label":"Shell","variant":"wget"},{"key":"swift","label":"Swift","variant":"URLSession"}],"languageOptions":[{"label":"C# - HttpClient","value":"csharp - HttpClient - C#"},{"label":"C# - RestSharp","value":"csharp - RestSharp - C#"},{"label":"cURL - cURL","value":"curl - cURL - cURL"},{"label":"Dart - http","value":"dart - http - Dart"},{"label":"Go - Native","value":"go - Native - Go"},{"label":"HTTP - HTTP","value":"http - HTTP - HTTP"},{"label":"Java - OkHttp","value":"java - OkHttp - Java"},{"label":"Java - Unirest","value":"java - Unirest - Java"},{"label":"JavaScript - Fetch","value":"javascript - Fetch - JavaScript"},{"label":"JavaScript - jQuery","value":"javascript - jQuery - JavaScript"},{"label":"JavaScript - XHR","value":"javascript - XHR - JavaScript"},{"label":"C - libcurl","value":"c - libcurl - C"},{"label":"NodeJs - Axios","value":"nodejs - Axios - NodeJs"},{"label":"NodeJs - Native","value":"nodejs - Native - NodeJs"},{"label":"NodeJs - Request","value":"nodejs - Request - NodeJs"},{"label":"NodeJs - Unirest","value":"nodejs - Unirest - NodeJs"},{"label":"Objective-C - NSURLSession","value":"objective-c - NSURLSession - Objective-C"},{"label":"OCaml - Cohttp","value":"ocaml - Cohttp - OCaml"},{"label":"PHP - cURL","value":"php - cURL - PHP"},{"label":"PHP - Guzzle","value":"php - Guzzle - PHP"},{"label":"PHP - HTTP_Request2","value":"php - HTTP_Request2 - PHP"},{"label":"PHP - pecl_http","value":"php - pecl_http - PHP"},{"label":"PowerShell - RestMethod","value":"powershell - RestMethod - PowerShell"},{"label":"Python - http.client","value":"python - http.client - Python"},{"label":"Python - Requests","value":"python - Requests - Python"},{"label":"R - httr","value":"r - httr - R"},{"label":"R - RCurl","value":"r - RCurl - R"},{"label":"Ruby - Net::HTTP","value":"ruby - Net::HTTP - Ruby"},{"label":"Shell - Httpie","value":"shell - Httpie - Shell"},{"label":"Shell - wget","value":"shell - wget - Shell"},{"label":"Swift - URLSession","value":"swift - URLSession - Swift"}],"layoutOptions":[{"value":"classic-single-column","label":"Single Column"},{"value":"classic-double-column","label":"Double Column"}],"versionOptions":[],"environmentOptions":[{"value":"0","label":"No Environment"}],"canonicalUrl":"https://dev.multivende.com/view/metadata/2sBXcGDepk"}