Create a connector
Creates a custom connector in the current project’s registry. It is owned by this project and is not available to the organization’s other projects.
Authorizations
Basic authentication header of the form Basic <encoded-value>, where <encoded-value> is the base64-encoded string username:password.
Query Parameters
Comma-separated fields to resolve on the created connector, with the same tokens as the get endpoint: actions, versions, changelog, accounts_count, connector_profiles_count. Unexpanded fields are null.
Body
Exactly one of the two source-specific shapes: create from a remote MCP server url, or register a StackOne connector YAML definition.
- CreateMcpConnectorRequest
- CreateYamlConnectorRequest
The URL of the remote MCP server to create the connector for. The server is probed to determine how it authenticates (openly, with a static access token, or through OAuth). The connector is created without actions; its tools are added separately.
^https?://The display name of the connector; it also derives the connector key. Defaults to the name the MCP server reports about itself, or to the server URL hostname.
1Not supported when creating from an MCP server url; accepted only as false, which is a no-op.
false Response
The connector was created.
The connector key (e.g. workday).
The human-readable connector name (e.g. Workday).
The URL of the connector's logo.
The connector description; null when the connector declares none.
The categories the connector belongs to (e.g. ["hris"]).
One-line summaries of the authentication methods the connector supports.
The connector version.
The owner of the connector.
The release stage of the connector (e.g. ga, beta).
The number of actions the connector exposes to the organization; 0 when the connector does not report action counts.
The number of event actions the connector exposes; 0 when the connector does not report event counts.
The URL of the public StackOne documentation for the connector; null when no public documentation is available.
The authentication methods the connector supports, keyed by authentication config key and then by environment. Contains field definitions, notices and OAuth metadata — never credential values.
The metadata of the actions the connector exposes (id, label, description, tags, required scopes…). Only resolved when expand=actions is requested; null otherwise. When connector_profile_id is supplied, the actions that profile enables come first and every action carries enabled.
How many of the connector's actions the connector profile given in connector_profile_id enables, out of actions_count. Only resolved when connector_profile_id is supplied together with expand=actions; null otherwise.
The metadata of the event actions the connector exposes. Only resolved when expand=actions is requested; null otherwise.
The registry versions of the connector, newest first — the version options a connector profile can be pinned to. Only resolved when expand=versions is requested; null otherwise. Empty for connectors with no registry versions.
The connector's release history: one entry per published version, newest first, with its summary, labels, release date and affected actions. Only resolved when expand=changelog is requested, and only for StackOne's built-in Falcon connectors; null otherwise, including connectors with no published changelog.
The number of accounts linked to the connector in this project. Only resolved when expand=accounts_count is requested; null otherwise.
The number of connector profiles configured for the connector in this project. Only resolved when expand=connector_profiles_count is requested; null otherwise.