> ## Documentation Index
> Fetch the complete documentation index at: https://docs.contactsmanager.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Canonical Contact

> Server-side user profile information in the ContactsManager SDK

# Canonical Contact

The `CanonicalContact` model represents a user's profile in the ContactsManager ecosystem. This is the server-side representation of a user that can be used for social features, recommendations, and cross-device syncing.

## Properties

### Identity

* `id: String` - Unique identifier for the user
* `organizationId: String?` - Organization the user belongs to
* `organizationUserId: String` - User identifier within the organization

### User Information

* `fullName: String` - User's full name
* `email: String?` - User's email address
* `phone: String?` - User's phone number
* `avatarUrl: String?` - URL to user's profile image

### Status

* `isActive: Bool?` - Whether the user account is active
* `createdAt: Date?` - When the user profile was created
* `updatedAt: Date?` - When the user profile was last updated

### Metadata

* `contactMetadata: [String: Any]?` - Custom metadata for the user profile

## Usage Example

```swift theme={null}
// Using a canonical contact from API response
func displayUserProfile(canonicalContact: CanonicalContact) {
    userNameLabel.text = canonicalContact.fullName
    
    if let email = canonicalContact.email {
        emailLabel.text = email
    } else {
        emailLabel.isHidden = true
    }
    
    if let avatarUrl = canonicalContact.avatarUrl, let url = URL(string: avatarUrl) {
        // Load avatar image from URL
        loadProfileImage(url: url)
    } else {
        // Display default profile image
        profileImageView.image = UIImage(named: "default_avatar")
    }
    
    // Access custom metadata if available
    if let metadata = canonicalContact.contactMetadata,
       let userLevel = metadata["userLevel"] as? Int {
        userLevelLabel.text = "Level: \(userLevel)"
    }
}

// Following a user with their canonical contact info
func followUser(canonicalUser: CanonicalContact) async {
    do {
        let result = try await ContactsService.shared.socialService.followUser(
            userId: canonicalUser.organizationUserId
        )
        
        if let success = result.success, success {
            print("Successfully followed \(canonicalUser.fullName)")
        }
    } catch {
        print("Error following user: \(error.localizedDescription)")
    }
}
```

## Related Models

* [Contact](/models/contact) - Local device contact information
* [LocalCanonicalContact](/models/local-canonical-contact) - Links local contacts with canonical users
* [FollowRelationship](/models/follow-relationship) - Social connection between users