Proxy Configuration

Configure proxy connections per browser profile and verify connectivity.

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

Set Proxy on Profile

Proxies are configured as part of the profile's parameters.proxy object during creation or update.

Supported Proxy Types

Type	Value	Description
None	none	Direct connection, no proxy
HTTP	http	HTTP proxy
HTTPS	https	HTTPS proxy
SOCKS5	socks5	SOCKS5 proxy

Proxy Parameters

Parameter	Type	Required	Description
type	string	Yes	none, http, https, or socks5
host	string	If type != none	Proxy hostname or IP
port	number	If type != none	Proxy port
username	string	No	Proxy authentication username
password	string	No	Proxy authentication password

Set Proxy During Profile Creation

curl -X POST https://api.multilogin.com/profile/create \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "proxy-profile",
    "browser_type": "mimic",
    "os_type": "windows",
    "folder_id": "FOLDER_UUID",
    "parameters": {
      "proxy": {
        "type": "http",
        "host": "proxy.example.com",
        "port": 8080,
        "username": "user",
        "password": "pass"
      }
    }
  }'

Update Proxy on Existing Profile

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

Verify Proxy Connection

POST /profile/proxy/check_connection

Test if a proxy is reachable and working before assigning it to a profile.

Parameter	Type	Required	Description
type	string	Yes	Proxy type
host	string	Yes	Proxy host
port	number	Yes	Proxy port
username	string	No	Auth username
password	string	No	Auth password

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

Response (success):

{
  "status": {
    "error_code": "",
    "http_code": 200,
    "message": ""
  },
  "data": {
    "ip": "203.0.113.42",
    "country": "US",
    "city": "New York"
  }
}

Proxy Workflow

Best Practices

• Always verify proxy connectivity before assigning to profiles
• Use residential or mobile proxies for best anti-detection
• Rotate proxies across profiles to avoid IP clustering
• Match proxy geolocation with profile timezone and locale settings