# Create personal connector configuration

div
strong
🔨 In Development
 — This section is still being developed and may change.

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

#### Authentication

- `Authorization: Bearer $FREDDY_API_KEY`


## Request body

**`connector_type`** string required
Connector integration key (e.g., `notion`, `slack`, `github`).

**`name`** string required
Human-readable label shown in dashboards.

**`description`** string optional
Explain what the configuration enables.

**`credentials`** object required
Authentication payload for the external service. Schema varies by connector.

**`settings`** object optional
Connector-specific options (scopes, filters, sync preferences).

**`is_active`** boolean optional
Activate immediately. Defaults to `true`.

## Returns

Configuration metadata.


```json
{
  "id": "config_abc123",
  "connector_type": "notion",
  "name": "My Notion Workspace",
  "description": "Access to my personal Notion workspace",
  "is_active": true,
  "created_at": "2025-01-15T10:30:00Z",
  "last_used": null
}
```

Request

```bash
curl -X POST "https://api.freddy.aitronos.com/v1/personal-connectors/configurations" \
  -H "Authorization: Bearer $FREDDY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "connector_type": "notion",
    "name": "My Notion Workspace",
    "description": "Access to my personal Notion workspace",
    "credentials": {
      "api_key": "NOTION_API_KEY",
      "workspace_id": "workspace_123"
    },
    "settings": {
      "allowed_pages": ["page1", "page2"],
      "read_only": false
    },
    "is_active": true
  }'
```

## Related resources

- [Personal connector configuration object](/docs/api-reference/objects/personal-connector-configuration-object)
- [List configurations](/docs/api-reference/personal-connectors/configurations/list)
- [Get configuration](/docs/api-reference/personal-connectors/configurations/get)
- [Update configuration](/docs/api-reference/personal-connectors/configurations/update)
- [Delete configuration](/docs/api-reference/personal-connectors/configurations/delete)