Generate & manage API keys

API keys authenticate your requests to the Letterhead API. Two scopes are available: company-level keys (v3) for individual company operations and organization/brand-level keys (v2) for broader access. Only admins can generate and manage API keys.

Generate an API Key

1. In Settings, navigate to TODO: confirm exact Settings path for [Company / Organization] API Keys.
2. Click Generate New Key or + Add Key.
3. (Optional) Enter a descriptive name (e.g., “Zapier integration”, “AI tools”).
4. Select the scope: v2 for organization/brand-level or v3 for company-level.
5. Click Create or Generate.
6. Your key will be displayed once—copy it immediately and store it securely.

Copy an API Key

1. Go to Settings > TODO: confirm exact path.
2. Find the key you need in the list.
3. Click the Copy icon or button next to the key.
4. The key is now in your clipboard; paste it where needed.

Revoke an API Key

1. Go to Settings > TODO: confirm exact path.
2. Find the key in the list.
3. Click Revoke or the delete icon.
4. Confirm the action.
5. The key is immediately disabled and cannot be used.

Key Security Best Practices

• Treat API keys as secret—never commit them to version control or share them.
• Rotate regularly—revoke old keys and generate new ones periodically.
• Use different keys for different integrations—makes it easier to revoke one without breaking others.
• Monitor usage—check your key list periodically and revoke any you no longer use.

Next Steps

• Using the Letterhead API
• Connect AI tools to Letterhead via MCP