Profile Management

Create, update, clone, move, lock, and delete browser profiles via the Cloud API.

Base URL: https://api.multilogin.com

Create Profile

POST /profile/create

Supports Strict and Non-Strict modes. In Non-Strict mode, unspecified parameters receive default values.

Required Parameters (Strict Mode)

Parameter	Type	Description
name	string	Profile name
browser_type	string	mimic or stealthfox
os_type	string	windows, macos, linux, android
folder_id	UUID	Target folder
parameters	object	Fingerprint and flag configuration

Fingerprint Flags

The flags object inside parameters controls browser fingerprinting:

Flag	Type	Description
audio_masking	string	AudioContext fingerprint masking
fonts_masking	string	Font enumeration masking
media_devices_masking	string	Media devices masking
screen_masking	string	Screen resolution masking
graphics_masking	string	WebGL/Canvas masking
graphics_noise	string	Canvas noise injection
webrtc_masking	string	WebRTC IP leak prevention
geolocation_masking	string	Geolocation spoofing
timezone_masking	string	Timezone masking
locale_masking	string	Locale/language masking
ports_masking	string	Port scanning protection
navigator_masking	string	Navigator API masking

Masking Values

Each flag accepts one of these values:

Value	Meaning
mask	Apply masking based on profile fingerprint
real	Use real system values
custom	Use user-specified custom values

curl -X POST https://api.multilogin.com/profile/create \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "my-profile",
    "browser_type": "mimic",
    "os_type": "windows",
    "folder_id": "FOLDER_UUID",
    "parameters": {
      "fingerprint": {
        "cmd_params": "",
        "flags": {
          "audio_masking": "mask",
          "fonts_masking": "mask",
          "media_devices_masking": "mask",
          "screen_masking": "real",
          "graphics_masking": "mask",
          "graphics_noise": "mask",
          "webrtc_masking": "mask",
          "geolocation_masking": "mask",
          "timezone_masking": "mask",
          "locale_masking": "mask"
        }
      },
      "storage": {
        "is_local": false,
        "save_service_worker": false
      },
      "proxy": {
        "type": "none"
      }
    }
  }'

Response:

{
  "status": {
    "error_code": "",
    "http_code": 200,
    "message": ""
  },
  "data": {
    "ids": ["8feb79fc-2b42-4d54-a3eb-f26fddd31499"]
  }
}

---

Update Profile

POST /profile/update

Update an existing profile's configuration. Supports Strict and Non-Strict modes.

curl -X POST https://api.multilogin.com/profile/update \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "profile_id": "PROFILE_UUID",
    "name": "updated-name",
    "parameters": {
      "proxy": {
        "type": "http",
        "host": "proxy.example.com",
        "port": 8080,
        "username": "user",
        "password": "pass"
      }
    }
  }'

---

Clone Profile

POST /profile/clone

Create a copy of an existing profile with a new ID.

Parameter	Type	Required	Description
profile_id	UUID	Yes	Source profile to clone
count	number	No	Number of clones (default: 1)

curl -X POST https://api.multilogin.com/profile/clone \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"profile_id": "SOURCE_UUID", "count": 3}'

---

Remove Profile

POST /profile/remove

Delete one or more profiles.

Parameter	Type	Required	Description
profile_ids	UUID[]	Yes	Array of profile IDs to delete
permanently	boolean	No	Skip trash bin (default: false)

curl -X POST https://api.multilogin.com/profile/remove \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"profile_ids": ["UUID1", "UUID2"]}'

---

Move Profiles to Folder

POST /profile/move

Move profiles between folders.

curl -X POST https://api.multilogin.com/profile/move \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "profile_ids": ["UUID1", "UUID2"],
    "folder_id": "TARGET_FOLDER_UUID"
  }'

---

Lock/Unlock Profiles

POST /profile/lock / POST /profile/unlock

Lock profiles to prevent concurrent editing or launching.

# Lock
curl -X POST https://api.multilogin.com/profile/lock \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"profile_ids": ["UUID1"]}'

# Unlock
curl -X POST https://api.multilogin.com/profile/unlock \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"profile_ids": ["UUID1"]}'

---

Restore Profiles from Trash

POST /profile/restore

Restore previously deleted profiles from the trash bin.

curl -X POST https://api.multilogin.com/profile/restore \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"profile_ids": ["UUID1"]}'

---

Profile Lifecycle