---
title: CXHandle
framework: callkit
role: symbol
role_heading: Class
path: callkit/cxhandle
---

# CXHandle

A way to reach a call recipient, such as a phone number or email address.

## Declaration

```swift
class CXHandle
```

## Mentioned in

Making and receiving VoIP calls

## Overview

Overview When the telephony provider receives an incoming call or the user starts an outgoing call, the other caller is identified by a CXHandle object. For a caller identified by a phone number, the handle type is CXHandle.HandleType.phoneNumber and the value is a sequence of digits. For a caller identified by an email address, the handle type is CXHandle.HandleType.emailAddress and the value is an email address. For a caller identified in any other way, the handle type is CXHandle.HandleType.generic and the value typically follows some domain-specific format, such as a username, numeric ID, or URL.

## Topics

### Creating New Handles

- [init(type:value:)](callkit/cxhandle/init(type:value:).md)

### Accessing Handle Attributes

- [type](callkit/cxhandle/type.md)
- [value](callkit/cxhandle/value.md)

### Constants

- [CXHandle.HandleType](callkit/cxhandle/handletype.md)

### Initializers

- [init(coder:)](callkit/cxhandle/init(coder:).md)

## Relationships

### Inherits From

- [NSObject](objectivec/nsobject-swift.class.md)

### Conforms To

- [CVarArg](swift/cvararg.md)
- [CustomDebugStringConvertible](swift/customdebugstringconvertible.md)
- [CustomStringConvertible](swift/customstringconvertible.md)
- [Equatable](swift/equatable.md)
- [Hashable](swift/hashable.md)
- [NSCoding](foundation/nscoding.md)
- [NSCopying](foundation/nscopying.md)
- [NSObjectProtocol](objectivec/nsobjectprotocol.md)
- [NSSecureCoding](foundation/nssecurecoding.md)

## See Also

### Call information

- [CXCall](callkit/cxcall.md)
- [CXCallObserver](callkit/cxcallobserver.md)
- [CXCallObserverDelegate](callkit/cxcallobserverdelegate.md)