API Keys & Integrations
Luminal CMS connects to several external services for AI content generation, payments, email, analytics, and more. This page lists every API key the system can use, which module needs it, where to configure it in the admin, and where to obtain one.
No keys are required to run the CMS. All integrations are optional. The core CMS (pages, galleries, menus, settings) works with zero external API keys. Add keys only for the features you want to use.
AI Content Generation
The AI Resources module manages all AI providers from a single admin screen. You can add multiple providers and switch between them. Navigate to AI Tools → AI Resources in the admin menu.
Anthropic (Claude)
Powers AI Assist in the Page Manager, Agent Scheduler pipelines, and content generation. Models: Claude Opus 4.6, Sonnet 4.5, Haiku 4.5.
AI Tools → AI Resources → Add Provider → ClaudeOpenAI (GPT)
Alternative AI provider. Models: GPT-4o, GPT-4o-mini, GPT-4 Turbo, o1, o3-mini.
AI Tools → AI Resources → Add Provider → OpenAIGoogle AI (Gemini)
Google's Gemini models. Models: Gemini 2.5 Flash (recommended), Gemini 2.5 Pro, Gemini 2.0 Flash, Gemini 2.0 Flash Lite. Free tier available with generous daily quotas. See the AI Features guide for detailed Google Cloud setup instructions.
AI Tools → AI Resources → Add Provider → GoogleCustom Provider (OpenAI-Compatible)
Connect any OpenAI-compatible API endpoint. Works with Groq, Together AI, Mistral, Ollama, LM Studio, and vLLM.
AI Tools → AI Resources → Add Provider → CustomGoogle NotebookLM (Service Account)
AI-generated podcast audio from page content. Requires a Google Cloud service account with the NotebookLM API enabled. Uses JWT (RS256) authentication — not a simple API key but a JSON key file.
AI Tools → AI Resources → NotebookLM sectionPayment Processing
The Payment Providers module manages gateway credentials. Navigate to Ecommerce → Payment Methods in the admin menu.
PayPal
Accept PayPal payments in MyStore checkout. Requires Client ID and Client Secret from the PayPal Developer Dashboard. Supports both Sandbox and Live modes.
Ecommerce → Payment Methods → PayPal cardStripe
Credit/debit card processing via Stripe. Requires Publishable Key (public) and Secret Key (private). Supports test mode keys for development.
Ecommerce → Payment Methods → Stripe cardSquare
Square payment processing. Requires Application ID and Access Token from the Square Developer Dashboard.
Ecommerce → Payment Methods → Square cardEcommerce & Products
Printful
Print-on-demand merchandise integration. Syncs products from your Printful store for sale alongside MyStore products. Requires a Printful API token.
Ecommerce → Printful → SettingsAmazon Product Advertising API
Fetch Amazon product data for affiliate product cards. Requires Access Key, Secret Key, and Partner Tag from the Amazon Associates program. OPTIONAL — you can manually add affiliate products without this API.
Ecommerce → Affiliate Products → Settings tabMailgun
Transactional email delivery. Used for contact form notifications, GHL lead alerts, and system emails. Requires an API key and a verified sending domain.
System → MailgunSocial & Media
Facebook Graph API
Import events from a Facebook Page. Requires App ID, App Secret, and a long-lived Page Access Token. The token must have pages_read_engagement and pages_read_user_content permissions.
Events → Facebook Events → SettingsYouTube Data API v3
Fetch playlist metadata and video details for the YouTube Playlist Studio. Requires a Google API key with the YouTube Data API v3 enabled.
Content → YT Playlist Studio → SettingsCRM & Lead Capture
Go High Level (GHL)
Push form submissions to Go High Level CRM. Requires a GHL API key (v1 Bearer auth) and a Location ID. Per-site overrides allow different GHL locations for each domain on the same server.
Server Tools → GHL Leads → ConfigQuick Reference Table
| Service | Module | Keys Needed | Free Tier? |
|---|---|---|---|
| Anthropic Claude | AIResources | API Key | Pay-per-use |
| OpenAI | AIResources | API Key | Pay-per-use |
| Google Gemini | AIResources | API Key (AI Studio or Cloud Console) | Free tier (15 RPM, 1M tokens/day) |
| Groq | AIResources (Custom) | API Key + Base URL | Free tier available |
| Together AI | AIResources (Custom) | API Key + Base URL | Free tier available |
| NotebookLM | AIResources | Service Account JSON | Free tier available |
| PayPal | PaymentProviders | Client ID + Secret | Free (transaction fees) |
| Stripe | PaymentProviders | Publishable + Secret Key | Free (transaction fees) |
| Square | PaymentProviders | App ID + Access Token | Free (transaction fees) |
| Printful | PrintfulManager | API Token | Free (per-order cost) |
| Amazon PA-API | AffiliateProducts | Access Key + Secret + Tag | Free (affiliate program) |
| Mailgun | MailgunManager | API Key + Domain | Free tier (limited) |
| FacebookEvents | App ID + Secret + Token | Free | |
| YouTube Data API | YouTubePlaylist | API Key | Free (daily quota) |
| Go High Level | GHLConnector | API Key + Location ID | Paid subscription |
Where Keys Are Stored
Security note: All API keys are stored as plain text in JSON files under admin/data/. This directory is excluded from deployment rsync and is never exposed to the frontend. However, anyone with admin panel access or server file access can read them. Never commit admin/data/ to a public git repository.
- AI providers:
admin/data/AIResources/config.json - Payment gateways:
admin/data/PaymentProviders/config.json - Printful:
admin/data/printful/config.json - Affiliate Products:
admin/data/AffiliateProducts/config.json - Mailgun:
admin/data/MailgunManager/config.json - Facebook:
admin/data/FacebookEvents/config.json - YouTube:
admin/data/youtube_playlists/config.json - GHL:
admin/data/GHLConnector/config.json