Luella API Documentation
Welcome to the Luella API reference. This documentation is your complete guide to integrating with the Luella platform.
Use this API to programmatically manage your outreach infrastructure — from mailbox warmup to campaign execution — and get visibility into how your messages are performing across inboxes and audiences.
Getting started
To get started, request your userId and workspaceId by emailing adb@luella.ai with your Luella workspace name and registered email address.
Once you have those, explore the API using tools like Postman or any HTTP client — all endpoints are POST requests and accept JSON request bodies.
Resources
Clusters
Group mailboxes under a shared IP identity for warmup and outreach.
Profiles
Define your audience, offer, and outreach context for better warmup.
Email Addresses
Connect inboxes to send warmup and outreach emails through Luella.
Campaigns
Run targeted outreach using sequences, schedules, and contacts.
Contacts
Store leads and prospects to be messaged through campaigns.
Sequences
Define multistep outreach logic with wait times and message templates.
Schedules
Control the days and hours during which campaigns send messages.
Variables
Insert dynamic fields like names, offers, and companies into copy.
Snippets
AI-generated inserts rendered from prompts and injected into emails.
Threads
Grouped conversations between contacts and your outreach inbox.
Emails
The individual messages sent and received across threads.
Deliverability Metrics
Inbox, spam, and reply stats from warmup and placement testing.
Outreach Metrics
Campaign performance including opens, clicks, replies, and bounces.