Skip to main content

Filevine Integration Setup

Use this article to connect Filevine to Hona for the first time, or to reconnect after a PAT (Personal Access Token) expiration. If Filevine is connected but not syncing, see Integrations: What is Syncing? instead.

s

What this article helps with: Connecting Filevine to Hona for the first time, and reconnecting after a PAT (Personal Access Token) expiration. If your integration was working but recently stopped syncing, the most likely cause is an expired PAT — follow the reconnection steps at the bottom of this article.

Who this is for: Firm admins with Hona admin access and Filevine Account Admin access.

When not to use this article: If Filevine is already connected but data is not syncing correctly, see Integrations: What is Syncing? and the Filevine Data Mapping Guide.


Overview / Pre-Requisites

  • This guide walks you through setting up the initial integration between Filevine and Hona, including creating a service account and Personal Access Token (PAT).

  • Please ensure that you have admin access to Hona as well as Account Admin access in Filevine.


Before Starting — Confirm Access

  • Hona: Admin Level Login

  • FV: Advanced > Service Accounts

  • FV: Access Tokens (profile menu > Manage My Account > Access Tokens)

Step 1: Activate the Hona Integration in Filevine

  1. Select the 3 lines at the top left → Select "Advanced"

  2. Navigate to "Integrations" on the left menu

  3. Find the Hona integration and click "Activate"

Step 2: Create a Service Account and PAT

The service account is the "user" that Hona activity gets logged under in Filevine.

  1. Go to Advanced > Service Accounts → Press "+ New"

    • Service Account Type: Hona

    • Permissions: All Permissions

    • Press "Create"

  2. To create the token, open Access Tokens from your profile menu (Manage My Account > Access Tokens) and click + New. Name it Hona, set User to the Hona service account, and select every scope except Payments API Access, including Filevine API Access, Vitals API Access, Bulk Data API Access and Webhook API Access. The scope list scrolls, so check for more below.

    • Click Create, then copy the PAT secret and save it before you close the window. You cannot see it again, and if you lose it you will need to create a new token.

  3. Click the new token, select Extend Expiration, and confirm to set the maximum duration, about 1 year.

PAT Expiration — Set a Yearly Reminder

PAT expiration is the most common cause of Filevine sync stopping unexpectedly. New tokens default to a 3-month expiration — you must extend to the maximum immediately after creating.

  • Set a calendar reminder to renew the PAT at least 2 weeks before its expiration date

  • If the PAT expires: sync stops entirely, no data pulls into Hona until a new PAT is entered

  • Symptoms of expired PAT: integration stops syncing, all records stop updating, integration may appear disconnected

Step 3: Connect Filevine to Hona

You will need three things: your Personal Access Token (from Step 2), your Filevine region and your subdomain. Your subdomain is the part of your Filevine address before .filevineapp.com. If you log in at yourfirm.filevineapp.com, your subdomain is yourfirm.

  • If you are not sure what your subdomain is, contact [email protected] and we can confirm it with you.

  1. In Hona, go to Company Settings > Integrations and click Connect on the Filevine tile. Choose your region (United States or Canada), paste your Personal Access Token, enter your subdomain, and click Save.

  2. Email your Account Manager to confirm configuration so they can finalize the connection. No Account Manager? Contact [email protected]

Reconnecting After PAT Expiry

If your Filevine sync has stopped due to an expired PAT, generate a new PAT in Filevine (same steps as Step 2 above) and re-enter it in Hona:

  1. In Filevine: open Access Tokens from your profile menu (Manage My Account > Access Tokens) and create a new token for the Hona service account, with the same scopes as Step 2. Save the PAT secret and extend its expiration right away.

  2. In Hona: go to Company Settings > Integrations and click Update Connection on the Filevine tile. Paste the new Personal Access Token, check that the region and subdomain are still correct, and click Save.

  3. Run a manual sync on one project to confirm data is flowing again

If sync does not resume after entering a new PAT, contact [email protected].

Did this answer your question?