🧭 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.

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.

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 DetectionNo JSON wrestling | Extracts {{ variables }} from prompt content automatically | Select prompt → Parameters appear. Done. | | 💬 Conversation ContinuityMulti-turn chats | Continue conversations using UUID from previous runs | Build chatbots and agents with memory | | 🤖 AI Agent SupportusableAsTool: true | Works as a tool in n8n AI workflows | Plug into AI Agent node directly | | 📊 Token & Cost TrackingFull observability | Returns usage, cost, and toolCalls from each run | Know exactly what you're spending | | 🏠 Self-Hosted SupportCustom gateway URL | Point to your own Latitude instance | Enterprise-ready, air-gapped deployments | | 📝 External LoggingCreate log entries | Log conversations from external AI calls to Latitude | Unified analytics across all AI touchpoints | | ⚡ Hot ReloadNo redeploy needed | Change prompts in Latitude, live instantly in n8n | Iterate on prompts without workflow changes | | 🔒 Secure by DefaultCredentials encrypted | API keys never exposed, errors sanitized | Production-ready security |

🎮 Operations Reference

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

| 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