Create a connection (token or mcp)

Provision a connection programmatically. type: "token" stores an API key/secret in encrypted storage; type: "mcp" registers a remote HTTP/SSE MCP server by URL with optional headers (values may use ${SECRET}). For OAuth/browser providers that need a human, use POST /connections/links instead. The secret is write-only.

post/connections

Request

  • Base URL: https://worker.openhelm.ai/v1
  • URL: https://worker.openhelm.ai/v1/connections
  • Auth: HTTP bearer

Request body

namestring required
type'token' | 'mcp' required
secretstring

API key/token to store (token type, or to back ${SECRET} in mcp headers).

env_var_namestring

token type: the env var the secret is injected as (e.g. GITHUB_TOKEN).

urlstring uri

mcp type: the remote MCP server URL.

transport'http' | 'sse'
headersobject

mcp type: request headers.

project_idstring

Scope to one project; omit for all the account's runs.

service_idstring

Which service this credential is for, as a catalogue id ("stripe", "contextely", "notion"). Service-aware features match on this and never on the connection's name, so a credential provisioned without it is stored correctly and ignored by all of them. Rejected if unknown.

Response

Created

Changes

No recorded changes to this operation across all 1 revision of this API.