Create a Credential

BetaManagedAgentsCredential Beta.Vaults.Credentials.Create(parameters, cancellationToken = default)

POST/v1/vaults/{vault_id}/credentials

Create a Credential

Parameters

CredentialCreateParams parameters

required string vaultID⁠Path

Identifier of the vault to create the credential in.

required Auth auth

Authentication configuration for the credential.

class BetaManagedAgentsMcpOAuthCreateParams { Type = "mcp_oauth"; AccessToken; McpServerUrl; /* 2 more */ }

Parameters for creating an MCP OAuth credential.

JsonElement Type = "mcp_oauth"

required string AccessToken

The OAuth access token to send to the MCP server.

minLength1

maxLength8192

required string McpServerUrl

URL of the MCP server this credential authenticates against.

minLength1

maxLength2047

DateTimeOffset? ExpiresAt

When access_token expires, in RFC 3339.

Must be in the future.

formatdate-time

BetaManagedAgentsMcpOAuthRefreshParams? Refresh

Refresh token configuration, if the credential supports token refresh.

class BetaManagedAgentsStaticBearerCreateParams { Type = "static_bearer"; Token; McpServerUrl; }

Parameters for creating a static bearer token credential.

JsonElement Type = "static_bearer"

required string Token

The static bearer token to send to the MCP server, such as an API key or personal access token.

minLength1

maxLength8192

required string McpServerUrl

URL of the MCP server this credential authenticates against.

minLength1

maxLength2047

class BetaManagedAgentsEnvironmentVariableCreateParams { Type = "environment_variable"; Networking; SecretName; /* 2 more */ }

Parameters for creating an environment variable credential.

string? displayName

Human-readable name for the credential. Up to 255 characters.

maxLength255

IReadOnlyDictionary<string, string> metadata

Arbitrary key-value metadata to attach to the credential. Maximum 16 pairs, keys up to 64 chars, values up to 512 chars.

IReadOnlyList<AnthropicBeta> betas⁠Header

This endpoint is in beta: requests must send managed-agents-2026-04-01 in this header.

MessageBatches2024_09_24("message-batches-2024-09-24")

PromptCaching2024_07_31("prompt-caching-2024-07-31")

ComputerUse2024_10_22("computer-use-2024-10-22")

ComputerUse2025_01_24("computer-use-2025-01-24")

Pdfs2024_09_25("pdfs-2024-09-25")

TokenCounting2024_11_01("token-counting-2024-11-01")

TokenEfficientTools2025_02_19("token-efficient-tools-2025-02-19")

Output128k2025_02_19("output-128k-2025-02-19")

FilesApi2025_04_14("files-api-2025-04-14")

McpClient2025_04_04("mcp-client-2025-04-04")

McpClient2025_11_20("mcp-client-2025-11-20")

DevFullThinking2025_05_14("dev-full-thinking-2025-05-14")

InterleavedThinking2025_05_14("interleaved-thinking-2025-05-14")

CodeExecution2025_05_22("code-execution-2025-05-22")

ExtendedCacheTtl2025_04_11("extended-cache-ttl-2025-04-11")

Context1m2025_08_07("context-1m-2025-08-07")

ContextManagement2025_06_27("context-management-2025-06-27")

ModelContextWindowExceeded2025_08_26("model-context-window-exceeded-2025-08-26")

Skills2025_10_02("skills-2025-10-02")

FastMode2026_02_01("fast-mode-2026-02-01")

Output300k2026_03_24("output-300k-2026-03-24")

UserProfiles2026_03_24("user-profiles-2026-03-24")

UserProfiles2026_08_18("user-profiles-2026-08-18")

UserProfiles2026_09_04("user-profiles-2026-09-04")

AdvisorTool2026_03_01("advisor-tool-2026-03-01")

ManagedAgents2026_04_01("managed-agents-2026-04-01")

CacheDiagnosis2026_04_07("cache-diagnosis-2026-04-07")

Dreaming2026_04_21("dreaming-2026-04-21")

ThinkingTokenCount2026_05_13("thinking-token-count-2026-05-13")

ServerSideFallback2026_06_01("server-side-fallback-2026-06-01")

ServerSideFallback2026_07_01("server-side-fallback-2026-07-01")

FallbackCredit2026_06_01("fallback-credit-2026-06-01")

FallbackCredit2026_07_01("fallback-credit-2026-07-01")

AgentMemory2026_07_22("agent-memory-2026-07-22")

MidConversationToolChanges2026_07_01("mid-conversation-tool-changes-2026-07-01")

Compact2026_01_12("compact-2026-01-12")

ComputerUse2025_11_24("computer-use-2025-11-24")

McpTunnels2026_06_22("mcp-tunnels-2026-06-22")

StructuredOutputs2025_11_13("structured-outputs-2025-11-13")

TaskBudgets2026_03_13("task-budgets-2026-03-13")

ThinkingDisplayUpdates2026_08_18("thinking-display-updates-2026-08-18")

CEUserManagement2026_07_13("ce-user-management-2026-07-13")

MidConversationOutputConfig2026_07_01("mid-conversation-output-config-2026-07-01")

ThinkingBindingControls2026_08_01("thinking-binding-controls-2026-08-01")

MidConversationSystemClearAt2026_08_21("mid-conversation-system-clear-at-2026-08-21")

Compact2026_09_04("compact-2026-09-04")

InlineTools2026_09_15("inline-tools-2026-09-15")

McpClient2026_09_15("mcp-client-2026-09-15")

CEPlugins2026_09_01("ce-plugins-2026-09-01")

SpendLimitReads2026_09_26("spend-limit-reads-2026-09-26")

TelemetryDestinations2026_08_11("telemetry-destinations-2026-08-11")

Webhooks2026_10_07("webhooks-2026-10-07")

MessageThreads2026_08_12("message-threads-2026-08-12")

AnalyticsUsageCost2026_08_24("analytics-usage-cost-2026-08-24")

ExperimentalClaudeTag2026_10_21("experimental-claude-tag-2026-10-21")

string workspaceID⁠Header

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 BetaManagedAgentsCredential { Type = "vault_credential"; ID; ArchivedAt; /* 6 more */ }

A credential stored in a vault. Sensitive fields are never returned in responses.

Create a Credential

using System;
using Anthropic.Models.Beta.Vaults.Credentials;

CredentialCreateParams parameters = new()
{
    VaultID = "vlt_011CZkZDLs7fYzm1hXNPeRjv",
    Auth = new BetaManagedAgentsStaticBearerCreateParams()
    {
        Token = "bearer_exampletoken",
        McpServerUrl = "https://example-server.modelcontextprotocol.io/sse",
    },
};

var betaManagedAgentsCredential = await client.Beta.Vaults.Credentials.Create(parameters);

Console.WriteLine(betaManagedAgentsCredential);

Response 200

{
  "id": "vcrd_011CZkZEMt8gZan2iYPQfSkw",
  "archived_at": null,
  "auth": {
    "mcp_server_url": "https://example-server.modelcontextprotocol.io/sse",
    "type": "static_bearer"
  },
  "created_at": "2026-03-15T10:00:00Z",
  "metadata": {
    "environment": "production"
  },
  "type": "vault_credential",
  "updated_at": "2026-03-15T10:00:00Z",
  "vault_id": "vlt_011CZkZDLs7fYzm1hXNPeRjv",
  "display_name": "Example credential"
}

Returns Examples

Response 200

{
  "id": "vcrd_011CZkZEMt8gZan2iYPQfSkw",
  "archived_at": null,
  "auth": {
    "mcp_server_url": "https://example-server.modelcontextprotocol.io/sse",
    "type": "static_bearer"
  },
  "created_at": "2026-03-15T10:00:00Z",
  "metadata": {
    "environment": "production"
  },
  "type": "vault_credential",
  "updated_at": "2026-03-15T10:00:00Z",
  "vault_id": "vlt_011CZkZDLs7fYzm1hXNPeRjv",
  "display_name": "Example credential"
}