Proxy users

A proxy user is a credential pair scoped to your account. Everything they consume bills to the same balance, but usage, limits and permissions are tracked separately. There is no charge for creating them and no practical ceiling on how many you have.

Why you want more than one

• Attribution: usage charts break down per sub-user, so you can see which project is spending.
• Blast radius: a leaked credential can be disabled without touching anything else.
• Caps: each sub-user can carry its own daily and monthly traffic ceiling.
• Restriction: a sub-user can be locked to specific products or countries.

Creating one over the API

curl -X POST https://api.wproxy.io/v1/proxy-users \
  -H "Authorization: Bearer $WPROXY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "serp-crawler",
    "password": "generated-by-us-if-omitted",
    "limits": { "daily_gb": 5, "monthly_gb": 120 },
    "allow": { "products": ["residential"], "countries": ["us", "gb", "de"] }
  }'

{
  "id": "pu_8f21c0",
  "name": "serp-crawler",
  "username": "wp-acc4821-serp-crawler",
  "password": "z7Qk-2ma9-Rt4v",
  "enabled": true,
  "limits": { "daily_gb": 5, "monthly_gb": 120 },
  "created_at": "2026-08-31T09:14:22Z"
}