Create a new email inbox. Returns an @lobstermail.ai address. Provide your name/org for a meaningful address (e.g. sarah-shield@lobstermail.ai), or omit for a random lobster-xxxx address.

List recent emails in an inbox. Returns sender, subject, and preview for each email.

Wait for an incoming email matching optional filters. Returns near-instantly when an email arrives (real-time server-side long-polling). Returns the email body in LLM-safe format.

Get a single email by ID with full body in LLM-safe format.

Send an email from an inbox. Requires a verified account (Tier 1+). To reply within a thread, provide in_reply_to with the Message-ID of the email being replied to.

Search emails across all inboxes by keyword. Matches against subject, sender address, and body preview. Optionally scope to a single inbox or filter by sender, direction, date, or attachments.

List conversation threads for an inbox. Threads group related emails by In-Reply-To/References headers or subject matching. Returns newest threads first.

Get a conversation thread with all its emails in chronological order. Shows the full conversation flow including sender, subject, and preview for each email.

List all active inboxes for this account.

Soft-delete an inbox. It enters a 7-day grace period before permanent deletion.

Get account information including tier, limits, and usage stats.