Skip to content
Last updated

Create personal connector configuration

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

Note: This endpoint is planned for an upcoming release. The API is not yet available.

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