How do I create my first inbox?

$
npm install agentmail

1
import { AgentMailClient } from "agentmail";
2
3
const client = new AgentMailClient({ apiKey: "am_..." });
4
5
// Create an inbox with a random address on agentmail.to
6
const inbox = await client.inboxes.create();
7
console.log(`Inbox created: ${inbox.inboxId}`);

1
const inbox = await client.inboxes.create({
2
  username: "support",
3
  domain: "yourcompany.com",
4
  displayName: "Support Agent",
5
});
6
7
// inbox.inboxId will be support@yourcompany.com
8
console.log(`Inbox created: ${inbox.inboxId}`);

1
const inbox = await client.inboxes.create({
2
  username: "my-agent",
3
  clientId: "my-agent-inbox-v1",
4
  displayName: "My Agent",
5
});
6
7
// Safe to call multiple times: same inbox returned every time

1
await client.inboxes.messages.send(inbox.inboxId, {
2
  to: "recipient@example.com",
3
  subject: "Hello from my agent!",
4
  text: "This is a plain text version.",
5
  html: "<p>This is an <strong>HTML</strong> version.</p>",
6
});

1
const inboxes = await client.inboxes.list();
2
console.log(`You have ${inboxes.count} inboxes.`);
3
4
for (const inbox of inboxes.inboxes) {
5
  console.log(`  ${inbox.inboxId}`);
6
}