API & Developer Mode

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

Open Lemonade Editor

Navigate to Lemonades and click on your Lemonade

Go to Add On Tab

Click the Add On tab in the editor

Enable Developer Mode

Toggle Developer Mode to On

Getting Your API Key

Go to Profile & Billing

Click your avatar and select Profile & Billing

Navigate to API Keys

Click the API Keys tab

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.

Enable Developer Mode

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

Find LaunchLemonade on Zapier

Search for “LaunchLemonade” in Zapier’s app directory

Connect Your Account

Use your API key to authenticate

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

Store your API key securely – Use environment variables
Handle errors gracefully – Implement proper error handling
Monitor usage – Track your API calls to stay within limits
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.

Overview

Who This Is For

Enabling Developer Mode

Getting Your API Key

API Endpoints

Send Message

Get Lemonade Info

List Lemonades

Zapier Integration

Popular Zapier Use Cases

Error Handling

Common Error Codes

Error Response Format

Code Examples

Python

JavaScript

cURL

Best Practices

Notes

What’s Next

Lemonade Editor

Deploy Your Lemonade

​Overview

​Who This Is For

​Enabling Developer Mode

​Getting Your API Key

​API Endpoints

​Send Message

​Get Lemonade Info

​List Lemonades

​Zapier Integration

​Popular Zapier Use Cases

​Error Handling

​Common Error Codes

​Error Response Format

​Code Examples

​Python

​JavaScript

​cURL

​Best Practices

​Notes

​What’s Next

Lemonade Editor

Deploy Your Lemonade

Overview

Who This Is For

Enabling Developer Mode

Getting Your API Key

API Endpoints

Send Message

Get Lemonade Info

List Lemonades

Zapier Integration

Popular Zapier Use Cases

Error Handling

Common Error Codes

Error Response Format

Code Examples

Python

JavaScript

cURL

Best Practices

Notes

What’s Next