Skip to main content Install and configure Lindy AI SDK/CLI authentication.
Use when setting up a new Lindy integration, configuring API keys,
or initializing Lindy in your project.
Trigger with phrases like "install lindy", "setup lindy",
"lindy auth", "configure lindy API key".
npx skills add jeremylongshore/claude-code-plugins-plus-skills --skill lindy-install-auth ai automation claude-code devops mcp ai-agents
Lindy Install & Auth
Overview
Lindy AI is a no-code/low-code AI agent platform. Agents ("Lindies") are built in the
web dashboard at . External integration uses webhook endpoints,
the HTTP Request action, and optional Node.js/Python SDKs for programmatic access.
Prerequisites
Lindy account at (Free tier: 400 credits/month)
For SDK access: Node.js 18+ or Python 3.10+
For webhook receivers: HTTPS endpoint in your application
Instructions
Step 1: Obtain API Key
Log in at
Navigate to Settings > API Keys
Click Generate New Key — copy immediately (shown only once)
Store securely:
# Environment variable
export LINDY_API_KEY="lnd_live_xxxxxxxxxxxxxxxxxxxx"
# Or .env file (add .env to .gitignore)
echo 'LINDY_API_KEY=lnd_live_xxxxxxxxxxxxxxxxxxxx' >> .env
Step 2: Install SDK (Optional)
# Node.js SDK
npm install lindy-ai
# Python SDK
pip install lindy-ai
Step 3: Initialize Client
// Node.js
import { Lindy } from 'lindy-ai';
const lindy = new Lindy({
apiKey: process.env.LINDY_API_KEY,
});
// Verify connection
const agents = await lindy.agents.list();
console.log(`Connected: ${agents.length} agents found`);
# Python
import os
from lindy import Lindy
client = Lindy(api_key=os.environ["LINDY_API_KEY"])
# Verify connection
agents = client.agents.list()
print(f"Connected: {len(agents)} agents found")
Step 4: Configure Webhook Authentication When creating a webhook trigger in the Lindy dashboard, generate a secret key.
Callers must include this in every request:
Authorization: Bearer <your-webhook-secret>
Your webhook endpoint URL follows the pattern:
https://public.lindy.ai/api/v1/webhooks/<unique-id>
Step 5: Verify Webhook Connectivity # Test your webhook trigger
curl -X POST "https://public.lindy.ai/api/v1/webhooks/YOUR_WEBHOOK_ID" \
-H "Authorization: Bearer YOUR_SECRET" \
-H "Content-Type: application/json" \
-d '{"test": true, "message": "hello from setup"}'
Lindy Plans & Credits Plan Price Credits/mo Tasks Extras Free $0 400 ~40 Basic models Pro $49.99/mo 5,000 ~1,500 +$19.99/seat, phone calls Business $299.99/mo 30,000 ~3,000 100 phone calls, 50M KB chars Enterprise Custom Custom Custom SSO, SCIM, RBAC, audit logs
Credit consumption: 1-3 credits on basic models, ~10 on large models per task.
Error Handling Error Cause Solution 401 UnauthorizedInvalid or expired API key Regenerate key in Settings > API Keys 403 ForbiddenKey lacks required scope Check plan tier supports API access 429 Too Many RequestsCredit limit exceeded Upgrade plan or wait for monthly reset Webhook 401Missing/wrong Bearer token Verify secret matches dashboard value ECONNREFUSEDLindy API unreachable Check https://status.lindy.ai
Security Checklist
Resources
Next Steps After successful auth, proceed to lindy-hello-world for your first AI agent.
Create or update AgentSkills. Use when designing, structuring, or packaging skills with scripts, references, and assets.
Create or update AgentSkills. Use when designing, structuring, or packaging skills with scripts, references, and assets.
Set up and use 1Password CLI (op). Use when installing the CLI, enabling desktop app integration, signing in (single or multi-account), or reading/injecting/running secrets via op.
CLI to manage emails via IMAP/SMTP. Use `himalaya` to list, read, write, reply, forward, search, and organize emails from the terminal. Supports multiple accounts and message composition with MML (MIME Meta Language).
Create or update AgentSkills. Use when designing, structuring, or packaging skills with scripts, references, and assets.
Create or update AgentSkills. Use when designing, structuring, or packaging skills with scripts, references, and assets.
Set up and use 1Password CLI (op). Use when installing the CLI, enabling desktop app integration, signing in (single or multi-account), or reading/injecting/running secrets via op.
CLI to manage emails via IMAP/SMTP. Use `himalaya` to list, read, write, reply, forward, search, and organize emails from the terminal. Supports multiple accounts and message composition with MML (MIME Meta Language).