Connect Connector
Create a connection to a connector. For OAuth2 connectors, returns an oauth2_required response with a connector_page_url to complete browser auth.
connector_id in the connector page URL at chat.xpander.ai/connectors/{connector_id}, or via List Tools with ?type=connector&query=....
For API-key connectors, send the key as "security": {"authMethod": "apiKey", "apiKey": "<your-connector-api-key>"}. A security object in any other shape is accepted but stores no key, and calls through the connection then fail. The connection is created immediately and its id is your connection_id for List Connector Operations and Invoke Connector Operation. For OAuth2 connectors, the response is oauth2_required with a connector_page_url. Open it in a browser to finish authentication, then fetch the new connection’s id from List Tools.Body
Request model for creating a new connection to a connector.
A connection binds a connector to your organization with specific
authentication credentials and settings. The security and headers
fields are write-only — they are accepted on create but never returned
in any response for security reasons.
For OAuth2 connectors, the API may return an oauth2_required response with a URL to complete browser-based authentication.
Authentication credentials for this connection (WRITE-ONLY — never returned in responses). Structure depends on the connector's auth type: API key auth: {'authMethod': 'apiKey', 'apiKey': '...', 'headerName': 'X-API-Key'}. OAuth2: {'authMethod': 'oauth2', 'oauth2Token': {...}}.
Response
Successful Response

