---
title: "transferProvisionalHome(connectionDetails:targetHomeUniqueIdentifier:)"
framework: HomeKit
role: symbol
role_heading: Instance Method
platforms: [iOS 27.2+, iPadOS 27.2+, Mac Catalyst 27.2+, visionOS 27.2+]
path: "homekit/hmhome/transferprovisionalhome(connectiondetails:targethomeuniqueidentifier:)"
---

# transferProvisionalHome(connectionDetails:targetHomeUniqueIdentifier:)

Transfers a temporary, provisional home to a person’s home hub.

## Declaration

```swift
func transferProvisionalHome(connectionDetails: HMHome.ProvisionalHomeConnectionDetails, targetHomeUniqueIdentifier: UUID) async throws(HMHome.ProvisionalHomeTransferError) -> HMHome.ProvisionalHomeTransferResult
```

## Parameters

- `connectionDetails`: A structure containing the opaque token HomeKit uses to transfer a provisional home to a home hub.
- `targetHomeUniqueIdentifier`: The UUID you obtain from the home installation server that identifies the destination home on a home hub. This UUID is distinct from a provisional home’s own identifier.

## Return Value

Return Value Transfer results for each accessory, allowing you to identify a partially successful transfer.

## Overview

Overview When you transfer a temporary home to a person’s home hub, HomeKit encodes a snapshot of all paired accessories, creates a secure channel with the connection details’ transferToken, and uses the channel to send the snapshot to the home hub. note: Error information for failures that occur when transferring a temporary, provisional home to a person’s home hub.

## See Also

### Providing installation services

- [isProvisionalHome](homekit/hmhome/isprovisionalhome.md)
- [isProvisionalHome(forPairingIdentifier:)](homekit/hmhome/isprovisionalhome(forpairingidentifier:).md)
- [HMHome.ProvisionalHomeConnectionDetails](homekit/hmhome/provisionalhomeconnectiondetails.md)
- [HMHome.ProvisionalHomeTransferResult](homekit/hmhome/provisionalhometransferresult.md)
- [HMHome.ProvisionalHomeTransferError](homekit/hmhome/provisionalhometransfererror.md)
