---
title: "Create a new connector."
method: POST
path: "/v1/connectors"
tags: ["beta.connectors"]
---

# Create a new connector.

`POST /v1/connectors`

Create a new MCP or HTTP connector. You can customize its visibility, URL, and auth type.

## Request body

- union
  - CreateConnectorRequest
    - `headers` object, nullable — Optional scoped credentials to be sent with connector requests.
    - `global_headers` object — Optional connector-wide headers, keyed by header name, set at creation and applied to every credential. Secret values are encrypted at rest and never returned in clear.
    - `auth_data` AuthData
      - `client_id` string, required
      - `client_secret` string, password, nullable
    - `oauth2_server_metadata` ExtendedOAuthServerMetadata — Custom superset of RFC 8414 OAuth 2.0 Authorization Server Metadata. Stored at connector creation time (provided for HTTP connectors, discovered via .well-known for MCP). Mirrors the shape of .well-known/oauth-authorization-server responses.
      - `issuer` string, uri, required
      - `authorization_endpoint` string, uri, nullable
      - `token_endpoint` string, uri, required
      - `registration_endpoint` string, uri, nullable
      - `scopes_supported` string[], nullable
      - `response_types_supported` string[]
      - `response_modes_supported` string[], nullable
      - `grant_types_supported` string[], nullable
      - `token_endpoint_auth_methods_supported` string[], nullable
      - `token_endpoint_auth_signing_alg_values_supported` string[], nullable
      - `service_documentation` string, uri, nullable
      - `ui_locales_supported` string[], nullable
      - `op_policy_uri` string, uri, nullable
      - `op_tos_uri` string, uri, nullable
      - `revocation_endpoint` string, uri, nullable
      - `revocation_endpoint_auth_methods_supported` string[], nullable
      - `revocation_endpoint_auth_signing_alg_values_supported` string[], nullable
      - `introspection_endpoint` string, uri, nullable
      - `introspection_endpoint_auth_methods_supported` string[], nullable
      - `introspection_endpoint_auth_signing_alg_values_supported` string[], nullable
      - `code_challenge_methods_supported` string[], nullable
      - `client_id_metadata_document_supported` boolean, nullable
      - `x_source` 'autodiscovery' | 'provided' — How a connector's OAuth server metadata was obtained.
      - `x_resource_url` string, nullable
      - `x_scope` string, nullable
    - `oauth2_server_metadata_url` string, uri, nullable — Optional URL to fetch OAuth2 authorization server metadata from (RFC 8414). When provided, the metadata is fetched from this URL and used instead of .well-known discovery. Mutually exclusive with oauth2_server_metadata.
    - `name` string, required — The name of the connector. Should be 64 char length maximum, alphanumeric, only underscores/dashes.
    - `title` string, nullable — Optional human-readable title for the connector.
    - `description` string, required — The description of the connector.
    - `icon_url` string, nullable — The optional url of the icon you want to associate to the connector.
    - `server` string, uri, required — The URL of the connector server.
    - `visibility` 'shared_org' | 'shared_workspace' | 'private' — Connector visibility options.
    - `auth_methods` union[], nullable — Authentication methods supported by the connector.
      - union
        - union
          - OAuth2AuthorizationCodeAuthMethod
            - `method_type` 'oauth2'
            - `oauth2_server_metadata` ExtendedOAuthServerMetadata, required — Custom superset of RFC 8414 OAuth 2.0 Authorization Server Metadata. Stored at connector creation time (provided for HTTP connectors, discovered via .well-known for MCP). Mirrors the shape of .well-known/oauth-authorization-server responses.
              - …
            - `headers` ConnectorAuthenticationHeader[], nullable — Optional headers sent with requests for this auth method.
              - …
            - `grant_type` 'authorization_code'
            - `auth_data` AuthData, required
              - …
          - OAuth2ClientCredentialsAuthMethod
            - `method_type` 'oauth2'
            - `oauth2_server_metadata` ExtendedOAuthServerMetadata, required — Custom superset of RFC 8414 OAuth 2.0 Authorization Server Metadata. Stored at connector creation time (provided for HTTP connectors, discovered via .well-known for MCP). Mirrors the shape of .well-known/oauth-authorization-server responses.
              - …
            - `headers` ConnectorAuthenticationHeader[], nullable — Optional headers sent with requests for this auth method.
              - …
            - `grant_type` 'client_credentials', required
            - `token_endpoint_auth_method` 'client_secret_post' | 'client_secret_basic', required
        - BearerAuthMethod
          - `method_type` 'bearer'
          - `headers` ConnectorAuthenticationHeader[], nullable — Optional additional headers sent with requests.
            - `name` string, required
            - `is_required` boolean
            - `is_secret` boolean
        - NoneAuthMethod
          - `method_type` 'none'
          - `headers` ConnectorAuthenticationHeader[], nullable — Headers whose values must be provided as credentials.
            - `name` string, required
            - `is_required` boolean
            - `is_secret` boolean
    - `system_prompt` string, nullable — Optional system prompt for the connector.
    - `protocol` 'mcp' — Protocol of the connector. Use 'mcp' for MCP connectors.
  - CreateHTTPConnectorRequest
    - `headers` object, nullable — Optional scoped credentials to be sent with connector requests.
    - `global_headers` object — Optional connector-wide headers, keyed by header name, set at creation and applied to every credential. Secret values are encrypted at rest and never returned in clear.
    - `auth_data` AuthData
      - `client_id` string, required
      - `client_secret` string, password, nullable
    - `oauth2_server_metadata` ExtendedOAuthServerMetadata — Custom superset of RFC 8414 OAuth 2.0 Authorization Server Metadata. Stored at connector creation time (provided for HTTP connectors, discovered via .well-known for MCP). Mirrors the shape of .well-known/oauth-authorization-server responses.
      - `issuer` string, uri, required
      - `authorization_endpoint` string, uri, nullable
      - `token_endpoint` string, uri, required
      - `registration_endpoint` string, uri, nullable
      - `scopes_supported` string[], nullable
      - `response_types_supported` string[]
      - `response_modes_supported` string[], nullable
      - `grant_types_supported` string[], nullable
      - `token_endpoint_auth_methods_supported` string[], nullable
      - `token_endpoint_auth_signing_alg_values_supported` string[], nullable
      - `service_documentation` string, uri, nullable
      - `ui_locales_supported` string[], nullable
      - `op_policy_uri` string, uri, nullable
      - `op_tos_uri` string, uri, nullable
      - `revocation_endpoint` string, uri, nullable
      - `revocation_endpoint_auth_methods_supported` string[], nullable
      - `revocation_endpoint_auth_signing_alg_values_supported` string[], nullable
      - `introspection_endpoint` string, uri, nullable
      - `introspection_endpoint_auth_methods_supported` string[], nullable
      - `introspection_endpoint_auth_signing_alg_values_supported` string[], nullable
      - `code_challenge_methods_supported` string[], nullable
      - `client_id_metadata_document_supported` boolean, nullable
      - `x_source` 'autodiscovery' | 'provided' — How a connector's OAuth server metadata was obtained.
      - `x_resource_url` string, nullable
      - `x_scope` string, nullable
    - `oauth2_server_metadata_url` string, uri, nullable — Optional URL to fetch OAuth2 authorization server metadata from (RFC 8414). When provided, the metadata is fetched from this URL and used instead of .well-known discovery. Mutually exclusive with oauth2_server_metadata.
    - `name` string, required — The name of the connector. Should be 64 char length maximum, alphanumeric, only underscores/dashes.
    - `title` string, nullable — Optional human-readable title for the connector.
    - `description` string, required — The description of the connector.
    - `icon_url` string, nullable — The optional url of the icon you want to associate to the connector.
    - `server` string, uri, required — The URL of the connector server.
    - `visibility` 'shared_org' | 'shared_workspace' | 'private' — Connector visibility options.
    - `auth_methods` union[], nullable — Authentication methods supported by the connector.
      - union
        - union
          - OAuth2AuthorizationCodeAuthMethod
            - `method_type` 'oauth2'
            - `oauth2_server_metadata` ExtendedOAuthServerMetadata, required — Custom superset of RFC 8414 OAuth 2.0 Authorization Server Metadata. Stored at connector creation time (provided for HTTP connectors, discovered via .well-known for MCP). Mirrors the shape of .well-known/oauth-authorization-server responses.
              - …
            - `headers` ConnectorAuthenticationHeader[], nullable — Optional headers sent with requests for this auth method.
              - …
            - `grant_type` 'authorization_code'
            - `auth_data` AuthData, required
              - …
          - OAuth2ClientCredentialsAuthMethod
            - `method_type` 'oauth2'
            - `oauth2_server_metadata` ExtendedOAuthServerMetadata, required — Custom superset of RFC 8414 OAuth 2.0 Authorization Server Metadata. Stored at connector creation time (provided for HTTP connectors, discovered via .well-known for MCP). Mirrors the shape of .well-known/oauth-authorization-server responses.
              - …
            - `headers` ConnectorAuthenticationHeader[], nullable — Optional headers sent with requests for this auth method.
              - …
            - `grant_type` 'client_credentials', required
            - `token_endpoint_auth_method` 'client_secret_post' | 'client_secret_basic', required
        - BearerAuthMethod
          - `method_type` 'bearer'
          - `headers` ConnectorAuthenticationHeader[], nullable — Optional additional headers sent with requests.
            - `name` string, required
            - `is_required` boolean
            - `is_secret` boolean
        - NoneAuthMethod
          - `method_type` 'none'
          - `headers` ConnectorAuthenticationHeader[], nullable — Headers whose values must be provided as credentials.
            - `name` string, required
            - `is_required` boolean
            - `is_secret` boolean
    - `system_prompt` string, nullable — Optional system prompt for the connector.
    - `protocol` 'http', required

## Response `201`

Successful Response

- union
  - MCPConnector
    - `id` string, uuid, required
    - `name` string, required
    - `title` string, nullable
    - `description` string, required
    - `created_at` string, date-time, required
    - `modified_at` string, date-time, required
    - `server` string, nullable
    - `icon_url` string, nullable
    - `server_card` MCPServerCard
      - `$schema` string, nullable — URL to the JSON schema definition
      - `name` string, required — Server identifier in reverse-DNS format with exactly one /
      - `version` string, required — Server version (semantic versioning preferred)
      - `capabilities` ServerCapabilities — Capabilities that a server may support.
        - `experimental` object, nullable
        - `logging` LoggingCapability — Capability for logging operations.
        - `prompts` PromptsCapability — Capability for prompts operations.
          - `listChanged` boolean, nullable
        - `resources` ResourcesCapability — Capability for resources operations.
          - `subscribe` boolean, nullable
          - `listChanged` boolean, nullable
        - `tools` ToolsCapability — Capability for tools operations.
          - `listChanged` boolean, nullable
        - `completions` CompletionsCapability — Capability for completions operations.
        - `tasks` ServerTasksCapability — Capability for server tasks operations.
          - `list` TasksListCapability — Capability for tasks listing operations.
          - `cancel` TasksCancelCapability — Capability for tasks cancel operations.
          - `requests` ServerTasksRequestsCapability — Capability for tasks requests operations.
            - `tools` TasksToolsCapability — Capability for tasks tools operations.
              - …
      - `title` string, nullable
      - `description` string, nullable
      - `websiteUrl` string, nullable
      - `repository` MCPServerRepository — Source repository information (SEP-2127).
        - `url` string, required — Repository URL
        - `source` string, required — Source identifier (e.g. 'github')
        - `subfolder` string, nullable
      - `icons` MCPServerIcon[], nullable
        - `src` string, required
        - `mimeType` string, nullable
        - `sizes` string[], nullable
      - `remotes` MCPServerRemote[], nullable
        - `type` 'streamable-http' | 'sse', required — Transport type
        - `url` string, required — Transport endpoint URL
        - `supportedProtocolVersions` string[], nullable
        - `headers` MCPServerRemoteHeader[], nullable
          - `name` string, required — Header name
          - `description` string, required — Human-readable description of the header
          - `isRequired` boolean, nullable
          - `isSecret` boolean, nullable
          - `default` string, nullable
          - `choices` string[], nullable
        - `authentication` MCPServerAuthenticationRequirement — Authentication requirements for a remote transport (SEP-2127).
          - `required` boolean, required — Whether authentication is mandatory
          - `schemes` string[] — Supported schemes (e.g. ['bearer', 'oauth2'])
      - `requires` ClientCapabilities — Capabilities a client may support.
        - `experimental` object, nullable
        - `sampling` SamplingCapability — Sampling capability structure, allowing fine-grained capability advertisement.
          - `context` SamplingContextCapability — Capability for context inclusion during sampling. Indicates support for non-'none' values in the includeContext parameter. SOFT-DEPRECATED: New implementations should use tools parameter instead.
          - `tools` SamplingToolsCapability — Capability indicating support for tool calling during sampling. When present in ClientCapabilities.sampling, indicates that the client supports the tools and toolChoice parameters in sampling requests.
        - `elicitation` ElicitationCapability — Capability for elicitation operations. Clients must support at least one mode (form or url).
          - `form` FormElicitationCapability — Capability for form mode elicitation.
          - `url` UrlElicitationCapability — Capability for URL mode elicitation.
        - `roots` RootsCapability — Capability for root operations.
          - `listChanged` boolean, nullable
        - `tasks` ClientTasksCapability — Capability for client tasks operations.
          - `list` TasksListCapability — Capability for tasks listing operations.
          - `cancel` TasksCancelCapability — Capability for tasks cancel operations.
          - `requests` ClientTasksRequestsCapability — Capability for tasks requests operations.
            - `sampling` TasksSamplingCapability — Capability for tasks sampling operations.
              - …
            - `elicitation` TasksElicitationCapability — Capability for tasks elicitation operations.
              - …
      - `resources` union
        - 'dynamic'
        - MCPResource[]
          - `name` string, required
          - `title` string, nullable
          - `uri` string, uri, required
          - `description` string, nullable
          - `mimeType` string, nullable
          - `size` integer, nullable
          - `icons` MCPServerIcon[], nullable
            - `src` string, required
            - `mimeType` string, nullable
            - `sizes` string[], nullable
          - `annotations` Annotations
            - `audience` string[], nullable
            - `priority` number, nullable
          - `_meta` object, nullable
      - `tools` union
        - 'dynamic'
        - MCPServerCardTool[]
          - `name` string, required
          - `title` string, nullable
          - `description` string, nullable
          - `inputSchema` object, required
          - `outputSchema` object, nullable
          - `icons` MCPServerIcon[], nullable
            - `src` string, required
            - `mimeType` string, nullable
            - `sizes` string[], nullable
          - `annotations` ToolAnnotations — Additional properties describing a Tool to clients. NOTE: all properties in ToolAnnotations are **hints**. They are not guaranteed to provide a faithful description of tool behavior (including descriptive properties like `title`). Clients should never make tool use decisions based on ToolAnnotations received from untrusted servers.
            - `title` string, nullable
            - `readOnlyHint` boolean, nullable
            - `destructiveHint` boolean, nullable
            - `idempotentHint` boolean, nullable
            - `openWorldHint` boolean, nullable
          - `_meta` MCPToolMeta — Typed _meta for MCP tools. Only the 'ui' field is typed. Other fields are allowed via extra="allow".
            - `ui` MCPUIToolMeta — UI metadata for tools that reference UI resources.
              - …
            - `ai.mistral/turbine` TurbineToolMeta
              - …
          - `execution` ToolExecution — Execution-related properties for a tool.
            - `taskSupport` 'forbidden' | 'optional' | 'required', nullable
      - `prompts` union
        - 'dynamic'
        - MCPPrompt[]
          - `name` string, required
          - `title` string, nullable
          - `description` string, nullable
          - `arguments` PromptArgument[], nullable
            - `name` string, required
            - `description` string, nullable
            - `required` boolean, nullable
          - `icons` MCPServerIcon[], nullable
            - `src` string, required
            - `mimeType` string, nullable
            - `sizes` string[], nullable
          - `_meta` object, nullable
      - `_meta` MCPServerCardMeta — Typed _meta for MCP server cards. Only the 'turbine' field is typed. Other fields are allowed via extra="allow".
        - `ai.mistral/turbine` TurbineMeta
          - `system_prompt_name` string, nullable
          - `locale` ServerLocale
            - `name` object, nullable
            - `description` object, nullable
            - `usage_sentence` object, nullable
            - `working_description` object, nullable
            - `done_description` object, nullable
    - `owner_id` string, nullable
    - `owner_type` 'user' | 'org' | 'workspace' | 'system', required
    - `visibility` 'shared_global' | 'shared_org' | 'shared_workspace' | 'private', required
    - `creator_id` string, nullable
    - `locale` ConnectorLocale
      - `name` object, required
      - `description` object, required
      - `usage_sentence` object, required
    - `system_prompt` string, nullable
    - `supported_auth_methods` PublicAuthenticationMethod[], nullable
      - `method_type` 'oauth2' | 'bearer' | 'none' | 'github_app' | 'slack_app', required
      - `headers` ConnectorAuthenticationHeader[], nullable
        - `name` string, required
        - `is_required` boolean
        - `is_secret` boolean
      - `global_headers` object
      - `has_default_credentials` boolean, required
      - `grant_type` 'authorization_code' | 'client_credentials'
      - `oauth2_server_metadata` ExtendedOAuthServerMetadata — Custom superset of RFC 8414 OAuth 2.0 Authorization Server Metadata. Stored at connector creation time (provided for HTTP connectors, discovered via .well-known for MCP). Mirrors the shape of .well-known/oauth-authorization-server responses.
        - `issuer` string, uri, required
        - `authorization_endpoint` string, uri, nullable
        - `token_endpoint` string, uri, required
        - `registration_endpoint` string, uri, nullable
        - `scopes_supported` string[], nullable
        - `response_types_supported` string[]
        - `response_modes_supported` string[], nullable
        - `grant_types_supported` string[], nullable
        - `token_endpoint_auth_methods_supported` string[], nullable
        - `token_endpoint_auth_signing_alg_values_supported` string[], nullable
        - `service_documentation` string, uri, nullable
        - `ui_locales_supported` string[], nullable
        - `op_policy_uri` string, uri, nullable
        - `op_tos_uri` string, uri, nullable
        - `revocation_endpoint` string, uri, nullable
        - `revocation_endpoint_auth_methods_supported` string[], nullable
        - `revocation_endpoint_auth_signing_alg_values_supported` string[], nullable
        - `introspection_endpoint` string, uri, nullable
        - `introspection_endpoint_auth_methods_supported` string[], nullable
        - `introspection_endpoint_auth_signing_alg_values_supported` string[], nullable
        - `code_challenge_methods_supported` string[], nullable
        - `client_id_metadata_document_supported` boolean, nullable
        - `x_source` 'autodiscovery' | 'provided' — How a connector's OAuth server metadata was obtained.
        - `x_resource_url` string, nullable
        - `x_scope` string, nullable
    - `connection_preferences` ConnectionPreference[], nullable
      - `name` string, required
      - `tool_configuration` ToolExecutionConfiguration, required
        - `requires_confirmation` union
          - string[]
          - LogicalExpression
            - `type` 'and' | 'or', required
            - `expressions` union[], required
              - …
          - ToolProperties
            - `read_only` boolean, nullable, required
        - `skip_confirmation` union
          - string[]
          - LogicalExpression
            - `type` 'and' | 'or', required
            - `expressions` union[], required
              - …
          - ToolProperties
            - `read_only` boolean, nullable, required
        - `include` string[], nullable
        - `exclude` string[], nullable
      - `is_default` boolean, nullable
      - `consumer_type` 'user' | 'org' | 'workspace' | 'system'
    - `connection_credentials` AuthenticationConfiguration[], nullable
      - `name` string, required
      - `title` string, nullable
      - `authentication_type` 'oauth2' | 'bearer' | 'none' | 'github_app' | 'slack_app', required
      - `scope` 'user' | 'org' | 'workspace' | 'system', required
      - `status` CredentialsStatus
        - `status_type` 'valid' | 'invalid' | 'error', required
        - `last_checked_at` string, date-time, nullable
        - `error_http_code` 100 | 101 | 102 | 103 | 200 | 201 | 202 | 203 | 204 | 205 | 206 | 207 | 208 | 226 | 300 | 301 | 302 | 303 | 304 | 305 | 307 | 308 | 400 | 401 | 402 | 403 | 404 | 405 | 406 | 407 | 408 | 409 | 410 | 411 | 412 | 413 | 414 | 415 | 416 | 417 | 418 | 421 | 422 | 423 | 424 | 425 | 426 | 428 | 429 | 431 | 451 | 500 | 501 | 502 | 503 | 504 | 505 | 506 | 507 | 508 | 510 | 511 — HTTP status codes and reason phrases Status codes from the following RFCs are all observed: * RFC 7231: Hypertext Transfer Protocol (HTTP/1.1), obsoletes 2616 * RFC 6585: Additional HTTP Status Codes * RFC 3229: Delta encoding in HTTP * RFC 4918: HTTP Extensions for WebDAV, obsoletes 2518 * RFC 5842: Binding Extensions to WebDAV * RFC 7238: Permanent Redirect * RFC 2295: Transparent Content Negotiation in HTTP * RFC 2774: An HTTP Extension Framework * RFC 7725: An HTTP Status Code to Report Legal Obstacles * RFC 7540: Hypertext Transfer Protocol Version 2 (HTTP/2) * RFC 2324: Hyper Text Coffee Pot Control Protocol (HTCPCP/1.0) * RFC 8297: An HTTP Status Code for Indicating Hints * RFC 8470: Using Early Data in HTTP
        - `error_message` 'oauth expired' | 'oauth near expiry' | 'empty credentials' | 'blank bearer token' | 'unparsable credentials' | 'you need to reconnect' | 'oauth refresh error' | 'MCP server unreachable' | 'MCP server timed out' | 'MCP server error' | 'unknown error'
      - `is_default` boolean
      - `creator_id` string, uuid, nullable
    - `active` boolean, nullable
    - `blocked_by` ConsumerType[]
    - `private_tool_execution` boolean, required
    - `supports_mcp` boolean, required — Whether this connector exposes an MCP-compatible tool interface.
    - `mistral` boolean
    - `is_authenticated` boolean, nullable
    - `tools` ConnectorTool[], nullable
      - `id` string, required
      - `name` string, required
      - `description` string, required
      - `system_prompt` string, nullable
      - `locale` ConnectorToolLocale
        - `name` object, required
        - `description` object, required
        - `usage_sentence` object, required
      - `jsonschema` object, nullable
      - `execution_config` ExecutionConfig, required — Not typed since mcp config can changed / not stable we allow all extra fields and this is a dict TODO: once mcp is stable, we need to type this
        - `type` string, required
      - `visibility` 'shared_global' | 'shared_org' | 'shared_workspace' | 'private', required
      - `created_at` string, date-time, required
      - `modified_at` string, date-time, required
      - `active` boolean, nullable
    - `system_prompt_route` string, nullable
    - `connection_config` PublicConnectionConfig
      - `type` 'mcp' | 'turbine' | 'eolienne'
      - `base_url` string, nullable
      - `headers` object, nullable
      - `signed` boolean, nullable
    - `execution_env` PublicExecutionEnv — Credentials-free projection of ExecutionEnv for the public /connectors/mistral response.
      - `tools` Tool[], required
        - `type` 'function'
        - `function` Function, required
          - `name` string, required
          - `description` string
          - `strict` boolean
          - `parameters` object, required
      - `tool_execution_data` PublicConnectorExecutionData, required
        - `integrations` PublicExecutionConnector[], required
          - `id` string, uuid, required
          - `name` string, required
          - `connection_config` PublicExecutionConnectionConfig, required — Connection config exposed in the public, unauthenticated /connectors/mistral response. Unlike ConnectionConfig, this has no `headers` field and forbids extra fields, so connector credentials can never be serialized into this cacheable response.
            - `type` 'mcp' | 'turbine' | 'eolienne', required
            - `server` string, nullable
            - `name` string, nullable
            - `id` string, nullable
            - `tool_configuration` ToolExecutionConfiguration
              - …
            - `hosted_internally` boolean
        - `tools` ExecutionTool[], required
          - `name` string, required
          - `integration_id` string, uuid, required
          - `execution_config` ExecutionConfig, required — Not typed since mcp config can changed / not stable we allow all extra fields and this is a dict TODO: once mcp is stable, we need to type this
            - `type` string, required
        - `use_connectors_gateway` boolean
      - `errors` string[], required
    - `protocol` 'mcp', required
  - HTTPConnector
    - `id` string, uuid, required
    - `name` string, required
    - `title` string, nullable
    - `description` string, required
    - `created_at` string, date-time, required
    - `modified_at` string, date-time, required
    - `server` string, nullable
    - `icon_url` string, nullable
    - `server_card` MCPServerCard
      - `$schema` string, nullable — URL to the JSON schema definition
      - `name` string, required — Server identifier in reverse-DNS format with exactly one /
      - `version` string, required — Server version (semantic versioning preferred)
      - `capabilities` ServerCapabilities — Capabilities that a server may support.
        - `experimental` object, nullable
        - `logging` LoggingCapability — Capability for logging operations.
        - `prompts` PromptsCapability — Capability for prompts operations.
          - `listChanged` boolean, nullable
        - `resources` ResourcesCapability — Capability for resources operations.
          - `subscribe` boolean, nullable
          - `listChanged` boolean, nullable
        - `tools` ToolsCapability — Capability for tools operations.
          - `listChanged` boolean, nullable
        - `completions` CompletionsCapability — Capability for completions operations.
        - `tasks` ServerTasksCapability — Capability for server tasks operations.
          - `list` TasksListCapability — Capability for tasks listing operations.
          - `cancel` TasksCancelCapability — Capability for tasks cancel operations.
          - `requests` ServerTasksRequestsCapability — Capability for tasks requests operations.
            - `tools` TasksToolsCapability — Capability for tasks tools operations.
              - …
      - `title` string, nullable
      - `description` string, nullable
      - `websiteUrl` string, nullable
      - `repository` MCPServerRepository — Source repository information (SEP-2127).
        - `url` string, required — Repository URL
        - `source` string, required — Source identifier (e.g. 'github')
        - `subfolder` string, nullable
      - `icons` MCPServerIcon[], nullable
        - `src` string, required
        - `mimeType` string, nullable
        - `sizes` string[], nullable
      - `remotes` MCPServerRemote[], nullable
        - `type` 'streamable-http' | 'sse', required — Transport type
        - `url` string, required — Transport endpoint URL
        - `supportedProtocolVersions` string[], nullable
        - `headers` MCPServerRemoteHeader[], nullable
          - `name` string, required — Header name
          - `description` string, required — Human-readable description of the header
          - `isRequired` boolean, nullable
          - `isSecret` boolean, nullable
          - `default` string, nullable
          - `choices` string[], nullable
        - `authentication` MCPServerAuthenticationRequirement — Authentication requirements for a remote transport (SEP-2127).
          - `required` boolean, required — Whether authentication is mandatory
          - `schemes` string[] — Supported schemes (e.g. ['bearer', 'oauth2'])
      - `requires` ClientCapabilities — Capabilities a client may support.
        - `experimental` object, nullable
        - `sampling` SamplingCapability — Sampling capability structure, allowing fine-grained capability advertisement.
          - `context` SamplingContextCapability — Capability for context inclusion during sampling. Indicates support for non-'none' values in the includeContext parameter. SOFT-DEPRECATED: New implementations should use tools parameter instead.
          - `tools` SamplingToolsCapability — Capability indicating support for tool calling during sampling. When present in ClientCapabilities.sampling, indicates that the client supports the tools and toolChoice parameters in sampling requests.
        - `elicitation` ElicitationCapability — Capability for elicitation operations. Clients must support at least one mode (form or url).
          - `form` FormElicitationCapability — Capability for form mode elicitation.
          - `url` UrlElicitationCapability — Capability for URL mode elicitation.
        - `roots` RootsCapability — Capability for root operations.
          - `listChanged` boolean, nullable
        - `tasks` ClientTasksCapability — Capability for client tasks operations.
          - `list` TasksListCapability — Capability for tasks listing operations.
          - `cancel` TasksCancelCapability — Capability for tasks cancel operations.
          - `requests` ClientTasksRequestsCapability — Capability for tasks requests operations.
            - `sampling` TasksSamplingCapability — Capability for tasks sampling operations.
              - …
            - `elicitation` TasksElicitationCapability — Capability for tasks elicitation operations.
              - …
      - `resources` union
        - 'dynamic'
        - MCPResource[]
          - `name` string, required
          - `title` string, nullable
          - `uri` string, uri, required
          - `description` string, nullable
          - `mimeType` string, nullable
          - `size` integer, nullable
          - `icons` MCPServerIcon[], nullable
            - `src` string, required
            - `mimeType` string, nullable
            - `sizes` string[], nullable
          - `annotations` Annotations
            - `audience` string[], nullable
            - `priority` number, nullable
          - `_meta` object, nullable
      - `tools` union
        - 'dynamic'
        - MCPServerCardTool[]
          - `name` string, required
          - `title` string, nullable
          - `description` string, nullable
          - `inputSchema` object, required
          - `outputSchema` object, nullable
          - `icons` MCPServerIcon[], nullable
            - `src` string, required
            - `mimeType` string, nullable
            - `sizes` string[], nullable
          - `annotations` ToolAnnotations — Additional properties describing a Tool to clients. NOTE: all properties in ToolAnnotations are **hints**. They are not guaranteed to provide a faithful description of tool behavior (including descriptive properties like `title`). Clients should never make tool use decisions based on ToolAnnotations received from untrusted servers.
            - `title` string, nullable
            - `readOnlyHint` boolean, nullable
            - `destructiveHint` boolean, nullable
            - `idempotentHint` boolean, nullable
            - `openWorldHint` boolean, nullable
          - `_meta` MCPToolMeta — Typed _meta for MCP tools. Only the 'ui' field is typed. Other fields are allowed via extra="allow".
            - `ui` MCPUIToolMeta — UI metadata for tools that reference UI resources.
              - …
            - `ai.mistral/turbine` TurbineToolMeta
              - …
          - `execution` ToolExecution — Execution-related properties for a tool.
            - `taskSupport` 'forbidden' | 'optional' | 'required', nullable
      - `prompts` union
        - 'dynamic'
        - MCPPrompt[]
          - `name` string, required
          - `title` string, nullable
          - `description` string, nullable
          - `arguments` PromptArgument[], nullable
            - `name` string, required
            - `description` string, nullable
            - `required` boolean, nullable
          - `icons` MCPServerIcon[], nullable
            - `src` string, required
            - `mimeType` string, nullable
            - `sizes` string[], nullable
          - `_meta` object, nullable
      - `_meta` MCPServerCardMeta — Typed _meta for MCP server cards. Only the 'turbine' field is typed. Other fields are allowed via extra="allow".
        - `ai.mistral/turbine` TurbineMeta
          - `system_prompt_name` string, nullable
          - `locale` ServerLocale
            - `name` object, nullable
            - `description` object, nullable
            - `usage_sentence` object, nullable
            - `working_description` object, nullable
            - `done_description` object, nullable
    - `owner_id` string, nullable
    - `owner_type` 'user' | 'org' | 'workspace' | 'system', required
    - `visibility` 'shared_global' | 'shared_org' | 'shared_workspace' | 'private', required
    - `creator_id` string, nullable
    - `locale` ConnectorLocale
      - `name` object, required
      - `description` object, required
      - `usage_sentence` object, required
    - `system_prompt` string, nullable
    - `supported_auth_methods` PublicAuthenticationMethod[], nullable
      - `method_type` 'oauth2' | 'bearer' | 'none' | 'github_app' | 'slack_app', required
      - `headers` ConnectorAuthenticationHeader[], nullable
        - `name` string, required
        - `is_required` boolean
        - `is_secret` boolean
      - `global_headers` object
      - `has_default_credentials` boolean, required
      - `grant_type` 'authorization_code' | 'client_credentials'
      - `oauth2_server_metadata` ExtendedOAuthServerMetadata — Custom superset of RFC 8414 OAuth 2.0 Authorization Server Metadata. Stored at connector creation time (provided for HTTP connectors, discovered via .well-known for MCP). Mirrors the shape of .well-known/oauth-authorization-server responses.
        - `issuer` string, uri, required
        - `authorization_endpoint` string, uri, nullable
        - `token_endpoint` string, uri, required
        - `registration_endpoint` string, uri, nullable
        - `scopes_supported` string[], nullable
        - `response_types_supported` string[]
        - `response_modes_supported` string[], nullable
        - `grant_types_supported` string[], nullable
        - `token_endpoint_auth_methods_supported` string[], nullable
        - `token_endpoint_auth_signing_alg_values_supported` string[], nullable
        - `service_documentation` string, uri, nullable
        - `ui_locales_supported` string[], nullable
        - `op_policy_uri` string, uri, nullable
        - `op_tos_uri` string, uri, nullable
        - `revocation_endpoint` string, uri, nullable
        - `revocation_endpoint_auth_methods_supported` string[], nullable
        - `revocation_endpoint_auth_signing_alg_values_supported` string[], nullable
        - `introspection_endpoint` string, uri, nullable
        - `introspection_endpoint_auth_methods_supported` string[], nullable
        - `introspection_endpoint_auth_signing_alg_values_supported` string[], nullable
        - `code_challenge_methods_supported` string[], nullable
        - `client_id_metadata_document_supported` boolean, nullable
        - `x_source` 'autodiscovery' | 'provided' — How a connector's OAuth server metadata was obtained.
        - `x_resource_url` string, nullable
        - `x_scope` string, nullable
    - `connection_preferences` ConnectionPreference[], nullable
      - `name` string, required
      - `tool_configuration` ToolExecutionConfiguration, required
        - `requires_confirmation` union
          - string[]
          - LogicalExpression
            - `type` 'and' | 'or', required
            - `expressions` union[], required
              - …
          - ToolProperties
            - `read_only` boolean, nullable, required
        - `skip_confirmation` union
          - string[]
          - LogicalExpression
            - `type` 'and' | 'or', required
            - `expressions` union[], required
              - …
          - ToolProperties
            - `read_only` boolean, nullable, required
        - `include` string[], nullable
        - `exclude` string[], nullable
      - `is_default` boolean, nullable
      - `consumer_type` 'user' | 'org' | 'workspace' | 'system'
    - `connection_credentials` AuthenticationConfiguration[], nullable
      - `name` string, required
      - `title` string, nullable
      - `authentication_type` 'oauth2' | 'bearer' | 'none' | 'github_app' | 'slack_app', required
      - `scope` 'user' | 'org' | 'workspace' | 'system', required
      - `status` CredentialsStatus
        - `status_type` 'valid' | 'invalid' | 'error', required
        - `last_checked_at` string, date-time, nullable
        - `error_http_code` 100 | 101 | 102 | 103 | 200 | 201 | 202 | 203 | 204 | 205 | 206 | 207 | 208 | 226 | 300 | 301 | 302 | 303 | 304 | 305 | 307 | 308 | 400 | 401 | 402 | 403 | 404 | 405 | 406 | 407 | 408 | 409 | 410 | 411 | 412 | 413 | 414 | 415 | 416 | 417 | 418 | 421 | 422 | 423 | 424 | 425 | 426 | 428 | 429 | 431 | 451 | 500 | 501 | 502 | 503 | 504 | 505 | 506 | 507 | 508 | 510 | 511 — HTTP status codes and reason phrases Status codes from the following RFCs are all observed: * RFC 7231: Hypertext Transfer Protocol (HTTP/1.1), obsoletes 2616 * RFC 6585: Additional HTTP Status Codes * RFC 3229: Delta encoding in HTTP * RFC 4918: HTTP Extensions for WebDAV, obsoletes 2518 * RFC 5842: Binding Extensions to WebDAV * RFC 7238: Permanent Redirect * RFC 2295: Transparent Content Negotiation in HTTP * RFC 2774: An HTTP Extension Framework * RFC 7725: An HTTP Status Code to Report Legal Obstacles * RFC 7540: Hypertext Transfer Protocol Version 2 (HTTP/2) * RFC 2324: Hyper Text Coffee Pot Control Protocol (HTCPCP/1.0) * RFC 8297: An HTTP Status Code for Indicating Hints * RFC 8470: Using Early Data in HTTP
        - `error_message` 'oauth expired' | 'oauth near expiry' | 'empty credentials' | 'blank bearer token' | 'unparsable credentials' | 'you need to reconnect' | 'oauth refresh error' | 'MCP server unreachable' | 'MCP server timed out' | 'MCP server error' | 'unknown error'
      - `is_default` boolean
      - `creator_id` string, uuid, nullable
    - `active` boolean, nullable
    - `blocked_by` ConsumerType[]
    - `private_tool_execution` boolean, required
    - `supports_mcp` boolean, required — Whether this connector exposes an MCP-compatible tool interface.
    - `mistral` boolean
    - `is_authenticated` boolean, nullable
    - `tools` ConnectorTool[], nullable
      - `id` string, required
      - `name` string, required
      - `description` string, required
      - `system_prompt` string, nullable
      - `locale` ConnectorToolLocale
        - `name` object, required
        - `description` object, required
        - `usage_sentence` object, required
      - `jsonschema` object, nullable
      - `execution_config` ExecutionConfig, required — Not typed since mcp config can changed / not stable we allow all extra fields and this is a dict TODO: once mcp is stable, we need to type this
        - `type` string, required
      - `visibility` 'shared_global' | 'shared_org' | 'shared_workspace' | 'private', required
      - `created_at` string, date-time, required
      - `modified_at` string, date-time, required
      - `active` boolean, nullable
    - `system_prompt_route` string, nullable
    - `connection_config` PublicConnectionConfig
      - `type` 'mcp' | 'turbine' | 'eolienne'
      - `base_url` string, nullable
      - `headers` object, nullable
      - `signed` boolean, nullable
    - `execution_env` PublicExecutionEnv — Credentials-free projection of ExecutionEnv for the public /connectors/mistral response.
      - `tools` Tool[], required
        - `type` 'function'
        - `function` Function, required
          - `name` string, required
          - `description` string
          - `strict` boolean
          - `parameters` object, required
      - `tool_execution_data` PublicConnectorExecutionData, required
        - `integrations` PublicExecutionConnector[], required
          - `id` string, uuid, required
          - `name` string, required
          - `connection_config` PublicExecutionConnectionConfig, required — Connection config exposed in the public, unauthenticated /connectors/mistral response. Unlike ConnectionConfig, this has no `headers` field and forbids extra fields, so connector credentials can never be serialized into this cacheable response.
            - `type` 'mcp' | 'turbine' | 'eolienne', required
            - `server` string, nullable
            - `name` string, nullable
            - `id` string, nullable
            - `tool_configuration` ToolExecutionConfiguration
              - …
            - `hosted_internally` boolean
        - `tools` ExecutionTool[], required
          - `name` string, required
          - `integration_id` string, uuid, required
          - `execution_config` ExecutionConfig, required — Not typed since mcp config can changed / not stable we allow all extra fields and this is a dict TODO: once mcp is stable, we need to type this
            - `type` string, required
        - `use_connectors_gateway` boolean
      - `errors` string[], required
    - `protocol` 'http', required

## Other responses

- `422` — Validation Error

## Changes

- **2026-09-23** `fa73befe1c61` — 11 breaking, 32 warning, 3 info
  - the request's body type changed from `object` to no type
  - added `#/components/schemas/MCPConnector, #/components/schemas/HTTPConnector` to the response body `oneOf` list for the response status `201`
  - the response's body type changed from `object` to no type for status `201`
  - removed the required property `created_at` from the response with the `201` status
  - …42 more
- **2026-08-14** `61436a496404` — 1 breaking, 4 warning, 10 info
  - the `owner_type` response's property type changed from `integer` to `string` for status `201`
  - added the new `org` enum value to the `owner_type` response property for the response status `201`
  - added the new `system` enum value to the `owner_type` response property for the response status `201`
  - added the new `user` enum value to the `owner_type` response property for the response status `201`
  - …11 more
- …earlier changes not shown

[Full history](https://skmtc.dev/mistral/apis/mistral-ai-api/changes/v1/connectors/post.md)

---

[API](https://skmtc.dev/mistral/apis/mistral-ai-api.md) · [All operations](https://skmtc.dev/mistral/apis/mistral-ai-api/llms.txt) · [OpenAPI document](https://skmtc.dev/mistral/apis/mistral-ai-api/revisions/fa73befe1c61?raw)