Creates a person object with the specified display name and contact information.


convenience init(handle: String, nameComponents: PersonNameComponents, contactIdentifier: String?)



A string containing information that your app uses to identify the user. You can use an email address, phone number, account name, or any information that lets you identify the user uniquely.


The name of the user, specified as a set of name components.


The identifier associated with the user's CNContact object. Specify a value for this parameter when the user has a corresponding entry in the Contacts database.

Return Value

An initialized person object or nil if the object could not be created.


Use this method as a convenient way to create person objects that do not require an image.

Beta Software

This documentation contains preliminary information about an API or technology in development. This information is subject to change, and software implemented according to this documentation should be tested with final operating system software.

Learn more about using Apple's beta software