Skip to main content
POST
/
api
/
v1
/
automation
/
connections
curl -X POST "https://your-collabase.ch/api/v1/automation/connections" \
  -H "Authorization: Bearer cba_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "name": "GitHub Actions Bot",
    "connectorId": "github",
    "authType": "apiKey",
    "config": {
      "token": "ghp_xxxxxxxxxxxxxxxxxxxx"
    },
    "visibility": "SPACE",
    "spaceId": "space-001"
  }'

{
  "id": "conn-xyz",
  "name": "GitHub Actions Bot",
  "connectorId": "github",
  "visibility": "SPACE"
}
Creates a new connector connection. Credentials are stored encrypted and never returned in plain text after creation.
The config map contains raw credentials (API keys, tokens). Ensure you are making this request over HTTPS. Values are stored encrypted at rest.

​
Request body

​
name
string
required
Human-readable name. 1–100 characters.
​
connectorId
string
required
The connector to configure, e.g. slack, github.
​
authType
string
required
The auth method, e.g. apiKey, basic, oauth2.
​
config
object
required
Key-value credential map. Keys and structure are connector-specific.
​
visibility
string
PRIVATE (default) | SPACE | GLOBAL
​
spaceId
string
Required if visibility is SPACE.
curl -X POST "https://your-collabase.ch/api/v1/automation/connections" \
  -H "Authorization: Bearer cba_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "name": "GitHub Actions Bot",
    "connectorId": "github",
    "authType": "apiKey",
    "config": {
      "token": "ghp_xxxxxxxxxxxxxxxxxxxx"
    },
    "visibility": "SPACE",
    "spaceId": "space-001"
  }'

{
  "id": "conn-xyz",
  "name": "GitHub Actions Bot",
  "connectorId": "github",
  "visibility": "SPACE"
}