Home About Us Products Knowledge Base News Contact
Essential Setup — Takes 2 Minutes

The Complete API Key Guide

How to get a free Gemini API key from Google AI Studio, connect it to any ZackFlow product, test the connection, and manage your key securely. One key works across all products.

🔑 What Is the API Key?

The Gemini API key is a unique identifier that allows ZackFlow to communicate with Google's Gemini AI model. Think of it as a password that grants your dashboard access to the AI engine. Without it, the "Generate" button has nothing to call.

The key is free to obtain from Google. You do not need to pay Google anything to get a key. The free tier is generous enough for individual and small team usage. You only need a Google account.

Key URL: https://aistudio.google.com

Cost: Free to generate. Free tier: 60 requests per minute.

Requirement: A Google account (Gmail or Google Workspace).

📋 Step-by-Step: Get Your Free Gemini API Key

1

Go to Google AI Studio

Open your browser and navigate to https://aistudio.google.com. This is Google's official platform for working with Gemini models and generating API keys. It is maintained directly by Google.

2

Sign In with Your Google Account

Click the sign-in button and log in with your Gmail or Google Workspace account. If you don't have one, you'll need to create one — it's free and takes about 2 minutes. Most people already have a Google account.

3

Click "Get API Key"

Once signed in, look for the "Get API Key" button (usually in the left sidebar or on the main dashboard). Click it. If you don't have an API key yet, Google will prompt you to create one.

4

Create the API Key

Google will generate a new API key for you. It will look something like a long string of letters and numbers: AIzaSyA...example_key_string. Click the "Copy" button to copy it to your clipboard. Keep this key handy — you'll need it in the next step.

5

Store It Securely

Save the key somewhere safe (a password manager is ideal). While you'll paste it into ZackFlow right away, it's good practice to keep a backup. If you ever need to reconnect (e.g., after clearing the key), having it saved means you don't need to go back to AI Studio.

🔗 Connecting Your Key to Any ZackFlow Product

The connection process is the same for every ZackFlow product. Here's how it works:

1

Open Your Copied Dashboard

Open the Google Sheet you copied from the ZackFlow template. If this is your first time opening it (and no API key is stored), the setup wizard dialog will appear automatically.

2

Paste the API Key

In the setup wizard dialog, you'll see an input field labeled "API Key" or "Gemini API Key." Paste your key from the clipboard (Ctrl+V or Cmd+V). Double-check that the entire key is pasted — it should start with AIzaSy and be approximately 40 characters long.

3

Click "Connect" or "Save"

Click the confirmation button. The Apps Script will save your key into PropertiesService (Google's encrypted key-value store) and close the dialog. The custom ZackFlow menu will now appear in your sheet's toolbar.

4

You're Connected

That's it. Your dashboard now has access to the Gemini AI. You can proceed to fill in your business inputs and click "Generate." The key is stored securely and will persist across sessions — you only need to do this once per sheet.

✅ Testing the Connection

After connecting your API key, it's a good idea to verify the connection works before generating your full strategy:

Quick Test Method

Open the input/setup tab in your dashboard and fill in minimal test data (any niche, any goal). Click the "Generate" button. If the generation completes successfully in about 30-45 seconds and produces content in the output tabs, your API key is working correctly.

What Success Looks Like

A completion dialog appears saying "Strategy generated!" or similar. The output tabs are populated with AI-generated content (content calendars, strategies, hashtags, etc.). The sheet may take a moment to render all the formatted cells.

What Failure Looks Like

If the API key is invalid, expired, or incorrectly pasted, you'll see an error message like "API key invalid" or "API request failed." In this case, go back to Google AI Studio, verify your key is active, and re-paste it into the setup wizard using the "Clear API Key" option first.

🔒 Security: How Your Key Is Protected

ZackFlow uses Google's built-in security infrastructure to protect your API key. Here's how it works:

PropertiesService Storage

Your key is stored using Google Apps Script's PropertiesService. This is Google's official key-value storage system for Apps Script. Data stored here is encrypted at rest by Google's infrastructure.

Never Visible in Cells

Your API key is never written into sheet cells, formulas, or any visible location in the spreadsheet. It is only stored in the script's property store, which is not accessible by viewing the sheet.

Script-Only Access

Only the Apps Script code within your specific sheet can access the stored key. No other Google Sheet, no other script, and no external service can read your key from PropertiesService.

Clear Before Sharing

If you want to share your dashboard with collaborators, use the ZackFlow > Clear API Key menu option first. This removes your key so others cannot use your API quota. They can add their own key later.

📊 Free Tier Limits & Upgrading

Google's Gemini API free tier is generous. Here's what you need to know:

Metric Free Tier
Requests per minute 60 RPM
Requests per day 1,500 RPD
Cost Free
Generations per strategy 1 API call
Practical limit Virtually unlimited for personal use

For context: a single ZackFlow strategy generation uses one API call. At 60 requests per minute, you could generate 60 different strategies per minute on the free tier. For personal or small team usage, the free tier is effectively unlimited.

If you need higher limits: Google offers paid tiers with increased rate limits. Visit the Google AI Studio dashboard and check the "Pricing" or "Upgrade" section. Most users never need to upgrade — the free tier handles everything they throw at it.

🌐 One Key Works Across All ZackFlow Products

You do not need a separate API key for each ZackFlow product. The same Gemini API key works with:

  • Social Growth Dashboard — Content strategy for LinkedIn, Instagram, YouTube, Facebook, and X/Twitter.
  • Brand Building Dashboard — Brand identity, messaging, positioning, and visual direction.
  • Cold Email AI Architect — Campaign setup, lead scoring, CRM integration, and email sequences.
  • Any future ZackFlow product — All products use the same Gemini API, so the same key works everywhere.

Note: You still need to paste the key into each product's sheet separately (since each sheet has its own PropertiesService). But it's the same key — you don't need to generate multiple keys.