createHttpConnection

Mutation

Create a new HTTP connection in a workspace. Each connection becomes a tool named custom_http_{name} that Buzz can use to make authenticated API requests. IMPORTANT: The "name" must be snake_case (lowercase letters, numbers, underscores, starting with a letter, e.g. "github_api", "stripe_api"). It must be unique within the workspace. IMPORTANT: Before calling this, you MUST call discover_oauth_metadata first. If discovery returns success, set authType to 'oauth' and use the discovered oauthAuthorizationUrl, oauthTokenUrl, and oauthScopes. Only use authType 'headers' when discover_oauth_metadata fails. For authType "headers", pass a "headers" object with auth credentials as key-value pairs (e.g. {"Authorization": "Bearer sk-xxx"}). Headers are encrypted at rest. Set sharingType to "everyone" for workspace-wide access, "custom" to share with specific users, or "me" (default) for personal use only. After creating, inform the user that the new tool (custom_http_{name}) will be available in their next conversation.

Returns HttpConnection .