> For the complete documentation index, see [llms.txt](https://help.realviewhub.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.realviewhub.com/integrations/data-migration.md).

# Data Migration

## &#x20;<a href="#h_dcd84dc2fa" id="h_dcd84dc2fa"></a>

### Introduction <a href="#h_6a21b858c7" id="h_6a21b858c7"></a>

This guide outlines the process of migrating your customer database from third-party providers, such as HD Photo Hub and Aryeo, to your Realview Hub platform. This migration allows you to consolidate your customer data and provide them with access to the new platform.

### Prerequisites <a href="#h_91b774e469" id="h_91b774e469"></a>

Before you begin the migration process, ensure you have the following:

* Access to your Realview Hub account.
* The API Key from your previous provider (HD Photo Hub or Aryeo). This key is typically found in your account settings with the third-party provider.
* Your HD Photo Hub Domain Name (if migrating from HD Photo Hub and using a custom domain).

### Steps <a href="#h_2fdf327a59" id="h_2fdf327a59"></a>

### 1. Navigate to Settings <a href="#h_044b6575f2" id="h_044b6575f2"></a>

From the main Realview Hub application interface, locate and click on the Settings icon, usually represented by a gear icon.

### 2. Access the Migration Tab <a href="#h_9e77c23099" id="h_9e77c23099"></a>

In the left-hand navigation menu, under the "Integration" section, click on Migration.

### 3. Select Your Third-Party Provider <a href="#h_d1c9c459ac" id="h_d1c9c459ac"></a>

On the Migration page, you will see sections for different third-party providers.

* Locate the section titled Migrate from HD Photo Hub or Migrate from Aryeo, depending on your previous provider.
* Click on the section header to expand it if it is not already open.

### 4. Enter API Configuration Details <a href="#h_c73e4aaa1b" id="h_c73e4aaa1b"></a>

Provide the necessary API credentials for your chosen provider:

* For HD Photo Hub:
  * In the HD Photo Hub Domain field, enter your domain name (e.g., `yourdomain.com`). The system will automatically add `https://` and `/api/v1/users` to the URL.
  * In the API Key field, enter your HD Photo Hub API key.
* For Aryeo:
  * In the API Key field, enter your Aryeo API key.

### 5. Validate API <a href="#h_fbccbb884e" id="h_fbccbb884e"></a>

After entering the required information, click the Validate API button. This action will retrieve your customer database, including customer names, email addresses, telephone numbers, and other relevant customer information.

### 6. Map Customer Data (Field Mapping) <a href="#h_d29d0db85b" id="h_d29d0db85b"></a>

Upon successful API validation, you will proceed to the "Field Mapping" stage. Here, you will map the retrieved customer data fields from your previous provider to the corresponding fields within your Realview Hub customer database. You can specify how fields like first name, last name, full name, company email, or personal email should be imported.

### 7. Complete Migration <a href="#h_e2d9acc58b" id="h_e2d9acc58b"></a>

Once you have completed the data mapping, proceed with the "Migration" step to import your customers into Realview Hub.

### 8. Create Customer Logins (Optional) <a href="#h_0db577a6b4" id="h_0db577a6b4"></a>

After the migration is complete, you will be prompted to create logins for the newly imported customers. You have two options:

* Create logins for all imported customers: This will generate login credentials for every customer migrated.
* Select individual customers: This allows you to choose specific customers for whom you want to create logins.

If you choose to create logins, the system will automatically generate a login for each selected customer and send them an email containing a password reset link. Customers can then click this link, set a new password, and gain access to the Realview Hub platform.

### Tips <a href="#h_29b6af2279" id="h_29b6af2279"></a>

* Always ensure you have the correct and up-to-date API credentials from your previous provider to facilitate a smooth migration.
* The migration process is designed for efficiency, often completing within seconds once the API is validated and data is mapped.
* Review the field mapping carefully to ensure all customer data is imported and organized as desired in Realview Hub.

### Conclusion <a href="#h_949ceede5e" id="h_949ceede5e"></a>

By following these steps, you can successfully migrate your customer data from third-party providers to Realview Hub, enabling a seamless transition and providing your customers with access to your new platform.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://help.realviewhub.com/integrations/data-migration.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.