Lindy Install & Auth

Overview

Lindy AI is a no-code/low-code AI agent platform. Agents ("Lindies") are built in the
web dashboard at https://app.lindy.ai. External integration uses webhook endpoints,
the HTTP Request action, and optional Node.js/Python SDKs for programmatic access.

Prerequisites

• Lindy account at https://app.lindy.ai (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

1. Log in at https://app.lindy.ai
2. Navigate to Settings > API Keys
3. Click Generate New Key — copy immediately (shown only once)
4. 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

Credit consumption: 1-3 credits on basic models, ~10 on large models per task.

Error Handling

Security Checklist

• [ ] API key stored in env var or secret manager — never in source code
• [ ] .env added to .gitignore
• [ ] Webhook secret generated and stored securely
• [ ] HTTPS enforced on all webhook receiver endpoints
• [ ] API key scoped to minimum required permissions

Resources

• Lindy Documentation
• Lindy Dashboard
• Lindy Academy
• Lindy Status

Next Steps

After successful auth, proceed to lindy-hello-world for your first AI agent.