Claude Platform Docs

Crear perfil de usuario

UserProfile UserProfiles.Create(parameters, cancellationToken = default)
POST/v1/user_profiles

Crear perfil de usuario

Parameters
UserProfileCreateParams parameters
UserProfileAccessType accessType

How the platform uses the API for this entity. application (default): the profile represents an individual end-user of the platform's product. passthrough: the profile identifies a company the platform resells Claude access to.

UserProfileExternalUserDetailsParams externalUserDetails

Details about the entity this profile represents, as the platform states them. Every field is optional. Not accepted under the legacy user-profiles-2026-03-24 and user-profiles-2026-08-18 beta headers, which take the top-level external_id (and, under user-profiles-2026-08-18, external_user_onboarded_at) instead.

IReadOnlyDictionary<string, string> metadata

Free-form key-value data to attach to this user profile. Maximum 16 keys, with keys up to 64 characters and values up to 512 characters. Values must be non-empty strings.

string? name

Optional for all profiles. Real-world name of the entity this profile represents (company or individual); for a company the platform resells Claude access to (access_type passthrough), that company's name where known. Maximum 255 characters.

minLength1
maxLength255
string workspaceID⁠Header parameter

Optional header to select the Workspace for this request. The value is a Workspace ID (for example, wrkspc_011CZkZaBF1tNoB5wlCeusgy).

Only needed for credentials that can act on more than one Workspace. A credential that belongs to a specific Workspace may omit it; if sent, it must match that Workspace.

Returns
class UserProfile { Type = "user_profile"; ID; AccessType; /* 8 more */ }

A record of an entity that the platform serves through the API, such as an end-user of the platform's product or a company that the platform resells Claude access to.

A Messages, Message Batches or token counting request can send a profile's id in the anthropic-user-profile-id header to attribute the request to that entity.

Crear perfil de usuario
using System;
using Anthropic.Models.UserProfiles;

UserProfileCreateParams parameters = new();

var userProfile = await client.UserProfiles.Create(parameters);

Console.WriteLine(userProfile);
Returns Examples
Response 200
{
  "id": "uprof_011CZkZCu8hGbp5mYRQgUmz9",
  "access_type": "application",
  "created_at": "2026-03-15T10:00:00Z",
  "enforcement_actions": [
    {
      "id": "enac_011CZkZCu8hGbp5mYRQgUmz9",
      "action": "verify",
      "expires_at": null,
      "opened_at": "2026-10-02T19:30:00Z",
      "reason": "fraud_or_abuse",
      "type": "restriction"
    }
  ],
  "enforcement_status": "unrestricted",
  "external_user_details": {
    "account_status": "active",
    "country": "US",
    "email_hash": null,
    "entity_type": "business",
    "name_hash": null,
    "onboarded_at": "2024-11-02T08:15:00Z",
    "reference_id": "user_12345"
  },
  "metadata": {},
  "name": "Example User",
  "programs": {
    "cyber": {
      "requirements": {
        "data_retention": true,
        "human_review": true
      },
      "status": "active",
      "tiers": {
        "a": {
          "status": "inactive"
        },
        "b": {
          "status": "inactive"
        },
        "c": {
          "status": "inactive"
        }
      }
    },
    "efs": {
      "features": {
        "data_retention_exemption": {
          "status": "inactive"
        },
        "cmek": {
          "status": "active"
        },
        "storage": {
          "status": "inactive"
        }
      },
      "status": "active"
    }
  },
  "type": "user_profile",
  "updated_at": "2026-03-15T10:00:00Z"
}