{"activeVersionTag":"latest","latestAvailableVersionTag":"latest","collection":{"info":{"_postman_id":"363bde30-014c-4a6f-88c6-e0ec6ea084f1","name":"Multilogin API (CN)","description":"## **Multilogin API Documentation**\n\nMultilogin API lets you automate Android cloud phone and browser profile management through Postman, scripts, and other integrations.\n\nYou can create, update, start, stop, and organize cloud phones and browser profiles without managing each task manually. The API also supports workspace access, folders, global IPs, profile data, cookies, files, and other automation operations.\n\n## **Authentication**\n\nMost Multilogin API requests require a Bearer Token in the `Authorization` header.\n\n**For regular API automation, we recommend using an automation token.** It lasts longer and supports higher rate limits than a regular API token.\n\n### How to generate an automation token\n\n1. In Multilogin, switch to the workspace you want to automate\n    \n2. Click “Info” → click “Copy” next to “API token”\n    \n3. In Postman, open “Profile Access Management” → “Workspace Automation Token”\n    \n4. Open “Authorization” → select “Bearer Token” → paste the API token\n    \n5. Open “Params” and set `expiration_period`\n    \n6. Click “Send”\n    \n7. Copy the automation token from the response and use it as the Bearer Token for subsequent requests\n    \n\nSupported expiration periods include `1h`, `3h`, `5h`, `16h`, `24h`, `48h`, `1w`, `2w`, `3w`, `1mo`, and `no_exp`.\n\n`no_exp` means the token has no scheduled expiration. It can still become invalid, for example, if the account password changes.\n\n### Alternative: regular API token\n\nA regular API token expires after 30 minutes. You can copy it from “Info” in Multilogin or obtain it through “User Sign In”.\n\nUse “User Sign In” and “User Refresh Token (Switch Workspace)” only when your integration needs to handle sign-in or workspace switching directly through API requests.\n\n## **Endpoints Overview**\n\nMultilogin API requests are organized into categories based on what you want to manage.\n\n### Base URLs\n\n- **Cloud API:** `https://api.multilogin.com`\n    \n- **Browser profile Launcher:** `https://launcher.mlx.yt:45001`\n    \n\nThe Launcher endpoints require the Multilogin desktop app to be running.\n\n### Main categories\n\n- **Launcher:** start and stop browser profiles and retrieve browser connection details\n    \n- **Profile Management:** create, update, organize, and delete browser profiles\n    \n- **Profile Access Management:** manage authentication tokens, workspace access, folders, restrictions, and workspace information\n    \n- **Browser Profile Data:** unlock locked browser profiles\n    \n- **Global IP:** generate global IPs and retrieve supported global IP data\n    \n\nAdditional categories cover Pre-made Cookies, Script Runner, Profile Import/Export, Object Storage, Bookmark Management, and 2FA.\n\n## **Request and Response Format**\n\nThe API accepts JSON-formatted requests and returns responses in JSON format.\n\n## **Error Handling**\n\nThe API follows standard HTTP status codes to indicate the success or failure of requests. Error responses include error messages to assist in troubleshooting.\n\nErrors are categorized into the following groups:\n\n1. **Client Errors (4xx):** These errors occur when there is an issue with the client's request, such as invalid parameters or unauthorized access.\n    \n    - **400 Bad Request:** The request was invalid or malformed. Check the request parameters and try again. This type typically relates to wrong or invalid data being sent.\n        \n    - **401 Unauthorized:** Authentication credentials are missing or invalid. Ensure you are using valid credentials and tokens.\n        \n    - **403 Forbidden:** The user does not have permission to access the requested resource.\n        \n    - **429 Too Many Request:** The error indicates that the user has sent too many requests in a given amount of time exceeding the rate limit.\n        \n2. **Server Errors (5xx):** These errors occur when there is an issue on the server side, such as internal server errors or service unavailable.\n    \n    - **500 Internal Server Error:** An unexpected error occurred on the server side. This may happen when the server cannot process your request due to multiple technical reasons. Wrong payloads or inconsistent data sent can also raise this error. Contact support if the issue persists.\n        \n\nFor more information on using the Multilogin API, please refer to the API documentation with code examples or navigate to our [support page](https://multilogin.com/help/cn_CN).","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","isPublicCollection":false,"owner":"28533318","team":32171910,"collectionId":"363bde30-014c-4a6f-88c6-e0ec6ea084f1","publishedId":"2sBXqJLM99","public":true,"publicUrl":"https://documenter-api.postman.tech/view/28533318/2sBXqJLM99","privateUrl":"https://go.postman.co/documentation/28533318-363bde30-014c-4a6f-88c6-e0ec6ea084f1","customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"documentationLayout":"classic-double-column","customisation":{"metaTags":[{"name":"description","value":""},{"name":"title","value":"Multilogin API"}],"appearance":{"default":"light","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.12.8","publishDate":"2026-08-13T09:28:31.000Z","activeVersionTag":"latest","documentationTheme":"light","metaTags":{"title":"Multilogin API","description":""},"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/5c03f64f64ebeee2ae4d75db263ce978fd632cc7bb4b3c069883e8e888343426","favicon":""},"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://documenter.gw.postman.com/view/metadata/2sBXqJLM99"}