Docs / Claude guides

How to Add a Member to a Claude Workspace

Claude workspaces control access to API keys, usage data, and session information for a specific team or project. Adding a member to a workspace assigns them a role that determines what they can access there.

A person must already belong to your organization before you can add them to a workspace. Invite them to the org first, then add them to the workspace their project needs.

In this guide, we'll walk through two methods to add a member to a Claude workspace:

  • Add a member to a workspace in the Claude Console
  • Add a Claude workspace member using Admin365

Choose a method

How to Add a Member to a Workspace in the Claude Console

You can add a member to a Claude workspace in the Anthropic Console. Use the Console to grant an existing organization member access to a specific workspace and assign their workspace role. You must be a Workspace Admin or Organization Admin to add members in the Anthropic Console.

Steps to Add a Member to a Workspace in the Claude Console

  1. Sign in to the Anthropic Console.

  2. In the left sidebar, open Organization settings and click Workspaces.

  3. In the Workspaces list, click the name of the workspace you want to add a member to. The detail page opens on its API keys tab.

  4. In the workspace sidebar, expand Manage and click Members.

  5. Click Add to Workspace in the top-right corner of the Members tab.

Add member dialog with the Member picker open
  1. In the Add member to [workspace name] dialog, click the Member dropdown and select the organization member you want to add. The picker lists only members not yet in this workspace.

  2. Click the Role dropdown and choose the appropriate workspace role:

    • Workspace User (view resources in the workspace)
    • Workspace Developer (manage API keys and webhook endpoints, view usage, and access session data)
    • Workspace Limited Developer (same as Developer, but session transcripts and memory stores are hidden in the Console)
    • Workspace Admin (all Developer capabilities, plus user management and running-session access)
  3. Click Add to workspace. The dialog closes and the member appears as a new row in the Members list with their assigned role.

New member row confirmed in the workspace Members list

Workspace Member Access Best Practices in the Claude Console

  • The Role dropdown defaults to Workspace Developer. Change it to Workspace User for members who only need to view workspace resources. Assign Developer or Admin only when the work requires API key management or session access.
  • If a person does not appear in the Member picker, they are not yet part of your organization. Go to Organization settings > Members and invite them first, then return to add them to the workspace.
  • Roles are per workspace. A member can hold a different role in each workspace. Grant broader access in development workspaces and keep production workspaces restricted to the minimum each role requires.
  • Organization Admins are automatically present in every workspace as inherited Workspace Admins. They appear on the Members tab but cannot be added or modified through this flow.

Common Errors When Adding a Workspace Member in Claude Console

Adding a workspace member can fail at the API layer or when Admin365 submits the request on your behalf. Match the error text you see below, then follow the resolution.

User Already a Workspace Member Error in Admin365

Error:

The specified user is already a member of the Workspace.

What it means: The selected user already has access to the target workspace, so the API rejects the duplicate add.

Solution: Check whether the user is already a workspace member before adding them. If they are and you need to change their access, use Update Member Role instead of adding them again.

Permission Denied Error When Adding a Workspace Member

Error:

Your API key does not have permission to use the specified resource.

What it means: The acting admin or Admin365's API key lacks the Organization Admin or Workspace Admin role required to manage workspace members.

Solution: Have an Organization Admin grant the acting user (or Admin365's connection) Workspace Admin on the target workspace, then retry.

Member Not Found Error When Adding a Workspace Member

Error:

The requested resource could not be found.

What it means: The person is not an organization member yet, so the Console omits them from the Add-member picker and the API returns a not-found error.

Solution: Invite the person to the organization first via Organization settings > Members > Invite, then add them to the workspace.

Invalid or Expired API Key Error in Admin365

Error:

There's an issue with your API key.

What it means: The Admin API key that Admin365 uses to reach Claude is malformed, revoked, or expired, so the request is rejected before the member is added.

Solution: Regenerate the Admin API key in the Claude Console and update it in Admin365's connection settings, then retry.


Manage Claude Workspace Members at Scale with Admin365

Add, update, and audit workspace members across every Claude workspace from one management console.

Download Admin365