Email Inbox

const result = await client.fetchEmailAddress({ bot_id: 'bot_abc123' });
console.log(result.response.email_address);
// e.g. "bot-abc123@inbox.boostgpt.co"

GET /v1/bot/email/address?project_id={project_id}&bot_id={bot_id}

{
  "email_address": "bot-abc123@inbox.boostgpt.co",
  "custom_domain": null,
  "enabled": true
}

const result = await client.updateEmailSettings({
  bot_id: 'bot_abc123',
  auto_reply: true,
  signature: 'Best, The Support Team',
  filter_spam: true
});

PUT /v1/bot/email/settings

const result = await client.fetchEmailStats({ bot_id: 'bot_abc123' });
console.log(result.response.stats);

GET /v1/bot/email/stats?project_id={project_id}&bot_id={bot_id}

{
  "stats": {
    "total_received": 240,
    "total_replied": 185,
    "total_unread": 12,
    "last_received_at": "2026-05-01T08:45:00Z"
  }
}

const result = await client.fetchEmails({
  bot_id: 'bot_abc123',
  page: 1,
  per_page: 20
});
console.log(result.response.emails);

GET /v1/bot/email/readall?project_id={project_id}&bot_id={bot_id}&page={page}&per_page={per_page}

{
  "total": 240,
  "emails": [
    {
      "uuid": "email_abc123",
      "from": "customer@example.com",
      "subject": "Question about billing",
      "preview": "Hi, I wanted to ask about...",
      "read": false,
      "replied": false,
      "received_at": "2026-05-01T08:45:00Z"
    }
  ],
  "pagination": {
    "page": 1,
    "per_page": 20,
    "total": 240,
    "total_pages": 12
  }
}

const result = await client.fetchEmail({
  bot_id: 'bot_abc123',
  email_id: 'email_abc123'
});
console.log(result.response.email.body);

GET /v1/bot/email/read?project_id={project_id}&bot_id={bot_id}&email_id={email_id}

const result = await client.replyToEmail({
  bot_id: 'bot_abc123',
  email_id: 'email_abc123',
  content: 'Thanks for reaching out! Your issue has been resolved.'
});

POST /v1/bot/email/reply

await client.deleteEmail({ bot_id: 'bot_abc123', email_id: 'email_abc123' });

DELETE /v1/bot/email/delete?project_id={project_id}&bot_id={bot_id}&email_id={email_id}