Mail

const domains = await sentroy.domains.list()
// → Domain[]

const domain = await sentroy.domains.get("domain-id")

const mailboxes = await sentroy.mailboxes.list()

const templates = await sentroy.templates.list()

const template = await sentroy.templates.get("template-id")

const template = await sentroy.templates.create({
  name: { en: "Welcome", tr: "Hos geldin" },
  subject: { en: "Welcome, {firstName}!", tr: "Hos geldin, {firstName}!" },
  mjmlBody: { en: "<mjml>...</mjml>", tr: "<mjml>...</mjml>" },
  domainId: "a1b2c3d4-...",
})

// template.variables -> ["firstName"]  (extracted from the body)

const template = await sentroy.templates.update("template-id", {
  subject: { en: "Welcome aboard, {firstName}!" },
})

await sentroy.templates.delete("template-id")

const messages = await sentroy.inbox.list({
  mailbox: "info@example.com",
  folder: "INBOX",
  page: 1,
  limit: 20,
})

const message = await sentroy.inbox.get(1234, {
  mailbox: "info@example.com",
})

const folders = await sentroy.inbox.listFolders("info@example.com")

const thread = await sentroy.inbox.getThread(
  "Re: Project update",
  "info@example.com",
)

await sentroy.inbox.markAsRead(1234, { mailbox: "info@example.com" })
await sentroy.inbox.markAsUnread(1234, { mailbox: "info@example.com" })

await sentroy.inbox.move(1234, "Trash", {
  from: "INBOX",
  mailbox: "info@example.com",
})

await sentroy.inbox.delete(1234, { mailbox: "info@example.com" })

const result = await sentroy.send.email({
  to: "user@example.com",
  from: "info@example.com",
  subject: "Welcome!",
  domainId: "domain-id",
  templateId: "template-id",
  variables: {
    name: "John",
    company: "Acme",
  },
})

await sentroy.send.email({
  to: "user@example.com",
  from: "info@example.com",
  subject: "Hosgeldin!",
  domainId: "domain-id",
  templateId: "template-id",
  lang: "tr",
  variables: { name: "Ahmet" },
})

await sentroy.send.email({
  to: ["user1@example.com", "user2@example.com"],
  from: "info@example.com",
  subject: "Hello",
  domainId: "domain-id",
  html: "<h1>Hello World</h1>",
})

await sentroy.send.email({
  to: "user@example.com",
  from: "info@example.com",
  subject: "Invoice",
  domainId: "domain-id",
  html: "<p>Please find your invoice attached.</p>",
  attachments: [
    {
      filename: "invoice.pdf",
      content: base64String,
      contentType: "application/pdf",
    },
  ],
})

const { contacts, total, page, limit } = await sentroy.audience.contacts.list({
  page: 1,
  limit: 50,
  status: "active",
  tags: ["customer", "vip"],
})

const matches = await sentroy.audience.contacts.search("alex@")

const contact = await sentroy.audience.contacts.create({
  email: "user@example.com",
  name: "Jane Doe",
  tags: ["beta-tester"],
  metadata: { signupSource: "landing-2026-q2" },
})

await sentroy.audience.contacts.update(contact.id, { tags: ["customer"] })

await sentroy.audience.contacts.delete(contact.id)

const lists = await sentroy.audience.lists.list()

const list = await sentroy.audience.lists.create({
  name: "Newsletter — May 2026",
  description: "Opt-ins from the homepage form",
})

await sentroy.audience.lists.delete(list.id)

const members = sentroy.audience.lists.members(list.id)
await members.add(contact.id)

const inList = await members.list()

await members.remove(contact.id)

const suppressions = await sentroy.suppressions.list({
  domainId: "domain-id",
  reason: "complaint",
  page: 1,
  limit: 50,
})

const added = await sentroy.suppressions.add({
  email: "leaving@example.com",
  domainId: "domain-id",
  reason: "manual",
})

await sentroy.suppressions.remove(added.id)

const webhook = await sentroy.webhooks.create({
  url: "https://example.com/webhooks/sentroy",
  events: ["sent", "bounced", "opened", "clicked", "unsubscribed"],
  domainId: "domain-id",
})

console.log(webhook.secret) // Returned ONCE — store it now

const all = await sentroy.webhooks.list()
const scoped = await sentroy.webhooks.list("domain-id")

const result = await sentroy.webhooks.test(webhook.id, {
  event: "sent",
  payload: {
    mailLogId: "ml_abc",
    to: "user@example.com",
    subject: "Welcome",
  },
})

console.log(result.responseStatus, result.durationMs)

const { items, total } = await sentroy.webhooks
  .deliveries(webhook.id)
  .list({ page: 1, limit: 50, status: "failed" })

const delivery = await sentroy.webhooks
  .deliveries(webhook.id)
  .get(deliveryId)

const result = await sentroy.webhooks
  .deliveries(webhook.id)
  .replay(deliveryId)

await sentroy.webhooks.update(webhook.id, { active: false })

await sentroy.webhooks.delete(webhook.id)

const logs = await sentroy.logs.list({
  status: "bounced",
  domainId: "domain-id",
  from: "2026-05-01T00:00:00Z",
  to: "2026-05-31T23:59:59Z",
  page: 1,
  limit: 100,
})

const log = await sentroy.logs.get(logs[0].id)
console.log(log.openedAt, log.clickedAt) // tracking timestamps if enabled