API & Developer Mode

Connect your Lemonades to external applications via API

Overview

Want to connect your Lemonade to your own app or automate it with tools like Zapier? Developer Mode gives you API access to do exactly that. Here’s how to get started.

Who This Is For

This page is for developers who want to integrate Lemonades into applications, workflows, or automation systems. If you’re comfortable with API calls and code, you’re in the right place.

Not a developer? That’s OK! You can still use Zapier integration without writing code. Skip to the Zapier Integration section.

Enabling Developer Mode

1. Open Lemonade Editor

   Navigate to Lemonades and click on your Lemonade

2. Go to Add On Tab

   Click the Add On tab in the editor

3. Enable Developer Mode

   Toggle Developer Mode to On

Getting Your API Key

1. Go to Profile & Billing

   Click your avatar and select Profile & Billing

2. Navigate to API Keys

   Click the API Keys tab

3. Generate Key

   Click “Generate New Key” and copy your API key

Important: Your API key is like a password - keep it secret! Don’t share it publicly or save it in code repositories. If it’s ever exposed, generate a new one immediately.

API Endpoints

Send Message

Send a message to your Lemonade and receive a response.

POST https://api.launchlemonade.app/v1/chat

Headers:

{
  "Authorization": "Bearer YOUR_API_KEY",
  "Content-Type": "application/json"
}

Request Body:

{
  "lemonade_id": "your-lemonade-id",
  "message": "Hello, how can you help me?",
  "conversation_id": "optional-conversation-id"
}

Response:

{
  "response": "Hello! I'm here to help you with...",
  "conversation_id": "conv_123abc",
  "tokens_used": 150
}

Get Lemonade Info

Retrieve information about a specific Lemonade.

GET https://api.launchlemonade.app/v1/lemonades/{lemonade_id}

List Lemonades

Get a list of all your Lemonades.

GET https://api.launchlemonade.app/v1/lemonades

Zapier Integration

Connect your Lemonades to 5,000+ apps through Zapier.

1. Enable Developer Mode

   Turn on Developer Mode in your Lemonade’s Add On tab

2. Find LaunchLemonade on Zapier

   Search for “LaunchLemonade” in Zapier’s app directory

3. Connect Your Account

   Use your API key to authenticate

4. Create Zaps

   Build automated workflows with your Lemonades

Popular Zapier Use Cases

Trigger	Action	Use Case
New email received	Send to Lemonade	Auto-draft responses
New form submission	Send to Lemonade	Process and categorize leads
Scheduled time	Query Lemonade	Generate daily reports
Slack message	Send to Lemonade	Answer team questions

Error Handling

Common Error Codes

Code	Meaning	Solution
401	Unauthorized	Check your API key
404	Not found	Verify the Lemonade ID
429	Rate limited	Wait and retry
500	Server error	Contact support

Error Response Format

{
  "error": {
    "code": "rate_limited",
    "message": "Too many requests. Please wait before retrying.",
    "retry_after": 60
  }
}

Code Examples

Python

import requests

API_KEY = "your-api-key"
LEMONADE_ID = "your-lemonade-id"

response = requests.post(
    "https://api.launchlemonade.app/v1/chat",
    headers={
        "Authorization": f"Bearer {API_KEY}",
        "Content-Type": "application/json"
    },
    json={
        "lemonade_id": LEMONADE_ID,
        "message": "What can you help me with?"
    }
)

print(response.json()["response"])

JavaScript

const response = await fetch('https://api.launchlemonade.app/v1/chat', {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${API_KEY}`,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    lemonade_id: 'your-lemonade-id',
    message: 'What can you help me with?'
  })
});

const data = await response.json();
console.log(data.response);

cURL

curl -X POST https://api.launchlemonade.app/v1/chat \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"lemonade_id": "your-lemonade-id", "message": "Hello!"}'

Best Practices

Performance Tips:

• Cache responses when appropriate
• Use conversation IDs to maintain context
• Implement exponential backoff for retries

1. Store your API key securely – Use environment variables
2. Handle errors gracefully – Implement proper error handling
3. Monitor usage – Track your API calls to stay within limits
4. Use conversation IDs – Maintain context across multiple messages

Notes

• If a conversation ID is not provided in the run_assistant request, a new conversation is created.
• Keep a delay of 10 seconds between each call to the get_run_assistant. If no response, retry after another 10 seconds for up to 1 minute.
• Responses are returned in Markdown format for easy readability and formatting.
• Make sure your API token is valid and included in the headers for authentication.

What’s Next

Lemonade Editor

Customise your Lemonade before integrating

Deploy Your Lemonade

Share your AI tool with the world