> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vibeflow.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# AgentMail

> Give your AI agents their own email inboxes to send, receive, and act upon emails

AgentMail is an API platform for giving AI agents their own inboxes to send, receive, and act upon emails. This allows agents to assume their own identity and communicate via email with services, people, and other agents.

**Required Configuration:**

* API Key

## Getting Your API Key

<Steps>
  <Step title="Log in to AgentMail Console">
    Go to [console.agentmail.to](https://console.agentmail.to/) and log in or create an account.
  </Step>

  <Step title="Navigate to API Keys">
    In the left sidebar, click **API Keys**.
  </Step>

  <Step title="Create a new API Key">
    Click **Create New API Key**, give it a name, and copy the key.

    <Warning>Store your API key securely. It will only be shown once. If lost, you'll need to create a new one.</Warning>
  </Step>

  <Step title="Add to VibeFlow">
    Paste the API key into your VibeFlow AgentMail connector under **Settings** > **Connectors**.
  </Step>
</Steps>

## Available Endpoints

<AccordionGroup>
  <Accordion title="GET /api/actions/agentmails/inboxes">
    **List Inboxes:** Retrieve all inboxes associated with your AgentMail account.
  </Accordion>

  <Accordion title="POST /api/actions/agentmails/inboxes">
    **Create Inbox:** Create a new inbox for an AI agent, giving it a dedicated email identity.
  </Accordion>

  <Accordion title="GET /api/actions/agentmails/inboxes/{inbox_id}">
    **Get Inbox:** Retrieve details of a specific inbox by its ID.
  </Accordion>

  <Accordion title="GET /api/actions/agentmails/inboxes/{inbox_id}/messages">
    **List Messages:** List all messages in a specific inbox.
  </Accordion>

  <Accordion title="GET /api/actions/agentmails/inboxes/{inbox_id}/messages/{message_id}">
    **Get Message:** Retrieve a specific message by its ID.
  </Accordion>

  <Accordion title="GET /api/actions/agentmails/inboxes/{inbox_id}/messages/{message_id}/attachments/{attachment_id}">
    **Get Attachment:** Retrieve a specific attachment from a message.
  </Accordion>

  <Accordion title="POST /api/actions/agentmails/inboxes/{inbox_id}/messages/send">
    **Send Message:** Send a new email from a specific inbox.
  </Accordion>

  <Accordion title="POST /api/actions/agentmails/inboxes/{inbox_id}/messages/{message_id}/reply">
    **Reply To Message:** Reply to an existing message in a thread.
  </Accordion>

  <Accordion title="GET /api/actions/agentmails/inboxes/{inbox_id}/threads">
    **List Threads:** List all email threads in a specific inbox.
  </Accordion>

  <Accordion title="GET /api/actions/agentmails/inboxes/{inbox_id}/threads/{thread_id}">
    **Get Thread:** Retrieve a full email thread by its ID.
  </Accordion>
</AccordionGroup>