Overview
An inbox in Jasni is the email identity for your AI agent. It’s a dedicated address from which your agent can send, receive, and act on emails autonomously—communicating with services, people, and other agents.Each inbox is linked to your Jasni account. You can create multiple inboxes for different agents or purposes, all managed through a single API key.
Creating an Agent Inbox
You can set up an inbox for your agent in two ways:Create New Identity
Create a fresh email address with your custom domain—a clean identity for your agent
Connect Existing Account
Link an existing email account (Gmail, Outlook, or any IMAP provider) to give your agent access
Inbox Properties
| Property | Type | Description |
|---|---|---|
email | string | The agent’s email address |
name | string | Display name (e.g., “Support Agent”, “Booking Assistant”) |
provider | string | Email provider (gmail, outlook, imap, jasni) |
status | string | Connection status (active, error, disconnected) |
created_at | datetime | When the inbox was created |
Folders
Each inbox contains standard email folders:| Folder | Description |
|---|---|
INBOX | Incoming emails your agent can process |
Sent | Emails your agent has sent |
Drafts | Draft emails |
Trash | Deleted emails |
Spam / Junk | Spam folder |
Multiple Agents, Multiple Inboxes
You can create dedicated inboxes for different agents or purposes. Specify which inbox to use with theaccount parameter:
Use Cases
Dedicated Agent Identities
Dedicated Agent Identities
Give each AI agent its own email address so it can build relationships, maintain context, and communicate independently.
Specialized Agents
Specialized Agents
Create purpose-specific agents: support-agent@, booking-agent@, research-agent@—each handling their domain autonomously.
Multi-Agent Collaboration
Multi-Agent Collaboration
Enable multiple agents to communicate with each other via email, coordinating on complex tasks.
Service Integration
Service Integration
Let your agents interact with external services that use email as their interface—confirmations, notifications, approvals.