Setting up a direct sync
Following these steps will create a live sync between your Google Sheets and Vistaly.- Step 1: Format your Sheet
- Step 2: Add the Google App Script
- Step 3: Create/Enter your API Key
- Step 4: Set the “On edit” Trigger
Step 1 (Format your Sheet)
Add the following column headers to your spreadsheet. You can rename these, but the order is important if you don’t want to modify the App Script code shared in the next step.A) Vistaly Card ID | B) Metric Name | C) Metric Value | D) Lasted Updated At | E) Last Updated By |
---|---|---|---|---|
ID of the card in Vistaly | Name of the metric | Last Value of the Metric | When the metric was last updated | Who last updated the metric |

Column D
and Column E
automatically update once a change to the metric value has been saved in Vistaly.
Column A (Vistaly Card ID)
This is the identifier that will link this row of your spreadsheet to a Vistaly card. You can only link Vistaly Cards that support numeric values (KPIs, Outcomes, Key Results, etc…) To find a Card ID, open your Vistaly workspace, select the card you want to link and copy the last part of the URL (thecardId
query parameter)
ex: app.vistaly.com/w/IGOeM6Ymm1q8bcnYsuZcb?cardId=5tx6DnTlsCRCgnWGWXjZ1

Additional Columns
You can add any additional columns you need after these 5 required columns without issue.Step 2 (Add the Google App Script)
The App Script will set up a live sync between your spreadsheet and Vistaly. SelectExtensions > App Script
and paste the App Script Code into the Editor.
Step 3 (Create/Enter your API Key)
To authenticate your Google Sheet with your Vistaly workspace, you first need to add your API Key. If you haven’t created an API Key yet, follow these steps to create one. Then add your API Key in the Google App Script Editor by selecting theSettings
page and then scrolling down to Script Properties
. Add the property as API_KEY
and the value as your secret Vistaly API Key and select Save script properties.

Step 4 (Set the “On edit” Trigger)
The last thing you need to do is tell Google how you want the App Script to run. Go to theTriggers
, page and update the for to reference your App Script.

