Create connection

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" }'

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

string

required

Human-readable name. 1–100 characters.

string

required

The connector to configure, e.g. slack, github.

string

required

The auth method, e.g. apiKey, basic, oauth2.

object

required

Key-value credential map. Keys and structure are connector-specific.

string

PRIVATE (default) | SPACE | GLOBAL

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"
}

Overview

Pages

Work Items

Test Management

Automation

SCIM 2.0

Health

Request body

​Request body

Request body