CRM · Beta
Hover
API integration
Ship CRM features without building the integration. Full Hover API access via Proxy and 70+ MCP-ready tools for AI agents — extend models and mappings to fit your product.
Built for specific customer use cases. Issues are resolved quickly.
Talk to usUse Cases
Why integrate with Hover
Common scenarios for SaaS companies building Hover integrations for their customers.
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
Ship these features with Truto + Hover
Concrete product features your team can ship faster by leveraging Truto’s Hover integration instead of building from scratch.
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.
SuperAI
Hover AI agent tools
Comprehensive AI agent toolset with fine-grained control. Integrates with MCP clients like Cursor and Claude, or frameworks like LangChain.
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=
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.
Why Truto
Why use Truto’s MCP server for Hover
Other MCP servers give you a static tool list for one app. Truto gives you a managed, multi-tenant MCP infrastructure across 1150+ integrations.
Auto-generated, always up to date
Tools are dynamically generated from curated documentation — not hand-coded. As integrations evolve, tools stay current without manual maintenance.
Fine-grained access control
Scope each MCP server to read-only, write-only, specific methods, or tagged tool groups. Expose only what your AI agent needs — nothing more.
Multi-tenant by design
Each MCP server is scoped to a single connected account with its own credentials. The URL itself is the auth token — no shared secrets, no credential leaking across tenants.
Works with every MCP client
Standard JSON-RPC 2.0 protocol. Paste the URL into Claude, ChatGPT, Cursor, or any MCP-compatible agent framework — tools are discovered automatically.
Built-in auth, rate limits, and error handling
Tool calls execute through Truto’s proxy layer with automatic OAuth refresh, rate-limit handling, and normalized error responses. No raw API plumbing in your agent.
Expiring and auditable servers
Create time-limited MCP servers for contractors or automated workflows. Optional dual-auth requires both the URL and a Truto API token for high-security environments.
How It Works
From zero to integrated
Start with Hover in a free sandbox, usually ready within one business day. No boilerplate, no maintenance burden.
Link your customer’s Hover account
Use Truto’s frontend SDK to connect your customer’s Hover account. We handle all OAuth and API key flows — you don’t need to create the OAuth app.
We handle authentication
Don’t spend time refreshing access tokens or figuring out secure storage. We handle it and inject credentials into every API request.
Call our API, we call Hover
Truto’s Proxy API is a 1-to-1 mapping of the Hover API. You call us, we call Hover, and pass the response back in the same cycle.
Unified response format
Every response follows a single format across all integrations. We translate Hover’s pagination into unified cursor-based pagination. Data is always in the result attribute.
FAQs
Common questions about Hover on Truto
Authentication, rate limits, data freshness, and everything else you need to know before you integrate.
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.
From the Blog
Hover integration guides
Deep dives, architecture guides, and practical tutorials for building Hover integrations.
Hover
Get Hover integrated into your app
Our team understands what it takes to make a Hover integration successful. A short, crisp 30 minute call with folks who understand the problem.