add-user

Create a new user on the LiteLLM proxy via its API.

77|12|Updated Mar 14, 2026
One-click install
npx skills add https://github.com/BerriAI/litellm-skills --skill add-user
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: add-user
Source: https://github.com/BerriAI/litellm-skills/tree/main/add-user
Command: npx skills add https://github.com/BerriAI/litellm-skills --skill add-user

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Creating new users on a live LiteLLM proxy is error-prone and time-consuming; this Skill streamlines onboarding by collecting essential fields and performing the API call to create the user.

Core Features & Use Cases

  • Provision a new user with required email, role, and optional max budget and model access on the LiteLLM proxy.
  • Return essential identifiers: user_id and the auto-generated API key, plus applied role and budget.
  • Use Case: Admins onboard new teammates by provisioning access and credentials with a single request.

Quick Start

Create a new user on the live LiteLLM proxy by providing email, role, and optional max budget and models.

Frequently Asked Questions about add-user

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a new user on a LiteLLM proxy?

Creating a new user on a LiteLLM proxy requires a running proxy instance and a valid admin API key. You must provide a user_email and user_role in the JSON payload, while max_budget and models are optional fields for configuring the new account.

What information do I need to provision LiteLLM API access for a teammate?

Provisioning LiteLLM API access returns a user_id and an auto-generated API key. It also confirms the applied user_role and max_budget, providing the essential credentials needed for the new team member to authenticate.

Do I need an admin API key to add users to the LiteLLM proxy?

Yes, adding users to the LiteLLM proxy requires a valid admin API key. The admin key authorizes the POST request to the "$BASE/user/new" endpoint, allowing you to securely onboard new admins or team members.

Can I set spending limits and model access when onboarding LiteLLM users?

Yes, you can set spending limits and model access when onboarding LiteLLM users by including max_budget and models in your JSON payload. This restricts how much the user can spend and which models they can query.

Why does my LiteLLM user creation request return error details?

Your LiteLLM user creation request returns error details if the API call fails due to missing required fields like user_email or an invalid admin API key. The process exposes these error details to help diagnose the failed provisioning attempt.