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

# RoofScope

## Overview

The Zuper and RoofScope integration enables roofing service teams to manage property measurements seamlessly, all within the Zuper platform. With this integration, you can:

* Order a new measurement directly from a Zuper job.
* Sync existing RoofScope projects to Zuper jobs.
* View, edit, and download measurement data.
* Track all measurements in Zuper’s Measurements Tab.

This integration enhances accuracy, visibility, and efficiency across your roofing workflow from measurement to execution.

## **Plans Applicable**

* You need to have a valid **Growth**, **Advantage**, or **Scale** plan in RoofScope to enable measurements in Zuper.
* The customers with **Core** or **Premium** plans on Zuper will have access to the RoofScope integration.

## **Zuper Prerequisites**

* Users must have the “**Order Measurements from External Provider**” role permission enabled to place measurement orders with RoofScope.
* Ensure your settings workspace is set up with the Jobs module enabled.
* For integrations, you will need an API Key and a Scope Token from RoofScope.

![ZHS1](https://mintcdn.com/zuperinc/ft2RmjweBAspTMaP/images/ZHS1.png?fit=max\&auto=format\&n=ft2RmjweBAspTMaP\&q=85\&s=73223b74504827ba3e485aef0958f6d8)

 Once set, users with this role can initiate measurement orders from job details.

### **Managing Measurement Tokens**

Measurement tokens define the specific data points (e.g., lengths, areas) that Zuper pulls from external providers. You can enable or disable these to tailor what appears in your Measurement object in the job details page.

Read more  [**here**](https://docs.zuper.co/Settings/Modules/Jobs/Configuring_Measurements.md)

## How to connect the RoofScope Integration?

1. Log in to your Zuper app, click the **User** icon, and tap on the **App Store**.

![Roofscope11](https://mintcdn.com/zuperinc/osz7CqocwrZuWB17/images/Roofscope11.png?fit=max\&auto=format\&n=osz7CqocwrZuWB17\&q=85\&s=2f786d9b9cef1b0305752b2e5f08530c)

2. Under the **Browse by Category**, select the **Measurements & Estimations** option and choose **RoofScope**.

![Roofscope25](https://mintcdn.com/zuperinc/osz7CqocwrZuWB17/images/Roofscope25.png?fit=max\&auto=format\&n=osz7CqocwrZuWB17\&q=85\&s=ef247c01e0336dfd9028cac0c399359d)

3. On the RoofScope app page, click “**Configure Settings**.”

![Roofscope26](https://mintcdn.com/zuperinc/osz7CqocwrZuWB17/images/Roofscope26.png?fit=max\&auto=format\&n=osz7CqocwrZuWB17\&q=85\&s=1fdb9c8f3ca6959847d50f71482599c4)

4. Fill in the following details: a. **RoofScope API Key** -  To obtain an API key from RoofScope, email your request to [support@myscopetech.com](mailto:support@myscopetech.com).   b. **RoofScope Scope Token** – Login to RoofScope. From the top right corner, under “**My Details**,” copy the “**Scope API Token**.”
   > [!NOTE]
   >
   > Note: The RoofScope token is valid for only one year.
    c. **How to Generate a Zuper API Key** You need a Zuper API Key to complete RoofScope setup: Zuper API Keys are essential for securely authenticating and authorizing access to the Zuper API. These keys enable seamless integration with Zuper’s services, allowing developers to build robust applications that leverage real-time data and functionality. Click [**here**](https://docs.zuper.co/Settings/Developer_Hub/API_Keys.md) to know more.
   4. **Navigation**: Settings -> Developer Hub -> API Keys
   Enter your Zuper API Key.

Click “**Update**” to activate RoofScope.

![Roofscope27](https://mintcdn.com/zuperinc/osz7CqocwrZuWB17/images/Roofscope27.png?fit=max\&auto=format\&n=osz7CqocwrZuWB17\&q=85\&s=c6bed4dbef6b5f1b49a50863a128c38c)

Your RoofScope integration is now active and ready to use!

## How to Order a New RoofScope Measurement?

* From any job in Zuper, you can request a new measurement:
* Open the Job Details page. Go to the Measurement tab.
* Click + New Measurement and select “**RoofScope**” from the context menu.

![Roofscope17](https://mintcdn.com/zuperinc/osz7CqocwrZuWB17/images/Roofscope17.png?fit=max\&auto=format\&n=osz7CqocwrZuWB17\&q=85\&s=ae4f1e829f616582c007bfdb245da67f)

![Roofscope2](https://mintcdn.com/zuperinc/osz7CqocwrZuWB17/images/Roofscope2.png?fit=max\&auto=format\&n=osz7CqocwrZuWB17\&q=85\&s=a275aaa28960d1d28ede3d76f3141c90)

### **Order New Measurement**

Fill in the following details:

*  **Property Type (Mandatory) –** Choose the applicable property type from the dropdown - Residential or Commercial.
* **Measurement Type (Mandatory)** – Choose the type of measurement from the dropdown – **RoofscopeX**, **RoofScope**,**RoofScope +** , **GutterScope**, and **SidingScope**.
* **Deliverable Options (Mandatory)** – Select the delivery options from the dropdown: **Standard** and **Rush**.
* **Auxiliary Building (Mandatory)** – Enter the number of auxiliary buildings covered by this measurement.
* Additional Note for Technicians – Enter the additional information.

  Click “**Next.**”

![Roofscope3](https://mintcdn.com/zuperinc/osz7CqocwrZuWB17/images/Roofscope3.png?fit=max\&auto=format\&n=osz7CqocwrZuWB17\&q=85\&s=a5e866aba6f5a580777564969f35f819)

## Insurance Claim Details

* Claim / Reference Number – Enter the insurance claim number.
* Date of loss – Enter the date of damage.

After reviewing all fields, click **Place Order**.\
The new measurement request will appear in the Measurement tab as '**In Progress**' and will be moved to the '**Completed**' status.

![Roofscope5 1](https://mintcdn.com/zuperinc/5CHTxATq5Zam64v6/images/Roofscope5-1.png?fit=max\&auto=format\&n=5CHTxATq5Zam64v6\&q=85\&s=6fa25b0f4fdcbff5059ea602b75dc443)

![Roofscope6](https://mintcdn.com/zuperinc/5CHTxATq5Zam64v6/images/Roofscope6.png?fit=max\&auto=format\&n=5CHTxATq5Zam64v6\&q=85\&s=22f02c7711fc8b10e473414a5a63ef50)

## **Select an Existing Project**

If you’ve already created a RoofScope project for the property, you can link it instead of starting fresh:

* The service address auto-fills in the search bar.
* RoofScope displays all matching measurements for that address.
* Select the desired measurement.
* It instantly syncs with the Zuper job.

![Roofscope18](https://mintcdn.com/zuperinc/osz7CqocwrZuWB17/images/Roofscope18.png?fit=max\&auto=format\&n=osz7CqocwrZuWB17\&q=85\&s=66b92b9d031aace8ac7374ade023274c)

![Roofscope22](https://mintcdn.com/zuperinc/osz7CqocwrZuWB17/images/Roofscope22.png?fit=max\&auto=format\&n=osz7CqocwrZuWB17\&q=85\&s=21cfdf8170691ce6c517f702ff15a3ad)

## Viewing Synced Measurements

When RoofScope measurements are available, they automatically sync to Zuper.

Once measurements are synced back from RoofScope, you can view and manage them in Zuper.

**Viewing Synced Measurements**

* Go to the **Measurement** tab.
* Click the **Completed Measurement Card**.
* Review synced values mapped to Zuper’s standard measurement tokens.
* Click "**View In**" and choose "**PDF**."

![Roofscope20](https://mintcdn.com/zuperinc/osz7CqocwrZuWB17/images/Roofscope20.png?fit=max\&auto=format\&n=osz7CqocwrZuWB17\&q=85\&s=235d5f49a5320602bcce37e7a4cd4122)

 Click the “**Kebab**” menu to “**Edit**” or “**Remove**” the measurement tokens.

### **Edit the synced measurements.**

* Click the **✏️ Edit** icon or open the **⋮ menu → Edit**.
* Make your changes and save.
* Edited fields display an “Edited” label.
* All edits are logged in **Job Activity**.

![Roofscope13 1](https://mintcdn.com/zuperinc/osz7CqocwrZuWB17/images/Roofscope13-1.png?fit=max\&auto=format\&n=osz7CqocwrZuWB17\&q=85\&s=f145423a41211287e4aa9587935ffd43)

![Roofscope14](https://mintcdn.com/zuperinc/osz7CqocwrZuWB17/images/Roofscope14.png?fit=max\&auto=format\&n=osz7CqocwrZuWB17\&q=85\&s=28a43f65bb62c737c3b153557253c259)

### **Manually sync measurement data**

When you place a measurement order, RoofScope processes the request and automatically sends the data back to Zuper. However, if your order status shows **Completed** in RoofScope but the measurement data has not yet synced in Zuper, you can trigger a manual sync to pull the measurement data.

1. Locate the RoofScope measurement card you want to sync.
2. Select the context menu icon (three-dot icon) on the right side of the measurement card.
3. Select **Sync from RoofScope** from the menu.

![GA Fnew1 1](https://mintcdn.com/zuperinc/gVuF8x8sTxUbM74i/images/GAFnew1-1.png?fit=max\&auto=format\&n=gVuF8x8sTxUbM74i\&q=85\&s=3c3f7787f51ca2838889b066ecc577d3)

### **Removing Measurements**

* Open the **⋮ Menu** → **Remove**.
* Confirm removal.
* Measurement is unlinked from the job, and the action is logged in **Job Activity**.

![Roofscope21](https://mintcdn.com/zuperinc/osz7CqocwrZuWB17/images/Roofscope21.png?fit=max\&auto=format\&n=osz7CqocwrZuWB17\&q=85\&s=8f544e7e565e53d28a9718a918610769)

* Click the “**Activity**” tab to view all the measurement-related activities.

![Eagleview25](https://mintcdn.com/zuperinc/Upc8TAtzw21tq2Pp/images/Eagleview25.png?fit=max\&auto=format\&n=Upc8TAtzw21tq2Pp\&q=85\&s=8599d6e0301aefca24720ffc27254a6a)

## How to Uninstall RoofScope from Zuper? 

1. Click on your Profile Picture in the top right corner of the screen and select the “**App Store."**

![Roofscope11](https://mintcdn.com/zuperinc/osz7CqocwrZuWB17/images/Roofscope11.png?fit=max\&auto=format\&n=osz7CqocwrZuWB17\&q=85\&s=2f786d9b9cef1b0305752b2e5f08530c)

2. Under the “**Browse by Category**,” select the “**Measurements and Estimations**” option and choose “**RoofScope**.”

![Roofscope25](https://mintcdn.com/zuperinc/osz7CqocwrZuWB17/images/Roofscope25.png?fit=max\&auto=format\&n=osz7CqocwrZuWB17\&q=85\&s=ef247c01e0336dfd9028cac0c399359d)

3. Click the “**Uninstall**” button. The uninstallation is successfully done.

![Roofscope23](https://mintcdn.com/zuperinc/osz7CqocwrZuWB17/images/Roofscope23.png?fit=max\&auto=format\&n=osz7CqocwrZuWB17\&q=85\&s=e9d0e6c43fa9def7cb3002e470bee753)

### FAQs

> [accordion] Who can install and configure the RoofScope integration in Zuper?
>
> Only Zuper users with **Admin** privileges can install apps from the App Store. The user must also have a valid **RoofScope API Key** and **RoofScope Scope Token** to authenticate during setup.

> [accordion] How do I get the RoofScope API key?
>
> Email your request to [support@myscopetech.com](mailto:support@myscopetech.com). Once RoofScope provisions the key, add it in Zuper:
>
> **Navigation:** App Store → RoofScope → Configure Settings → RoofScope API Key

> [accordion] How do I get the RoofScope Scope Token?
>
> 1. Log in to your RoofScope account.
> 2. Open **My Details** from the top-right menu.
> 3. Copy the **Scope API Token**.
> 4. Paste it in Zuper under **App Store → RoofScope → Configure Settings → RoofScope Scope Token**.

> [accordion] What is the validity of the RoofScope Scope Token?
>
> The RoofScope Scope Token is valid for **one year**. After it expires, syncing and ordering measurements will fail until you update the token in Zuper.
>
> **Navigation:** App Store → RoofScope → Configure Settings → Update

> [accordion] Do I need a Zuper API key for this integration? How do I generate one?
>
> Yes. A Zuper API key is required to complete the RoofScope integration setup.
>
> 1. Navigate to **Settings → Developer Hub → API Keys**.
> 2. Generate or copy your API key.
> 3. Paste it into the RoofScope configuration screen in the Zuper App Store.
>
> For more details, see [API Keys](https://docs.zuper.co/Settings/Developer_Hub/API_Keys.md).

> [accordion] Which Zuper plans support the RoofScope integration?
>
> The RoofScope integration is available on **Core** and **Premium** Zuper plans.

> [accordion] Which RoofScope plans are required to use RoofScope measurements inside Zuper?
>
> You need an active **Growth**, **Advantage**, or **Scale** plan in RoofScope to enable measurements in Zuper.

> [accordion] Can I link multiple RoofScope orders to a single Zuper job?
>
> Yes, you can link multiple RoofScope measurement projects to a single Zuper job.

> [accordion] Why don't I see my existing RoofScope project when searching?
>
> Ensure the following:
>
> * The service address in Zuper matches the address in RoofScope exactly, including unit or apt number.
> * You are logged into RoofScope with an account that has access to that project.

> [accordion] Are edits made in Zuper synced back to RoofScope?
>
> No. Edits made in Zuper are local only and do not update the original RoofScope project.

> [accordion] What if a measurement stays 'In Progress' for too long?
>
> Reach out to **RoofScope Support** directly to follow up on the order status.

> [accordion] Can Field Executives order measurements, or only admins?
>
> Admins and users with **custom role access** can order measurements. See [Custom Roles](#custom-roles) for steps to enable the required permission.

> [accordion] Will removing a measurement in Zuper remove it in RoofScope?
>
> No. Removing a measurement in Zuper only unlinks it from the job. The project remains intact in RoofScope and can be re-linked later if needed.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.