Skip to content
Last updated

Create personal connector configuration

Provision a new configuration that enables Freddy personal connectors to securely access third-party services.

POSThttps://api.aitronos.com/v1/personal-connectors/configurations

Request body

personalConnectorId string required
The ID of the personal connector to configure (e.g., pcon_github, pcon_clickup). Reference to a Personal Connector Object.

name string required
Human-readable label shown in dashboards. Example: "My GitHub Account", "Work ClickUp".

configuration object optional
Connector-specific configuration settings. Structure varies by connector type. See Personal Connector Configuration Object for examples.

credentials object required
Authentication payload for the external service. Schema varies by connector and authentication method. Credentials are encrypted at rest.

description string optional
Optional description explaining what the configuration enables.

metadata object optional
Custom key-value pairs for tagging and filtering configurations.

enabled boolean optional
Whether to activate the configuration immediately. Defaults to true.

Returns

A Personal Connector Configuration Object with all fields populated. Note that credentials are always returned as ***REDACTED*** for security reasons.

Bash
curl -X POST "https://api.aitronos.com/v1/personal-connectors/configurations" \
  -H "X-API-Key: $FREDDY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "personalConnectorId": "pcon_github",
    "name": "My GitHub Account",
    "credentials": {
      "token": "ghp_xxxxxxxxxxxx"
    },
    "configuration": {
      "repository": "aitronos/freddy-backend"
    }
  }'

Response:

{
  "success": true,
  "data": {
    "id": "pconf_abc123",
    "object": "personal_connector.configuration",
    "userId": "user_xyz789",
    "apiKeyId": null,
    "organization_id": "org_123",
    "personalConnectorId": "pcon_github",
    "name": "My GitHub Account",
    "configuration": {
      "repository": "aitronos/freddy-backend"
    },
    "credentials": "***REDACTED***",
    "enabled": true,
    "healthStatus": "unknown",
    "lastSyncAt": null,
    "lastError": null,
    "description": null,
    "metadata": {},
    "created_at": "2025-11-13T10:45:00Z",
    "updated_at": "2025-11-13T10:45:00Z"
  }
}