Add User
Create a new user on a live LiteLLM proxy.
Setup
Ask for these if not already known:
LITELLM_BASE_URL — e.g. https://my-proxy.example.com LITELLM_API_KEY — proxy admin key
API reference: https://litellm.vercel.app/docs/proxy/virtual_keys#creating-a-user
Ask the user
- Email (required)
- Role — one of:
proxy_admin,proxy_admin_viewer,internal_user(default),internal_user_viewer - Max budget (optional, e.g.
10.00) - Allowed models (optional, e.g.
gpt-4o, claude-3-5-sonnet)
Run
bashcurl -s -X POST "$BASE/user/new" \ -H "Authorization: Bearer $KEY" \ -H "Content-Type: application/json" \ -d '{ "user_email": "<email>", "user_role": "<role>", "max_budget": <budget_or_null>, "models": [<models_or_empty>] }'
Output
Show the user:
user_id— they'll need this for future updateskey— the auto-generated API key for this useruser_role,max_budget
On error show detail and the likely fix.


