- Home
-
- Multilogin
-
- Efficient task automation with API
-
- Basic automation with CLI
-
- How to use CLI commands for cloud phones
How to use CLI commands for cloud phones
Written by
( Updated on May 29th, 2026 )
Updated on May 29th, 2026
New to CLI? No worries. We’ll start with the basics, then you can use the command table when you need something specific.
Step 1: launch CLI
You need to launch CLI (either by launching the executable or via Terminal/Command prompt). Follow the article for more details: How to start working with CLI.
Step 2: log in to authenticate
In order to get your API token, you will need to first log in to your account via the login command.
- Paste this command: xcli login --username yourusername --password yourpassword
- Edit values for each flag
Then scroll to “Mobile Profile Commands”. This section has the commands you can use for cloud phones.
Ready to run your first cloud phone commands? Start with these guides:
Cloud phone commands
Want to do something specific? Use the table below to find the right command:
| Cli command | Description | Required flags | Notes |
|
gets mobile profiles limit |
N/A | |
|
gets or create mobile profile group |
N/A | Returns the mobile profile group for the current workspace. If no group exists yet, one is created automatically. |
|
gets states by country |
--country |
ISO country codes are used. For example, USA and GBR for the US and UK respectively. |
|
gets cities by state |
--state |
Use the state name returned by |
|
checks proxy configuration |
|
Set the proxy port. The default port is 1080. Choose the proxy type: socks5 or http. The default type is socks5. Set the server address next to the |
|
gets list of phone brands by Android version |
--android-version |
Set the number for the --android-version flag (e.g. 12, 13, 14, 15, 16).
|
|
gets list of mobile profiles (phones) with filters |
N/A | There are additional values for filtering the search result. Use --help flag for that. |
|
creates new mobile profiles (phones) |
|
Set the OS version with the For proxy, add the full proxy string, for example: socks5://user:pass@host:port You can also set extra values, like geolocation, brand, and model. Use the |
|
updates mobile profile (phone) |
|
Use the cloud phone ID with the You can also edit proxy, notes, and tags. Use the |
|
delete mobile profiles by IDs |
--ids |
Separate the list of cloud phone IDs with comma. For example: "1,2,3" |
|
gets mobile profiles statuses |
--ids |
Separate the list of cloud phone IDs with commas. For example: "1,2,3" |
|
assign tags to mobile profile |
|
You can add up to 10 tags. |
|
removes tags from mobile profile |
|
|
|
shutdowns mobile profiles |
--ids |
Separate the list of cloud phone IDs with commas. For example: “1,2,3” |
|
launches mobile profiles |
--ids |
Separate the list of cloud phone IDs with comma. For example: “1,2,3” |
|
get list of available mobile application |
N/A | You can use extra values to filter the results. Use the flag --help to see them. |
|
batches install applications for a group of phones |
|
--id is the application ID. --version_id is the app version ID. You can get both values with the mobile-profiles-app-list command. |
|
starts mobile profiles proxy call (launch phone without GUI) |
--ids |
Separate list of cloud phone IDs with comma. For example: “1,2,3” |
|
stops mobile profiles proxy call (stops phone without GUI) |
--ids |
Separate list of cloud phone IDs with comma. For example: “1,2,3” |
|
downloads Excel template for profile import |
N/A | Set a custom export path with the --output flag. By default, files are saved in /mlx/deps/cli/
|
|
validates mobile profiles import file |
--file |
--file sets the path to the Excel file you want to validate.
|
|
exports mobile profiles to Excel file |
--ids |
Set a custom export path with the
|
|
lists uploaded mobile profile files |
--page |
Set the page number. Page 1 is used by default. You can use extra values to filter the results. Use the |
|
uploads a file to mobile profile drive |
|
--file sets the path to the file. Use --help to see supported file types.
|
|
deletes files from mobile profile drive by IDs |
--ids |
Separate list of file IDs with commas. For example: “1,2,3”. You can get file IDs from |
|
assigns tags to mobile profile files |
|
You can add up to 10 tags. |
|
unassigns tags from mobile profile files |
|
You can add up to 10 tags. |
|
transfers mobile profiles to another user |
|
Separate list of file IDs with commas. For example: “1,2,3”. You can transfer up to 200 profiles at once.
|
