🚀 n8n-nodes-latitude 🚀

Stop hardcoding AI prompts. Start shipping smarter workflows.

The ultimate n8n integration for Latitude.so — the AI prompt management platform. Execute prompts, continue conversations, and log everything with zero JSON wrestling.

  •  

🧭 Quick Navigation

⚡ Get Started • ✨ Key Features • 🎮 Operations • ⚙️ Configuration • 🆚 Why This Slaps

---

n8n-nodes-latitude is the prompt manager your n8n workflows wish they had. Stop embedding AI prompts directly in your automation and praying they still work next week. This node connects directly to Latitude.so, letting you manage prompts centrally, hot-reload changes, and execute with auto-detected parameters — all without touching your workflow.

🎯 Dynamic Parameters Auto-detects {{ variables }}

💬 Conversation Memory Continue multi-turn chats

🤖 AI Agent Ready Use as tool in AI workflows

📊 Full Observability Logs, costs, token tracking

How it slaps:

• You: Drag Latitude node into n8n workflow
• Node: Fetches prompts, shows parameters, handles auth
• You: Map your data → Execute
• Latitude: Returns response with usage stats, costs, and conversation UUID
• Result: Ship production AI features. Zero prompt maintenance headaches.

---

💥 Why This Slaps Hardcoded Prompts

Embedding prompts in workflows is a vibe-killer. n8n-nodes-latitude makes hardcoding look ancient.

❌ The Old Way (Pain)	✅ The Latitude Way (Glory)
Hardcode prompt in n8n HTTP node. Manually build JSON payload. Change prompt → Redeploy workflow. No version history. No rollback. Debug blind with no observability.	Select prompt from dropdown. Parameters auto-populate. Change prompt in Latitude → Live instantly. Version control + cost tracking. Full conversation logs in dashboard. ☕

We're not just calling an API. We're giving you centralized prompt management with dynamic parameter extraction, conversation continuity, and automatic SDK integration that handles all the complexity.

---

🚀 Get Started in 60 Seconds

Community Nodes (Recommended)

The fastest way to get started. No terminal required.

1. Go to Settings → Community Nodes
2. Click Install
3. Enter n8n-nodes-latitude
4. Confirm installation

That's it. The node appears in your node palette.

Manual Installation

For self-hosted n8n or custom setups:

# Navigate to your n8n installation
cd ~/.n8n/nodes

# Install the package
npm install n8n-nodes-latitude

# Restart n8n

✨ Zero Config: After installation, add your Latitude credentials and start building. The node handles SDK initialization, auth, and API versioning automatically.

---

✨ Feature Breakdown: The Secret Sauce

Feature	What It Does	Why You Care
🎯 Auto Parameter Detection No JSON wrestling	Extracts {{ variables }} from prompt content automatically	Select prompt → Parameters appear. Done.
💬 Conversation Continuity Multi-turn chats	Continue conversations using UUID from previous runs	Build chatbots and agents with memory
🤖 AI Agent Support usableAsTool: true	Works as a tool in n8n AI workflows	Plug into AI Agent node directly
📊 Token & Cost Tracking Full observability	Returns usage, cost, and toolCalls from each run	Know exactly what you're spending
🏠 Self-Hosted Support Custom gateway URL	Point to your own Latitude instance	Enterprise-ready, air-gapped deployments
📝 External Logging Create log entries	Log conversations from external AI calls to Latitude	Unified analytics across all AI touchpoints
⚡ Hot Reload No redeploy needed	Change prompts in Latitude, live instantly in n8n	Iterate on prompts without workflow changes
🔒 Secure by Default Credentials encrypted	API keys never exposed, errors sanitized	Production-ready security

---

🎮 Operations Reference

▶️ Run Prompt Execute AI prompts

💬 Chat Continue conversations

📝 Create Log Log external AI calls

Run Prompt ▶️

Execute an AI prompt from your Latitude project with automatic parameter detection.

Parameter	Type	Required	Description
Prompt Path	Dropdown	Yes	Select from your Latitude prompts — shows required parameters
Parameters	Key-Value	No	Map values to {{ variables }}. Supports n8n expressions
Simplify Output	Boolean	No	Return clean data or full conversation history
Custom Identifier	String	No	Tag runs for filtering in Latitude dashboard
Version UUID	String	No	Use specific version instead of live

Example Configuration:

Prompt Path: "marketing/personalized-email"
Parameters:
  - customer_name: {{ $json.name }}
  - product: {{ $json.product }}
  - tone: "professional"

Simplified Output:

{
  "uuid": "conv_abc123-def456",
  "text": "Dear John, thank you for your interest in...",
  "usage": {
    "promptTokens": 150,
    "completionTokens": 200,
    "totalTokens": 350
  },
  "cost": 0.0035
}

---

Chat 💬

Continue a conversation using the UUID from a previous prompt run.

Parameter	Type	Required	Description
Conversation UUID	String	Yes	UUID from a previous Run Prompt response
Messages	Collection	Yes	New messages to add to the conversation
Simplify Output	Boolean	No	Return clean data or full conversation history

Example — Building a Chatbot:

// First node: Run Prompt (initial)
// Returns: { uuid: "conv_abc123", text: "How can I help?" }

// Second node: Chat (continue)
Conversation UUID: {{ $('Latitude').item.json.uuid }}
Messages:
  - Role: user
    Content: "What's the weather like?"

---

Create Log 📝

Log conversations from external AI calls (OpenAI, Anthropic, etc.) to your Latitude project for unified analytics.

Parameter	Type	Required	Description
Prompt Path	Dropdown	Yes	The prompt to associate this log with
Messages	Collection	Yes	The conversation messages to log
Response	String	No	The AI-generated response text

Use Case: You're calling OpenAI directly but want all your AI usage visible in Latitude's dashboard:

Prompt Path: "support/ticket-classifier"
Messages:
  - Role: user
    Content: {{ $json.ticket_body }}
Response: {{ $json.openai_response }}

---

⚙️ Credentials Setup

You need a Latitude.so account with API access.

Field	Description	Where to Find
API Key	Your Latitude API key	Dashboard → Settings → API Keys (format: lat_...)
Project ID	Numeric project identifier	Dashboard → Project Settings or URL
Gateway URL	Optional — Custom gateway for self-hosted	Your instance URL (e.g., https://latitude.yourcompany.com)

Setting Up Credentials

1. Go to Credentials in n8n
2. Click New Credential
3. Search for Latitude API
4. Fill in your API Key and Project ID
5. (Optional) Add Gateway URL for self-hosted instances
6. Click Save — Credentials are automatically validated

🔒 Security Note: Your API key is encrypted at rest and never exposed in logs or error messages.

---

🔥 Workflow Examples

Basic: Webhook → AI Response

Webhook → Latitude (Run Prompt) → Respond to Webhook

Perfect for: Slack bots, API endpoints, form processing.

Advanced: Multi-Turn Chatbot

Webhook → Latitude (Run) → Set UUID → Loop → Latitude (Chat) → Respond

Perfect for: Customer support bots, interactive assistants.

Hybrid: External AI + Latitude Logging

Webhook → OpenAI → Latitude (Create Log) → Respond

Perfect for: Using other providers but want Latitude's analytics.

AI Agent Integration

AI Agent → Latitude Tool → Agent Output

Perfect for: ReAct agents, function calling, tool use.

---

🔧 Compatibility

Requirement	Version
n8n	1.0.0+
Node.js	18.0.0+
Latitude SDK	5.2.2+

---

🔥 Common Issues & Quick Fixes

Expand for troubleshooting tips

Problem	Solution
Authentication failed	Verify API key format (lat_...) and Project ID in Latitude dashboard. Keys are project-specific.
Prompt not found	Refresh the dropdown. Verify the prompt exists and is published (not draft).
Parameters not loading	Check credentials are valid. Run credential test. Ensure prompt has {{ variables }}.
Empty response	Prompt might be in draft mode. Check Latitude dashboard for prompt status.
Chat fails	Verify conversationUuid is from a recent run. UUIDs may expire based on project settings.
Self-hosted connection issues	Ensure Gateway URL includes protocol (https://). Check firewall rules.
Rate limiting	Latitude has usage limits. Check your plan in the dashboard.

---

🛠️ Development

Want to contribute or customize?

# Clone the repo
git clone https://github.com/yigitkonur/n8n-nodes-latitude.git
cd n8n-nodes-latitude

# Install dependencies
npm install

# Development mode (watch for changes)
npm run dev

# Build for production
npm run build

# Lint and format
npm run lint:fix
npm run format

Project Structure

├── credentials/          # Latitude API credential definition
├── nodes/Latitude/
│   ├── actions/          # Operation implementations
│   │   ├── runPrompt.operation.ts
│   │   ├── chat.operation.ts
│   │   └── createLog.operation.ts
│   ├── methods/          # Dynamic dropdown loaders
│   ├── shared/           # Types, utils, transport
│   └── Latitude.node.ts  # Main node definition
└── icons/                # Light/dark mode icons

---

📚 Resources

• Latitude Documentation — Full platform docs
• Latitude API Reference — API details
• n8n Community Nodes — How community nodes work
• Changelog — Version history and updates

---

🤝 Contributing

Contributions are welcome! This is how we make it better together.

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

---

Built with 🔥 because hardcoding AI prompts in workflows is a soul-crushing waste of time.

MIT © Yiğit Konur

GitHub • npm • Latitude.so • n8n.io