AgentConnect
MCP providers

Create a connector connection

Provision a new open-connector connection and record it as an open_connector MCP provider (named connectionName, org-unique). For api-key/custom/no-auth the credentials are saved immediately; for oauth2 an authorizationUrl is returned to open in a popup. The grant key is returned exactly once.

POST
/v1/orgs/{orgId}/connectors/connections

Authorization

bearerAuth
AuthorizationBearer <token>

In: header

Path Parameters

orgId*string

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/v1/orgs/string/connectors/connections" \  -H "Content-Type: application/json" \  -d '{    "service": "string",    "connectionName": "string",    "authType": "oauth2"  }'
{  "id": "string",  "name": "string",  "kind": "string",  "transport": "string",  "url": "string",  "service": "string",  "visibility": "string",  "sharedWith": [    "string"  ],  "ui": true,  "createdBy": "string",  "canEdit": true,  "canManageSharing": true,  "headerNames": [    "string"  ],  "auth": "string",  "oauth": {    "status": "string",    "issuer": "string",    "scopes": [      "string"    ],    "clientSource": "string",    "expiresAt": "string"  },  "createdAt": "string",  "grantKey": "string",  "authorizationUrl": "string"}