Help & Setup Guide
Everything you need to install Sheets to BM, connect your Blackbaud account, and start pushing charges — all from Google Sheets.
Quick Start
Get up and running in three simple steps.
Install the Add-on
Find Sheets to BM in the Google Workspace Marketplace and install it to your Google Sheets.
Connect Blackbaud
Authorize your Blackbaud account via OAuth directly from the sidebar.
Push Charges
Select rows and click 'Send Charges' — data flows to Blackbaud instantly.
On This Page
Installation
Sheets to BM is available on the Google Workspace Marketplace. Installation takes less than a minute and requires no technical setup.
- Open Google Sheets and go to Extensions → Add-ons → Get add-ons.
- Search for "Sheets to BM for Blackbaud" in the Marketplace.
- Click Install and grant the required permissions.
- Once installed, open the add-on from Extensions → Sheets to BM.
Find Sheets to BM in the Google Workspace Marketplace
Click 'Connect Blackbaud' in the sidebar
Connect Blackbaud
Your Blackbaud connection is secured with OAuth 2.0. No passwords are stored in the add-on — tokens are encrypted and refreshed automatically.
- Open the Sheets to BM sidebar and click "Connect Blackbaud".
- A new tab opens with the Blackbaud consent screen — approve the requested scopes.
- You'll be redirected back to Sheets with a green checkmark confirming the connection.
Sync Charges
Sending data to Blackbaud is a three-click process: select your rows, click send, and review the log.
- Select the rows containing charge data in your spreadsheet.
- Click "Send Charges" in the Sheets to BM sidebar.
- The add-on validates each row, posts to the Blackbaud SKY API, and writes results to the sync log sheet.
Successful records appear with a ✓ in the log. Any validation errors or API rejections are flagged with a clear error message so you can fix and re-send.
Select the rows you want to send to Blackbaud
Click 'Import Sample Data' to pre-fill template columns
Templates & Validation
Not sure how to structure your charge data? The built-in template shows you the exact columns Blackbaud expects, pre-filled with sample data.
- Click "Import Sample Data" in the sidebar to generate a template sheet.
- All required fields (student ID, amount, description, date, etc.) are pre-filled.
- The add-on validates your data before sending — missing or malformed fields are highlighted.
Sync Logs & Audit Trail
Every sync creates a timestamped entry in a dedicated log sheet within your spreadsheet. This gives you a complete audit trail without any extra setup.
- Timestamp — when the sync was triggered
- Row reference — which rows were included
- Status — success or failure per record
- API response — Blackbaud's response for troubleshooting
Logs are append-only — previous entries are never overwritten, so your audit history is always intact.
Every sync creates a timestamped log entry