Create Connection

Create a new connection with validation.

This endpoint validates the provided credentials and configuration against the integration’s requirements before creating the connection.

Validation includes:

• Required fields are present
• Field types match expected types (email, url, etc.)
• Values match validation patterns (regex)
• Length constraints are met
• OAuth credentials are valid (if applicable)

Example:

{
    "label": "My Gmail Connection",
    "integration": "gmail",
    "integration_type": "connectors",
    "auth_method_id": "oauth2",
    "credentials": {
        "access_token": "ya29.a0...",
        "refresh_token": "1//0g...",
        "token_type": "Bearer",
        "expires_at": "2025-10-19T12:00:00Z"
    },
    "config": {}
}

Error Response (validation failure):

{
    "detail": {
        "message": "Connection validation failed",
        "errors": [
            "Field 'API Key' is required",
            "Field 'Email' must be a valid email address"
        ]
    }
}