---
title: Hover API Integration on Truto
slug: hover
category: CRM
canonical: "https://truto.one/integrations/detail/hover/"
---

# Hover API Integration on Truto



**Category:** CRM  
**Status:** Beta

## MCP-ready AI tools

Truto exposes 72 tools for Hover that AI agents can call directly.

- **get_single_hover_agreement_by_id** — Get Agreement Details. Returns an agreement's details, including its PDF link and production lists. Required: id.
- **create_a_hover_blueprint** — Blueprint Upload - Build All. Use this endpoint to upload a blueprint and reconstruct all elevations on the blueprint as their own Jobs. Covers both of Hover's blueprint uploads: workflow `build_all` (Hover builds every structure it finds) or `specify_details` (send job_attributes.name[] and job_attributes.deliverable_id[] per elevation). Through the connector, reference the blueprint files (PDF, DWG, DXF) by URL in job.file_attachments_attributes[].url; uploading local files (job[files][]) isn't supported here. Needs the blueprints feature on the Hover org. Hover's access tokens belong to the organization, so this call names the acting user with current_user_id or current_user_email (an admin user's id from users.list). Required: current_user_id, job.name, job.deliverable_id, job.file_attachments_attributes, job.file_attachments_attributes[].url, workflow.
- **get_single_hover_capture_request_link_by_id** — Get Capture Request Link. Get the raw HTML page for a Capture Request using this endpoint. The id is the capture request's identifier (e.g. xpod232), not its numeric id. Hover answers with a small HTML page that redirects to the capture link. Required: id. Returns the file (text/html), not JSON.
- **list_all_hover_capture_requests** — List Capture Requests. Use this endpoint to list all capture requests for your organization, given a user ID. States: new, connected, complete, deleted. Hover's access tokens belong to the organization, so this call names the acting user with current_user_id or current_user_email (an admin user's id from users.list). Required: current_user_id.
- **get_single_hover_capture_request_by_id** — Show Capture Request Details. This endpoint takes in a numeric capture request ID and returns its details. The id is the numeric capture request id. Required: id.
- **create_a_hover_capture_request** — Create a Capture Request. This endpoint initiates a Hover property capture by creating a draft job in your authenticated organization and sending an invitation (via email/SMS) to a designated user to perform the capture. Hover's access tokens belong to the organization, so this call names the acting user with current_user_id or current_user_email (an admin user's id from users.list). Required: capture_request.capturing_user_email, capture_request.capturing_user_name, capture_request.job_attributes.location_line_1.
- **delete_a_hover_capture_request_by_id** — Delete Capture Request. Delete an existing Capture Request using this endpoint. Required: id.
- **hover_capture_requests_resend** — Resend Capture Request Notifications. Resend a Capture Request notification using this endpoint. Required: capture_request_id.
- **hover_capture_requests_lookup** — Check for Existing Capture Request. Check if there is an existing Capture Request for an email using this endpoint. Required: email.
- **list_all_hover_deliverable_change_requests** — List Deliverable Change Requests. Retrieve a list of all deliverable change requests for a specific Model. Hover's access tokens belong to the organization, so this call names the acting user with current_user_id or current_user_email (an admin user's id from users.list). Required: current_user_id, model_id.
- **create_a_hover_deliverable_change_request** — Create Deliverable Change Request. Create a request to upgrade and pay for a Model to have an upgraded deliverable. Upgrades a model's deliverable: Capture Only (7) to Roof Only (2) or Complete (3), Roof Only (2) to Complete (3). Hover's access tokens belong to the organization, so this call names the acting user with current_user_id or current_user_email (an admin user's id from users.list). Required: new_deliverable_id, current_user_id, model_id.
- **hover_deliverable_change_requests_cancel** — Delete Pending Change Order Request. Endpoint to delete a pending deliverable change request. Hover's access tokens belong to the organization, so this call names the acting user with current_user_id or current_user_email (an admin user's id from users.list). Required: current_user_id, model_id.
- **get_single_hover_deliverable_upgrade_price_by_id** — Get Upgrade Price. Retrieve pricing information for upgrading an existing deliverable for a model. Hover's access tokens belong to the organization, so this call names the acting user with current_user_id or current_user_email (an admin user's id from users.list). Required: id, new_deliverable_id, current_user_id.
- **list_all_hover_deliverables** — List Available Deliverables. Use this endpoint to retrieve a list of available deliverables for an input Wallet ID. Required: wallet_id.
- **create_a_hover_estimate_order_document** — Create Order Documents PDF or CSV. Creates a new order document for an Estimate. Required: project_management_production_list_id.
- **get_single_hover_estimate_order_document_by_id** — Show Order Documents PDF or CSV. Poll the status and get back the order documents. Poll until state is complete, then download pdfLink / csvLink. Required: id, project_management_production_list_id.
- **list_all_hover_estimates** — List Estimates. List Estimates on a Job by Job ID. Required: job_id.
- **get_single_hover_estimate_by_id** — Show Estimate Details. Get the details of a specific estimate given its ID. Required: id.
- **list_all_hover_esx_exports** — Get ESX Export. The endpoint returns ESX file with the filename, {job_id}_{model_id}.esx. Required: model_id. Returns the file (application/octet-stream (Xactimate ESX)), not JSON.
- **list_all_hover_floor_plan_wireframes** — Get Wireframe Images. Returns a model's floor plan wireframe image (wireframe_floor_plan.png). For Interior (8) models. Required: model_id. Returns the file (image/png), not JSON.
- **list_all_hover_fml_exports** — Get FML Export. This endpoint returns the FML file for Interior models only. The Hover web application refers to this file as XML 2.0 when manually exporting. However, these point to the exact same file export as this endpoint. Required: model_id. Returns the file (FML (Floorplanner JSON)), not JSON.
- **get_single_hover_inspection_pdf_by_id** — Get Inspection PDF. Use this endpoint to retrieve an Inspection’s data in PDF format. Required: id. Returns the file (application/pdf), not JSON.
- **list_all_hover_inspection_photos** — Get Inspection Photos. Returns an inspection's photos (file name, sort order and image URLs). Required: inspection_id.
- **create_a_hover_inspection_workflow_share** — Share Inspection Workflow. Use this endpoint to share an Inspection Workflow with an organization. Hover's access tokens belong to the organization, so this call names the acting user with current_user_id or current_user_email (an admin user's id from users.list). Required: current_user_email, recipient_org_id, inspection_workflow_id.
- **get_single_hover_inspection_workflow_by_id** — Get Inspection Workflow Details. Use this endpoint to return specific Inspection workflow details when passing in an inspection workflow ID. Required: id.
- **list_all_hover_inspections** — List Inspections. Use this endpoint to return Inspections for a given Job. Required: job_id.
- **get_single_hover_inspection_by_id** — Get Inspection Details. Use this endpoint to return detailed Inspection information such as questions, answers, photos, and tags for a given inspection ID. Required: id.
- **list_all_hover_instant_design_images** — List Instant Design Images. Returns Instant Design images for a job or a lead: send job_id or lead_id.
- **get_single_hover_instant_design_image_by_id** — Show Instant Design Image. Use this endpoint to return the Instant Design image of the input image ID. Required: id, job_id.
- **list_all_hover_instant_design_leads** — List Instant Design Leads. Use this endpoint to list all lead information submitted through the Instant Design lead form associated with the authenticated organization. Required: org_id. The connector pages through all results (25 per page, or your limit).
- **get_single_hover_instant_design_lead_by_id** — Show Instant Design Lead Details. Use this endpoint to retrieve detailed information for a single Instant Design lead given the lead ID. Required: id.
- **list_all_hover_job_shares** — List Job Share Links. Use this endpoint to list all Job Shares across all jobs that the input user has access to. Hover's access tokens belong to the organization, so this call names the acting user with current_user_id or current_user_email (an admin user's id from users.list). Required: current_user_id. The connector pages through all results.
- **get_single_hover_job_share_by_id** — Show Job Share Link. Use this endpoint to return the information and links for an input Job Share ID. Hover's access tokens belong to the organization, so this call names the acting user with current_user_id or current_user_email (an admin user's id from users.list). Required: id, current_user_id.
- **create_a_hover_job_share** — Create Job Share Link with Password. Use this endpoint to create a shareable link for a Virtual Walkthrough on a job that can be password protected. Required: job_id, viewer_version.
- **update_a_hover_job_share_by_id** — Update Job Share Link. Use this endpoint to update a Job Share link. Hover's access tokens belong to the organization, so this call names the acting user with current_user_id or current_user_email (an admin user's id from users.list). Required: id, current_user_id.
- **delete_a_hover_job_share_by_id** — Delete Job Share Link. Use this endpoint to delete a specific Job Share link. Hover's access tokens belong to the organization, so this call names the acting user with current_user_id or current_user_email (an admin user's id from users.list). Required: id, current_user_id.
- **list_all_hover_jobs** — List Jobs. This endpoint provides information on the jobs in the authenticated organization. Filter with search (3+ characters: job name, address or user), archived, example, updated_since (epoch seconds), deliverable_ids and reconstruction_states (arrays); sort with sort_by / sort_order. The connector pages through all results (25 per page, or your limit, max 100).
- **get_single_hover_job_by_id** — Show Job Details. Returns everything about one job: address, customer, capture session and its models. Includes each model (structure) with its state, deliverable, artifact links (measurements, CAD exports) and images; check a model's state is complete before fetching its artifacts. Required: id.
- **create_a_hover_job** — Create a Job. Creates a job in your organization that is ready for photo capture in the Hover app. Hover recommends capture requests (capture_requests.create) over creating jobs directly. Hover's access tokens belong to the organization, so this call names the acting user with current_user_id or current_user_email (an admin user's id from users.list). Sent as multipart/form-data (job[name], job[location_line_1] ...), as Hover documents it.
- **update_a_hover_job_by_id** — Update a Job. Use this endpoint to update the details of a Job’s property or owner. Send only the job fields to change. Hover's access tokens belong to the organization, so this call names the acting user with current_user_id or current_user_email (an admin user's id from users.list). Required: id.
- **hover_jobs_archive** — Archive Job Access. Archives the job access: the job no longer shows in the users' property lists. List Jobs with archived=true still returns it, and Hover can unarchive it later. Required: job_id.
- **hover_jobs_assign** — Re-Assign Requesting User. Use this endpoint to re-assign the requesting user of a Job to a different user. Hover's access tokens belong to the organization, so this call names the acting user with current_user_id or current_user_email (an admin user's id from users.list). Required: user_id, job_id.
- **list_all_hover_measurements_json** — Get JSON Measurements. This endpoint returns detailed measurement data for a given model_id in JavaScript Object Notation (JSON) format. This is the primary method for pulling structured measurement data directly into your external systems for further analysis, estimation, material ordering, etc. version: summarized_json, full_json, sketch_json or paint_measurements. Required: version, model_id.
- **list_all_hover_measurements_pdfs** — Get Measurements PDF. The Measurements PDF provides a detailed, printable report of a property's measurements. This endpoint facilitates retrieving that report for a designated model. Required: model_id. Returns the file (application/pdf), not JSON.
- **list_all_hover_measurements_xlsx** — GET XLSX Measurements. This endpoint allows your integration to retrieve measurement data for a given model_id in Microsoft Excel (XLSX) format. It is designed for businesses that require measurement data in a spreadsheet format consumable by Microsoft Excel and other compatible programs. Required: model_id. Returns the file (application/vnd.openxmlformats-officedocument.spreadsheetml.sheet), not JSON.
- **create_a_hover_multi_structure_test_job** — Multi-Structure Test Jobs. This endpoint allows a mocked multi-structure test job to be created for development testing; this endpoint does not fire expected webhooks. Development only: creates a mocked multi-structure test job (no webhooks), free of charge. Hover's access tokens belong to the organization, so this call names the acting user with current_user_id or current_user_email (an admin user's id from users.list). Required: job_preset, state.
- **list_all_hover_notes** — List Notes. List all notes associated with a Job. Required: job_id.
- **create_a_hover_note** — Create Note. Use this endpoint to create a note for a given Job ID in Hover. Hover's access tokens belong to the organization, so this call names the acting user with current_user_id or current_user_email (an admin user's id from users.list). Required: current_user_email.
- **update_a_hover_note_by_id** — Update Note. Use this endpoint to update a note on a Job in Hover. Hover's access tokens belong to the organization, so this call names the acting user with current_user_id or current_user_email (an admin user's id from users.list). Required: id, current_user_email.
- **delete_a_hover_note_by_id** — Delete Note. This endpoint deletes a note based on the required note_id path parameter. This is an irrevocable action and cannot be reverted. Required: id.
- **list_all_hover_organization_details** — Show Organization Details. This endpoint returns data associated with the organization where an integration is currently authenticated. Returns the organization the connection is authorized for.
- **list_all_hover_organizations** — List Organization Tree. Use this endpoint to return the current authenticated Organization and children.
- **update_a_hover_organization_by_id** — Update Organization. Use this endpoint to update data associated with the authenticated organization. Required: id.
- **list_all_hover_payment_receipt_pages** — Get Payment Receipt (HTML). Use this endpoint to retrieve an HTML version of an invoice for a given payment ID. Hover's access tokens belong to the organization, so this call names the acting user with current_user_id or current_user_email (an admin user's id from users.list). Required: current_user_id, payment_id. Returns the file (text/html), not JSON.
- **list_all_hover_payment_receipt_pdfs** — Get Payment Receipt (PDF). Use this endpoint to retrieve a PDF version of an invoice for a given payment ID. Hover's access tokens belong to the organization, so this call names the acting user with current_user_id or current_user_email (an admin user's id from users.list). Required: current_user_id, payment_id. Returns the file (application/pdf), not JSON.
- **list_all_hover_payments** — List Payments. Use this endpoint to retrieve a list of payment data for all Jobs. For one job's payments pass good_type=Job and good_id=<job id> (Hover's "Get Job's Payment Details"); month and year filter by paid_at together. Hover's access tokens belong to the organization, so this call names the acting user with current_user_id or current_user_email (an admin user's id from users.list). The connector pages through all results.
- **list_all_hover_roof_waste_factors** — Get Roof RWF. This endpoint uses Hover’s algorithm recommendation to return a roof waste percentage for input measurements. Inputs come from a model's JSON measurements (step_flashing, valleys, ridges_hips, rakes, roof_facets.area). Hover's reference serves it from ehi.hover.to. Required: roof_square_feet, step_flashing_linear_feet, rakes_linear_feet, valleys_linear_feet, hips_linear_feet.
- **list_all_hover_roof_wireframes** — Get Wireframe Images. Returns a model's roof wireframe image (wireframe_roof.png). For Roof Only (2) and Complete (3) models; version url (default), top, lengths, areas or pitches. Required: model_id. Returns the file (image/png), not JSON.
- **create_a_hover_single_structure_test_job** — Single Structure Test Jobs. This endpoint allows a mocked single-structure test job to be created for development testing; this endpoint does fire realistic webhooks. Development only: moves a job in the uploading / processing_upload state to complete (sample data, realistic webhooks) or failed, free of charge. Hover's access tokens belong to the organization, so this call names the acting user with current_user_id or current_user_email (an admin user's id from users.list). Required: state, current_user_id, job_id.
- **list_all_hover_skp_exports** — Get SKP Export. This endpoint allows your integration to download the Hover 3D model in SketchUp's proprietary .skp file format. It is ideal if your workflow involves directly editing the 3D model in SketchUp or utilizing it for applications such as 3D printing. Required: model_id. Returns the file (application/octet-stream (SketchUp)), not JSON.
- **hover_user_invitations_send** — Send Invitation Email. Use this endpoint to send an email invitation to a designated user after inviting them. Hover's access tokens belong to the organization, so this call names the acting user with current_user_id or current_user_email (an admin user's id from users.list). Required: current_user_id, org_id, user_id.
- **list_all_hover_user_profiles** — Show User Profile. This endpoint returns the profile of the user of the ID whose value is passed in as the required current_user_id query parameter. Hover's access tokens belong to the organization, so this call names the acting user with current_user_id or current_user_email (an admin user's id from users.list). Required: current_user_id.
- **list_all_hover_users** — List Users. Use this endpoint to retrieve a list of all users within the authenticated organization. The connector pages through all results (25 per page, or your limit).
- **create_a_hover_user** — Invite User. Use this endpoint to programmatically invite a user to your Hover organization. Required: org_id, user.email.
- **hover_users_archive** — Remove User From Org. Use this endpoint to remove a user from your Hover organization. Removes the user from the organization (Hover archives the membership). Hover's access tokens belong to the organization, so this call names the acting user with current_user_id or current_user_email (an admin user's id from users.list). Required: org_id, user_id, current_user_id.
- **list_all_hover_wallets** — List Wallets. Use this endpoint to retrieve a list of all wallets accessible to the current authenticated Hover organization. Hover's access tokens belong to the organization, so this call names the acting user with current_user_id or current_user_email (an admin user's id from users.list). Required: current_user_id. The connector pages through all results (25 per page, or your limit).
- **list_all_hover_webhooks** — List Webhooks. This endpoint lists all webhooks associated with the authenticated organization. The connector pages through all results.
- **create_a_hover_webhook** — Register Webhook. This endpoint registers a webhook to be used within an integration. Registering a webhook must happen before verifying a webhook. Required: webhook.url.
- **hover_webhooks_verify** — Verify Webhook. This endpoint verifies a previously registered webhook, when given a verification code, and allows events to begin being sent. Pass the verification code Hover posted to the webhook URL as webhook_verification_code. Required: webhook_verification_code.
- **hover_webhooks_resend** — Resend Webhook Verification Code. This endpoint will resend a verification code for a registered webhook. Required: webhook_id.
- **delete_a_hover_webhook_by_id** — Delete Webhook. Use this endpoint to remove a webhook from the authenticated account, and stop having events sent to it. Required: id.
- **list_all_hover_xml_exports** — Get XML 3D Export. This endpoint allows you to retrieve the three-dimensional measurement data of your captured structure in XML format. The XML 3D Export provides standardized diagramming functionality, which can be leveraged as a seamless input for 2D or 3D modeling within various external business systems. version=v2 returns the v2 XML. Required: model_id. Returns the file (application/xml), not JSON.

## How it works

1. **Link your customer's Hover account.** Use Truto's frontend SDK; we handle every OAuth and API key flow so you don't need to create the OAuth app.
2. **Authentication is automatic.** Truto refreshes tokens, stores credentials securely, and injects them into every API request.
3. **Call Truto's API to reach Hover.** The Proxy API is a 1-to-1 mapping of the Hover API.
4. **Get a unified response format.** Every response uses a single shape, with cursor-based pagination and data in the `result` field.

## Use cases

- **Embed Hover capture requests inside your contractor CRM** — Let your users dispatch Hover photo capture invitations to field reps or homeowners without leaving your app. This eliminates dual data entry and ties every resulting 3D model back to the correct job record in your CRM.
- **Auto-generate estimates from Hover measurements** — Pull Hover's structured JSON measurements and roof waste factors into your quoting tool to instantly calculate accurate material quantities and pricing. Your users close deals faster with zero manual takeoffs.
- **Sync Hover deliverables into project documents** — Automatically ingest Hover's measurement PDFs, inspection reports, and 3D visualizer share links into your platform's document system via webhooks. Production teams always have the latest property data without hunting across tools.
- **Power insurance claim workflows with Hover exports** — Enable insurance SaaS platforms to pull Hover's ESX, XML, and inspection PDF exports directly into claims files. Adjusters get standardized, measurement-backed documentation ready for Xactimate without manual file transfers.
- **Offer homeowner-facing 3D proposals** — Generate Hover job share links from inside your proposal or sales tool so homeowners can walk through their own property in 3D before signing. Boosts close rates for your roofing and exterior remodeling customers.

## What you can build

- **One-click capture request dispatch** — Trigger Hover capture requests from any lead or job record in your app, with built-in resend and lookup support.
- **Blueprint-to-3D model pipeline** — Let users upload PDF, DWG, or DXF blueprints through your UI and create Hover blueprints programmatically to generate 3D models without site photos.
- **Instant estimate automation** — Fetch Hover's full JSON measurements and roof waste factors on job completion to auto-populate your estimator with roof squares, linear feet, and material counts.
- **Embedded 3D virtual walkthroughs** — Create and manage Hover job shares from your proposal flow, generating password-protected 3D walkthrough links that embed directly into customer-facing quotes.
- **Webhook-driven job state sync** — Subscribe to Hover webhooks to react in real time when jobs, models, or deliverables change state, triggering downstream automations in your platform.
- **Multi-format export library** — Give users one-click access to Hover's ESX, FML, SKP, XML, floor plan wireframes, inspection PDFs, and measurement spreadsheets from inside your product.

## FAQs

### How does authentication work for Hover integrations through Truto?

Truto handles the full Hover OAuth and token lifecycle for you. Your end users connect their own Hover accounts through a Truto-managed flow, and you call Hover endpoints without storing credentials or managing refresh logic.

### Can I keep data fresh in real time without polling?

Yes. Hover supports webhooks, and Truto exposes create, verify, resend, and delete operations for Hover webhooks so you can subscribe to job and model state changes and react as soon as deliverables are ready.

### What measurement formats can I pull from Hover?

You can list Hover measurements as JSON (summarized or full), branded PDF reports, and XLSX spreadsheets. For specialized workflows, Truto also exposes ESX, FML, SKP, XML, floor plan wireframes, and roof wireframe exports.

### Can my users request Hover captures without taking photos themselves?

Yes. You can create a Hover capture request that sends an SMS or email link to a field rep or homeowner, or create a Hover blueprint from an uploaded architectural file to skip photo capture entirely.

### Does the integration support managing users and organizations in Hover?

Yes. The available tools cover listing users and organizations, creating users, sending invitations, archiving users, updating organizations, and reading user profiles and wallets.

### How do I handle deliverable upgrades like unlocking full measurements?

Truto exposes endpoints to list and create deliverable change requests, check upgrade pricing, and cancel pending requests, so you can programmatically upgrade jobs when a deal advances or a user approves the cost.

### What if I need a Hover endpoint that isn't listed?

Truto can add Hover endpoints on request. Reach out and new tools can typically be scoped and shipped quickly so you aren't blocked by coverage gaps.

## Related reading

- [Connect Hover to Claude: Sync 3D CAD Exports and Blueprint Jobs](https://truto.one/blog/connect-hover-to-claude-sync-3d-cad-exports-and-blueprint-jobs/) — Learn how to connect Hover to Claude using a managed MCP server. Automate 3D property models, blueprint uploads, and CAD exports with AI agent tool calling.
- [Connect Hover to ChatGPT: Manage Property Captures and Measurements](https://truto.one/blog/connect-hover-to-chatgpt-manage-property-captures-and-measurements/) — Learn how to connect Hover to ChatGPT using a managed MCP server. This guide covers integration architecture, tool calling, and automated measurement workflows.
- [Connect Hover to AI Agents: Automate Estimates and Inspections](https://truto.one/blog/connect-hover-to-ai-agents-automate-estimates-and-inspections/) — Learn how to connect Hover to ai agents using Truto. Step-by-step guide to tool calling, API quirks, and autonomous workflows.
