Create workspace credential

Creates a workspace-shared credential and validates MCP-backed connections against the remote server when possible. This endpoint requires a signed-in session and does not accept API keys.

POST/api/v1/workspaces/{workspaceHandle}/credentials

Creates a workspace-shared credential and validates MCP-backed connections against the remote server when possible. This endpoint requires a signed-in session and does not accept API keys.

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

name?nonEmptyString

a non empty string

Length1 <= length

type*WorkspaceCredentialType

Supported workspace credential authentication modes

Value in"oauth" | "bearerToken"

Example"oauth"

mcpServerName?nonEmptyString

a non empty string

Length1 <= length

mcpServerUrl*nonEmptyString

a non empty string

Length1 <= length

accessToken?nonEmptyString

a non empty string

Length1 <= length

clientId?nonEmptyString

a non empty string

Length1 <= length

clientSecret?nonEmptyString

a non empty string

Length1 <= length

Response Body

`application/json`

curl -X POST "https://loading/api/v1/workspaces/{workspaceHandle}/credentials" \  -H "Content-Type: application/json" \  -d '{    "name": "Notion MCP",    "type": "oauth",    "mcpServerName": "Notion",    "mcpServerUrl": "https://mcp.notion.com/mcp",    "accessToken": "<oauth-access-token>"  }'

{
  "credential": {
    "id": "wcred_01JQFQY7XMQJ0TA3A7X7F7WQ4H",
    "name": "Notion MCP",
    "credentialKind": "mcp",
    "integrationKey": null,
    "type": "oauth",
    "mcpServerName": "Notion",
    "mcpServerUrl": "https://mcp.notion.com/mcp",
    "hasAccessToken": true,
    "hasClientId": false,
    "hasClientSecret": false,
    "availableTools": [
      {
        "name": "search",
        "title": "Search",
        "description": "Search pages and databases in Notion.",
        "tags": [
          "read-only",
          "idempotent"
        ]
      },
      {
        "name": "create-page",
        "title": "Create page",
        "description": "Create a new page in a target parent.",
        "tags": [
          "destructive"
        ]
      }
    ],
    "toolDiscoveryError": null,
    "lastValidatedAt": "2026-04-09T14:00:00.000Z",
    "createdAt": "2026-04-09T14:00:00.000Z",
    "updatedAt": "2026-04-09T14:00:00.000Z"
  }
}

{
  "issues": [
    {
      "_tag": "Pointer",
      "path": [
        "string"
      ],
      "message": "string"
    }
  ],
  "message": "string",
  "_tag": "HttpApiDecodeError"
}

{
  "code": "authentication_required",
  "message": "Authentication required. Send Authorization: Bearer <api-key>, x-api-key, or a signed-in session."
}

{
  "code": "not_found",
  "message": "The requested resource was not found."
}

{
  "code": "conflict",
  "message": "The requested resource already exists."
}

{
  "code": "internal_error",
  "message": "An unexpected server error occurred."
}

Create workspace credential

Request Body

Response Body

201application/json

400application/json

401application/json

404application/json

409application/json

500application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`