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
{
"Authorization": "Bearer YOUR_API_KEY",
"Content-Type": "application/json"
}
{
"lemonade_id": "your-lemonade-id",
"message": "Hello, how can you help me?",
"conversation_id": "optional-conversation-id"
}
{
"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": {
"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.
What’s Next
