Skip to main content
Setting up Henry takes about five minutes. The longer part is creating the API key in your AI provider’s dashboard; the Brand Atlas side of the setup takes 30 seconds. This page covers both providers. Use the tab for whichever you prefer.

​
Before you start

You will need:
  • A Keeper or Guardian tier account on Brand Atlas (Henry is not available on Scout).
  • An account with either OpenAI or Gemini.
  • The right to create API keys in that account (usually the account owner or an admin).
If you do not yet have an account with either provider, both have free signup and small free credits to start. Pricing applies once usage exceeds the free tier.

​
Setup with OpenAI

1

Sign in to the OpenAI platform

Go to platform.openai.com and sign in.
2

Create a project (optional)

We recommend creating a dedicated project for Brand Atlas. Settings → Projects → New project. Name it Brand Atlas — [your atlas name]. A project-scoped key makes billing and usage attribution clearer.
3

Create the API key

Settings → API keys → Create new secret key. Name the key Brand Atlas Henry. Choose the project you just created.Scope the key to Restricted and grant only the Chat completions permission. The minimum permission Henry needs. Other permissions can be denied.Click Create secret key. Copy the key (it starts with sk-...). The key is shown only once; if you lose it you will need to create a new one.
4

Set a usage limit

While in the OpenAI dashboard, set a usage limit on the project. Settings → Limits → Set monthly limit. A starting limit of $50 / month is reasonable for most teams; adjust later.The limit is your protection against unexpected costs. Brand Atlas does not enforce it; the provider does.
5

Paste the key into Brand Atlas

In Brand Atlas, go to Settings → AI → Henry. Click Add API key. Choose OpenAI. Paste the key. Click Test and save.Brand Atlas tests the key against the provider. On success, Henry is enabled. On failure, an error appears explaining what went wrong (most commonly: insufficient permissions, or the key is wrong).
6

Test Henry

Click the Henry icon in the bottom-right of the portal. Ask any question about your atlas. Henry responds within a few seconds.
Henry is live. The team can ask questions from anywhere in the atlas.

​
Verifying the connection

After setup, Brand Atlas runs a periodic health check on the key. If the key stops working (revoked, exhausted budget, provider outage), the brand owner is notified within minutes. Henry stops responding to new questions until the key is restored. The status of the key is visible at Settings → AI → Henry. Green: working. Amber: warnings (low remaining budget, rate limits approaching). Red: not working.

​
Granting team-member access

Henry is available to:
  • The brand owner (always).
  • Editors (always).
  • Team Members (toggled by the brand owner).
By default, all roles have access. To restrict Henry to brand owner and editors only, toggle off Available to team members in Settings → AI → Henry. Useful in atlases where the brand owner wants to control AI exposure.

​
Rotating the key

For security, rotate the API key periodically (every 90 days is a common cadence). The mechanics are covered on Rotating and revoking.

How your key is stored

The security model.

Costs and rate limits

Understanding the bill.

Rotating and revoking

Key management hygiene.